Webhook

I webhook permettono alla tua applicazione di ricevere notifiche in tempo reale quando si verificano eventi nel workspace BuzzBip. BuzzBip invia una richiesta HTTP POST al tuo endpoint configurato con un payload JSON.

Configurare i webhook

1. Vai a Settings → Developer → Webhooks nel workspace BuzzBip
2. Clicca Add Webhook e inserisci l'URL del tuo endpoint HTTPS
3. Seleziona gli eventi a cui iscriverti
4. Salva e copia il signing secret per la verifica del payload
5. Rispondi con 200 OK entro 10 secondi per confermare la ricezione

Eventi supportati

Esempio di payload

{
  "id": "evt_7f3a9b2c",
  "type": "message.received",
  "createdAt": "2026-06-01T14:32:00Z",
  "data": {
    "messageId": "msg_abc123",
    "conversationId": "conv_xyz789",
    "contactId": "cnt_def456",
    "channel": "whatsapp",
    "body": "Hello, I need help with my order",
    "from": "+21612345678"
  }
}

Verificare le firme

Ogni richiesta webhook include un header X-BuzzBip-Signature. Calcola un hash HMAC-SHA256 del corpo grezzo della richiesta usando il signing secret e confrontalo con il valore dell'header per verificare l'autenticità.