Hinterlegen Sie im Dashboard einen HTTPS-Endpunkt Ihres Systems, um Rückmeldungen zu erhalten.
Status-Webhooks
Erhalten Sie den Status von WhatsApp-Nachrichten in Ihrem System.
Richten Sie eine URL ein, um standardisierte Ereignisse für Erstellung, Zustellung, Lesebestätigungen und Fehler zu empfangen, und prüfen Sie den Zustellverlauf über die API unabhängig von der gewählten Verbindung.
Flow
WPP Marketing benachrichtigt Ihr System, wenn sich der Status ändert.
Status‑Webhooks sind nützlich für Audits, Abstimmungen, interne Dashboards, Support und Regeln in Ihrem eigenen System.
Der Webhook übermittelt das Ergebnis einer Nachricht; er ist keine Versandanfrage. Verwenden Sie das Messaging API um Nachrichten zu senden und die Events API um Automatisierungen mit unterstützten kommerziellen Ereignissen auszulösen.
Aktivieren Sie nur die Status, die Ihr System verarbeiten muss, um betrieblichen Lärm zu vermeiden.
Erstellung, Zustellung, Lesung oder Fehler werden unabhängig von der gewählten Verbindung gleich behandelt.
Ihr Endpoint verarbeitet die Payload und die Lieferhistorie ist im Dashboard sowie über GET /webhooks verfügbar.
Verfügbare Ereignisse und Abfrage der Lieferungen.
Alle vier Ereignisse verwenden denselben Vertrag in jeder Verbindung, und die API ermöglicht das Abfragen des Ergebnisses jedes Zustellversuchs.
POST
MESSAGE_CREATED
Nachricht wurde im Flow erstellt und erhielt eine Kennung zur Nachverfolgung.
Criação
POST
MESSAGE_DELIVERED
Nachricht wurde an den Empfänger zugestellt, wenn der Kanal eine Bestätigung zurückgibt.
Entrega
POST
MESSAGE_READ
Nachricht wurde gelesen, wenn die Lesebestätigung verfügbar ist.
Leitura
POST
MESSAGE_ERROR
Beim Senden, der Validierung oder der Verarbeitung der Nachricht ist ein Fehler aufgetreten.
Erro
GET
/webhooks
Zeigt die Zustellhistorie mit Status, Versuchen, HTTP-Antwort und Paginierung an. Erfordert den Scope webhooks:read.
Logs
Best Practices
Bereiten Sie Ihren Endpoint darauf vor, wiederholte und außer Reihenfolge eintreffende Ereignisse zu empfangen.
Webhooks sind Übermittlungen zwischen Systemen. Ihr Backend sollte schnell antworten, Logs erfassen und idempotent verarbeiten.
Registrieren Sie eine öffentliche HTTPS-URL und aktivieren Sie Ereignisse im Dashboard. Der aktuelle Vertrag sendet keine HMAC-Signatur; richten Sie für den Empfänger einen angemessenen Schutz und eine Validierung ein, ohne eine nicht vorhandene Signatur vorauszusetzen.
Antworten Sie mit einem HTTP 2xx innerhalb von 15 Sekunden und verarbeiten Sie lang andauernde Aufgaben in einer internen Warteschlange. Weiterleitungen werden nicht gefolgt.
Verwenden Sie die Ereignis-ID, die auch in Webhook-Id gesendet wird, um doppelte Verarbeitung zu vermeiden und Ereignisse außerhalb der Reihenfolge zu akzeptieren. Webhook-Attempt gibt die Versuchnummer an. Es werden nur aktivierte Ereignisse protokolliert und gesendet.
Rufen Sie HTTP-Versuche und -Antworten unter GET /webhooks mit webhooks:read ab. Abgeschlossene, zugestellte oder endgültig fehlgeschlagene Einträge werden 30 Tage lang aufgehoben. Schützen Sie personenbezogene Daten und Nachrichteninhalte in Ihren eigenen Logs.
Verbindungsfehler, Timeouts und Antworten 408, 425, 429 oder 5xx können insgesamt bis zu sieben Versuche auslösen, mit Intervallen von 1, 5 und 15 Minuten sowie 1, 6 und 24 Stunden. Retry-After wird bis zu 24 Stunden beachtet. Andere 4xx-Fehler brechen die Zustellung ab.
Status-Webhooks sind Rückmeldungen von WPP Marketing. Um kommerzielle Shop-Ereignisse zu senden, verwenden Sie die Events API.
Möchten Sie Lieferungen und Fehler in Ihrem System verfolgen?
Richten Sie eine URL im Dashboard ein, wählen Sie die Status aus und verfolgen Sie die Zustellungen im Webhooks-Bericht.