Webhooks-Setup
Abonniere Webhooks und erhalte Benachrichtigungen über Nachrichten, die dein Unternehmen empfängt, sowie Änderungen an Kundenprofilen.
Endpunkt erstellen
Bevor du Benachrichtigungen empfangen kannst, musst du auf deinem Server einen Endpunkt für den Empfang von Benachrichtigungen erstellen.
Dein Endpunkt muss zwei Arten von HTTPS-Anfragen verarbeiten können: Verifizierungsanfragen und Event-Benachrichtigungen. Da beide Anfragen HTTPS verwenden, muss dein Server über ein korrekt konfiguriertes und installiertes TLS- oder SSL-Zertifikat verfügen. Selbstsignierte Zertifikate werden nicht unterstützt.
Erfahre mehr über Verifizierungsanfragen und Event-Benachrichtigungen
Die Einrichtung von Webhooks hat keine Auswirkungen auf die Telefonnummer in deiner WhatsApp Business-App. Sobald du deine Telefonnummer über die WhatsApp Business Platform migriert hast, kannst du diese Nummer nicht mehr in der WhatsApp Business-App verwenden.
Webhooks abonnieren
Um Webhooks zu abonnieren, benötigst du eine Meta-App-ID und Berechtigungen. Gehe dafür zum Dashboard der Meta-App. Dort tust du Folgendes:
- Eine Business-App im Dashboard der Meta-App erstellen
- Das Webhooks-Produkt im App-Dashboard zu deiner Meta-App hinzufügen
Jede Meta-App kann nur einen konfigurierten Endpunkt zur selben Zeit haben. Wenn du deine Webhook-Updates an mehrere Endpunkte senden musst, brauchst du mehrere Meta-Apps.
Wenn du ein Lösungspartner bist, musst du möglicherweise Folgendes tun:
- Füge die Berechtigung
whatsapp_business_messagingin deinem App-Dashboard hinzu
- Schließe den App Review von Meta erfolgreich ab – Dieser Schritt erfordert Zeit, jedoch kannst du während des gesamten Review-Prozesses weiter testen.
Informationen zu Webhooks
Wann immer ein Trigger-Event eintritt, nimmt die WhatsApp Business-Plattform das Event zur Kenntnis und sendet eine Benachrichtigung an die Webhook-URL, die du zuvor festgelegt hast. Du kannst zwei Arten von Benachrichtigungen erhalten:
- Empfangene Nachrichten: Diese Warnung teilt dir mit, wenn du eine Nachricht erhältst. Diese Nachrichten werden in der Dokumentation auch als „eingehende Nachrichten“ bezeichnet.
- Benachrichtigungen zum Nachrichtenstatus und der Preisgestaltung: Diese Warnung teilt dir mit, wenn sich der Status einer Nachricht ändert – z. B. die Nachricht wurde gelesen oder zugestellt. Diese Nachrichten werden in der Dokumentation auch als „ausgehende Nachrichten“ bezeichnet.
Alle Webhooks haben das folgende allgemeine Format:
{
"object": "whatsapp_business_account",
"entry": [{
"id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
"changes": [{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "PHONE_NUMBER",
"phone_number_id": "PHONE_NUMBER_ID"
},
# specific Webhooks payload
},
"field": "messages"
}]
}]
}Weitere Informationen zu jedem Feld findest du unter Komponenten.
Wenn du eine Nachricht empfängst, die von der Cloud API nicht unterstützt wird, erhältst du einen Webhook für eine unbekannte Nachricht.
Payload-Größe
Die Payloads von Webhooks können bis zu 3 MB groß sein.
Beispiele für App-Endpunkte
Erstelle ein Beispiel für einen App-Endpunkt, um deine Webhooks zu testen.
Fehler bei der Webhook-Auslieferung
Wenn wir eine Webhook-Anfrage an deinen Endpunkt senden und dein Server mit einem anderen HTTP-Statuscode als 200 antwortet oder wenn wir den Webhook aus einem anderen Grund nicht zustellen können, versuchen wir es so lange mit abnehmender Häufigkeit, bis die Anfrage erfolgreich ist, und zwar bis zu sieben Tage lang.
Beachte, dass Wiederholungsversuche an alle Apps gesendet werden, die Webhooks (und ihre entsprechenden Felder) für das WhatsApp Business-Konto abonniert haben. Dies kann zu doppelten Webhook-Benachrichtigungen führen.
IP-Adressen
Du kannst die IP-Adressen unserer Webhook-Server abrufen, indem du in deinem Terminal den folgenden Befehl ausführst:
whois -h whois.radb.net — '-i origin AS32934' | grep ^route | awk '{print $2}' | sort
Wir ändern diese IP-Adressen in regelmäßigen Abständen. Wenn du also unsere Server auf der Allow-Liste hast, solltest du diese Liste gelegentlich neu erstellen und deine Allow-Liste entsprechend aktualisieren.
Nächste Schritte
Erfahre mehr über die Informationen, die du mit einer Webhooks-Benachrichtigungen erhalten kannst.