Abonniere Webhooks und erhalte Benachrichtigungen über Nachrichten, die dein Unternehmen empfängt, sowie Änderungen an Kundenprofilen. Weitere Informationen zu Webhooks für die WhatsApp Business Platform findest du unter Übersicht, Webhooks.
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.
Was du benötigst:
HTTPS 200 OK
-Antwort zurückgibt, wenn eine Benachrichtigung empfangen wirdWenn eine Benachrichtigung aus beliebigem Grund nicht übermittelt wird oder die Webhook-Anfrage einen anderen HTTP-Statuscode als 200
zurückgibt, wiederholen wir die Webhook-Auslieferung. Die Auslieferung wird in immer größeren Intervallen bis zu einer bestimmten Zeitüberschreitung (in der Regel 24 Stunden, kann jedoch variieren) oder bis zur erfolgreichen Auslieferung erneut versucht.
Sende eine PATCH
-Anfrage an den /v1/settings/application
-Endpunkt und legen den webhooks
-Parameter auf deinen Rückruf-URL-Endpunkt fest. Weitere häufig konfigurierte Parameter sind sent_status
und callback_persist
.
PATCH /v1/settings/application { "callback_persist": true, "sent_status": true, // Either use this or webhooks.message.sent, but webhooks.message.sent property is preferred as sent_status will be deprecated soon "webhooks": { "url": "webhook.your-domain", "message": { // Available on v2.41.2 and above "sent": false, "delivered": true, "read": false }, } }
Bei Erfolg enthält die Antwort 200 OK
mit null
oder ein JSON-Objekt.
Weitere Informationen zur Konfiguration deiner App und zusätzlichen Webhook-Parametern findest du in den Referenzen zu Anwendungseinstellungen.
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:
Weitere Informationen zu jedem Feld findest du unter Komponenten.
{ "errors": [ { "code": <error-code>, "title": "<error-title>", "details": "<error-description>", "href": "location for error detail" }, { ... } ] }
Um deine Webhooks zu testen, kannst du eine Beispielapp mit einem Endpunkt für das Empfangen von Benachrichtigungen erstellen.