Webhooks

Les webhooks permettent à votre application de recevoir des notifications en temps réel lorsque des événements se produisent dans votre espace BuzzBip. BuzzBip envoie une requête HTTP POST à votre endpoint configuré avec un payload JSON.

Configurer les webhooks

1. Accédez à Settings → Developer → Webhooks dans votre espace BuzzBip
2. Cliquez sur Add Webhook et saisissez l'URL de votre endpoint HTTPS
3. Sélectionnez les événements auxquels vous souhaitez vous abonner
4. Enregistrez et copiez le signing secret pour la vérification des payloads
5. Répondez avec 200 OK dans les 10 secondes pour accuser réception

Événements pris en charge

Exemple de 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"
  }
}

Vérifier les signatures

Chaque requête webhook inclut un en-tête X-BuzzBip-Signature. Calculez un hash HMAC-SHA256 du corps brut de la requête en utilisant votre signing secret et comparez-le à la valeur de l'en-tête pour vérifier l'authenticité.