Passa al contenuto principale

Configurazione dei webhook Growth+This feature requires the Growth+ plan or higher

I webhook consentono ad applicazioni esterne di ricevere notifiche in tempo reale quando succede qualcosa nel suo account EquipDash. Invece di interrogare ripetutamente l'API, la sua applicazione riceve una richiesta HTTP POST immediata ogni volta che si verifica un evento selezionato.


Creazione di un endpoint webhookโ€‹

  1. Faccia clic su Impostazioni nella barra laterale.
  2. Selezioni API e integrazioni dal menu delle impostazioni.
  3. Faccia clic sulla scheda Webhook.
  4. Faccia clic su + Crea webhook.
  5. Compili i seguenti campi:
    • Nome -- un'etichetta descrittiva (ad es. "Sincronizzazione contabilitร ", "Notifiche Slack").
    • URL -- l'indirizzo dell'endpoint a cui EquipDash deve inviare i payload del webhook (deve essere HTTPS).
    • Eventi -- selezioni quali eventi devono attivare questo webhook (consulti la tabella degli eventi piรน sotto).
    • Attivo -- attivi l'interruttore per iniziare a ricevere subito gli eventi.
  6. Faccia clic su Crea.

La scheda Webhook nella pagina delle impostazioni API e integrazioni


Segreto del webhookโ€‹

Dopo aver creato un webhook, EquipDash genera un segreto del webhook. Questo segreto serve per verificare che le richieste in arrivo provengano effettivamente da EquipDash.

  1. Copi subito il segreto e lo conservi in modo sicuro.
  2. Usi il segreto per convalidare l'intestazione X-Webhook-Signature nelle richieste in arrivo.
attenzione

Il segreto del webhook viene mostrato una sola volta, al momento della creazione del webhook. Se lo perde, puรฒ rigenerarlo dalla pagina dei dettagli del webhook, ma dovrร  aggiornare la sua applicazione con il nuovo segreto.


Eventi webhook disponibiliโ€‹

Prenotazioniโ€‹

EventoSi attiva quando
booking.createdViene creata una nuova prenotazione
booking.updatedUna prenotazione viene modificata
booking.cancelledUna prenotazione viene annullata
booking.completedUna prenotazione viene contrassegnata come completata

Pagamentiโ€‹

EventoSi attiva quando
payment.receivedViene registrato un pagamento
payment.refundedViene elaborato un rimborso

Clientiโ€‹

EventoSi attiva quando
customer.createdViene aggiunto un nuovo cliente
customer.updatedUna scheda cliente viene modificata
customer.deletedUn cliente viene eliminato

Prodottiโ€‹

EventoSi attiva quando
product.createdViene aggiunto un nuovo prodotto
product.updatedUn prodotto viene modificato
product.archivedUn prodotto viene archiviato

Esperienzeโ€‹

EventoSi attiva quando
experience.createdViene aggiunta una nuova esperienza
experience.updatedUn'esperienza viene modificata
experience.archivedUn'esperienza viene archiviata

Moduliโ€‹

EventoSi attiva quando
form_response.submittedUn cliente invia una liberatoria o un modulo

Voucherโ€‹

EventoSi attiva quando
voucher.soldViene acquistato un voucher o un buono regalo
voucher.redeemedUn voucher viene utilizzato per una prenotazione

Gestione dei webhookโ€‹

Dalla scheda Webhook, puรฒ:

  • Modificare un webhook per cambiarne il nome, l'URL o gli eventi selezionati.
  • Mettere in pausa un webhook disattivandolo. Mentre รจ in pausa, gli eventi non verranno inviati.
  • Rigenerare il segreto se il segreto del suo webhook รจ stato compromesso.
  • Eliminare un webhook per rimuoverlo definitivamente.

Verifica delle firme dei webhookโ€‹

Ogni richiesta webhook include un'intestazione X-Webhook-Signature. Per verificare che la richiesta sia autentica:

  1. Calcoli un hash HMAC-SHA256 del corpo della richiesta usando il segreto del suo webhook.
  2. Confronti l'hash calcolato con il valore dell'intestazione X-Webhook-Signature.
  3. Se corrispondono, la richiesta รจ autentica.

Questo impedisce ad eventuali malintenzionati di inviare eventi webhook falsi al suo endpoint.