SendApp Docs
Anmelden

Ausgehende Webhooks: so funktionieren sie

SendApp ruft deinen Server auf, wenn in deinem Konto etwas passiert: Eine Nachricht kommt an oder geht raus, WhatsApp aktualisiert den Status einer Nachricht, eine Kampagne startet oder endet, eine WhatsApp-Vorlage wird genehmigt oder abgelehnt, ein Termin wird gebucht. Einzurichten unter Einstellungen → Webhook: bis zu 10 Adressen, jede mit eigenem KI-Konto und eigenen Ereignissen.
Jeder Aufruf ist eine POST-Anfrage mit JSON-Inhalt und den Headern X-SendApp-Event, X-SendApp-Delivery (die eindeutige ID der Zustellung), X-SendApp-Attempt und X-SendApp-Signature.
Prüfe die Signatur: X-SendApp-Signature ist t=<timestamp>,v1=<HMAC-SHA256 von "timestamp.inhalt">, berechnet mit dem geheimen Schlüssel des Webhooks (Einstellungen → Webhook → Signaturschlüssel anzeigen). Lehne Anfragen ab, deren Timestamp älter als 5 Minuten ist.
Antworte innerhalb von 10 Sekunden mit einem 2xx-Code: Sonst versuchen wir es nach 1, 5 und 30 Minuten erneut. Ein 4xx-Code (außer 408 und 429) wird nicht wiederholt. Nach 20 fehlgeschlagenen Zustellungen in Folge wird der Webhook abgeschaltet: Schalte ihn unter Einstellungen → Webhook wieder ein.
Jede Zustellung hat eine eindeutige delivery_id, die bei allen Versuchen gleich bleibt: Nutze sie, um Duplikate zu ignorieren. Die Reihenfolge der Ankunft ist nicht garantiert: Zum Ordnen der Ereignisse nutze occurred_at (und timestamp für die Status).
Der Inhalt enthält immer event, occurred_at, account_ref, training_token (das KI-Konto) und delivery_id. account_ref kennzeichnet dein Konto und ist kein Schlüssel: Der Inhalt enthält nie deinen API-Schlüssel. Fotos, Audios, Videos und Dokumente kommen als Links, nie als Dateien.
Unter Einstellungen → Webhook kannst du für jedes Ereignis einen Test senden: Er kommt mit "test": true. Das Protokoll zeigt jede Zustellung mit dem gesendeten Inhalt und der Antwort deines Servers.

Parameter

8 · 0 Pflichtfelder
message.received optional
Ein Kunde schreibt dir, auf jedem Kanal.
message.sent optional
Eine Nachricht geht raus: KI, Operator, Kampagne, Automatisierung, API.
message.status optional
Eine WhatsApp-Nachricht wurde zugestellt, gelesen oder nicht zugestellt (mit dem Fehlercode von Meta).
campaign.started optional
Eine Kampagne beginnt zu senden.
campaign.completed optional
Eine Kampagne ist fertig, mit ihren Zahlen.
campaign.failed optional
Eine Kampagne wurde wegen eines Fehlers gestoppt.
template.status_changed optional
Eine WhatsApp-Vorlage wurde genehmigt, abgelehnt, pausiert oder deaktiviert, mit Begründung.
booking.* / voice.* optional
Die Termine der Agenda und die Anrufe der Voice AI: dieselben Adressen, dieselbe Signatur.
Brauchen Sie Hilfe bei der Integration? info@sendapp.live