Webhooks ermöglichen Ihrer Anwendung, Echtzeit-Benachrichtigungen zu empfangen, wenn Ereignisse in Ihrem BuzzBip-Workspace auftreten. BuzzBip sendet eine HTTP-POST-Anfrage an Ihren konfigurierten Endpoint mit einem JSON-Payload.
Webhooks konfigurieren
- Gehen Sie zu Settings → Developer → Webhooks in Ihrem BuzzBip-Workspace
- Klicken Sie auf Add Webhook und geben Sie Ihre HTTPS-Endpoint-URL ein
- Wählen Sie die Ereignisse aus, die Sie abonnieren möchten
- Speichern und kopieren Sie das Signing Secret zur Payload-Verifizierung
- Antworten Sie innerhalb von 10 Sekunden mit
200 OK, um den Empfang zu bestätigen
Unterstützte Ereignisse
Payload-Beispiel
json
{
"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"
}
}Signaturen verifizieren
Jede Webhook-Anfrage enthält einen X-BuzzBip-Signature-Header. Berechnen Sie einen HMAC-SHA256-Hash des rohen Request-Bodies mit Ihrem Signing Secret und vergleichen Sie ihn mit dem Header-Wert, um die Authentizität zu prüfen.
BuzzBip wiederholt fehlgeschlagene Webhook-Zustellungen bis zu 5 Mal mit exponentiellem Backoff. Stellen Sie sicher, dass Ihr Endpoint idempotent ist.