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.

Im Dashboard einrichten Events-API ansehen

Webhook POST https://seusistema.com/webhooks/wpp

{
  "id": "evt_0123456789abcdef",
  "event": "MESSAGE_DELIVERED",
  "timestamp": "2026-09-15T10:30:00Z",
  "message": {
    "id": "msg_123",
    "status": "delivered",
    "phone": "5511999999999"
  }
}

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.

01 Sie geben die URL an

Hinterlegen Sie im Dashboard einen HTTPS-Endpunkt Ihres Systems, um Rückmeldungen zu erhalten.

02 Ereignisse auswählen

Aktivieren Sie nur die Status, die Ihr System verarbeiten muss, um betrieblichen Lärm zu vermeiden.

03 Status ändert sich

Erstellung, Zustellung, Lesung oder Fehler werden unabhängig von der gewählten Verbindung gleich behandelt.

04 Empfangen und verfolgen

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.

HTTPS

Verwenden Sie eine sichere, öffentliche und stabile URL, um Rückrufereignisse zu empfangen.

Schnelle Antwort

Antworten Sie mit HTTP 200 oder 204 nach Empfang des Ereignisses und verarbeiten Sie lang laufende Aufgaben in einer internen Warteschlange.

Idempotenz

Verwenden Sie Nachrichten- und Ereigniskennungen, um Duplikate bei erneuten Zustellungen zu vermeiden.

Protokolle

Payload, Datum, HTTP-Status und Verarbeitungsergebnis zur Prüfung protokollieren.

Warnungen

Verwenden Sie MESSAGE_ERROR, um den Support oder den Betrieb über von einer Verbindung zurückgegebene Fehler zu informieren.

Trennung

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.

Configurar webhooks