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โ
- Faccia clic su Impostazioni nella barra laterale.
- Selezioni API e integrazioni dal menu delle impostazioni.
- Faccia clic sulla scheda Webhook.
- Faccia clic su + Crea webhook.
- 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.
- Faccia clic su Crea.

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.
- Copi subito il segreto e lo conservi in modo sicuro.
- Usi il segreto per convalidare l'intestazione
X-Webhook-Signaturenelle richieste in arrivo.
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โ
| Evento | Si attiva quando |
|---|---|
booking.created | Viene creata una nuova prenotazione |
booking.updated | Una prenotazione viene modificata |
booking.cancelled | Una prenotazione viene annullata |
booking.completed | Una prenotazione viene contrassegnata come completata |
Pagamentiโ
| Evento | Si attiva quando |
|---|---|
payment.received | Viene registrato un pagamento |
payment.refunded | Viene elaborato un rimborso |
Clientiโ
| Evento | Si attiva quando |
|---|---|
customer.created | Viene aggiunto un nuovo cliente |
customer.updated | Una scheda cliente viene modificata |
customer.deleted | Un cliente viene eliminato |
Prodottiโ
| Evento | Si attiva quando |
|---|---|
product.created | Viene aggiunto un nuovo prodotto |
product.updated | Un prodotto viene modificato |
product.archived | Un prodotto viene archiviato |
Esperienzeโ
| Evento | Si attiva quando |
|---|---|
experience.created | Viene aggiunta una nuova esperienza |
experience.updated | Un'esperienza viene modificata |
experience.archived | Un'esperienza viene archiviata |
Moduliโ
| Evento | Si attiva quando |
|---|---|
form_response.submitted | Un cliente invia una liberatoria o un modulo |
Voucherโ
| Evento | Si attiva quando |
|---|---|
voucher.sold | Viene acquistato un voucher o un buono regalo |
voucher.redeemed | Un 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:
- Calcoli un hash HMAC-SHA256 del corpo della richiesta usando il segreto del suo webhook.
- Confronti l'hash calcolato con il valore dell'intestazione
X-Webhook-Signature. - Se corrispondono, la richiesta รจ autentica.
Questo impedisce ad eventuali malintenzionati di inviare eventi webhook falsi al suo endpoint.