WhatsApp webhooks voor berichtstatus

Elke wijziging in de status van een uitgaand bericht kan in real time naar je endpoint worden gepusht. Elke payload gebruikt het WhatsApp-eventenvelope en bevat de velden die elk berichtevent bevat.

Bezorgingsevents

whatsapp.accepted, whatsapp.sent, whatsapp.delivered en whatsapp.read bevatten alleen de velden die elk berichtevent bevat. Lifecycle-events beschrijft wat elk event betekent en wanneer whatsapp.delivered wordt overgeslagen.

Codevoorbeeld

{
  "data": {
    "direction": "outbound",
    "from": { "phone_number": "+13124495569" },
    "metadata": { "session_id": "sess_4821" },
    "tags": [{ "name": "flow", "value": "login-otp" }],
    "to": { "phone_number": "+14155550100" },
    "whatsapp_id": "wam_01ky7qbvswf3fvyaw3az90391c",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b"
  },
  "timestamp": "2026-07-23T14:51:39.913Z",
  "type": "whatsapp.delivered"
}

whatsapp.failed en whatsapp.rejected bevatten ook een error-object met een stabiele Bird code, een leesbare description, een optionele meta_error_code en occurred_at. Zie failure-events voor het verschil tussen beide. Bij een gerapporteerde failure is description de eigen uitleg van WhatsApp WhatsApp. Een servicebericht waarvan het klantenservicevenster tussen acceptatie en verzending is gesloten, faalt als volgt:

Codevoorbeeld

{
  "data": {
    "direction": "outbound",
    "error": {
      "code": "service_window_expired",
      "description": "Message failed to send because more than 24 hours have passed since the customer last replied to this number.",
      "meta_error_code": "131047",
      "occurred_at": "2026-07-23T14:51:40.201Z"
    },
    "from": { "phone_number": "+13124495569" },
    "metadata": null,
    "tags": null,
    "to": { "phone_number": "+14155550100" },
    "whatsapp_id": "wam_01ky7qbvswf3fvyaw3az90391c",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b"
  },
  "timestamp": "2026-07-23T14:51:40.201Z",
  "type": "whatsapp.failed"
}

Een inkomend bericht als gelezen markeren registreert whatsapp.read in de tijdlijn van het bericht, maar verstuurt geen webhook.

Volgende stappen

Webhooks voor inkomende berichten: de whatsapp.received-payload voor een bericht dat een contact je stuurt
Webhooks voor reacties: reacties van een contact komen apart binnen
Berichtstatusevents: lees de tijdlijn van een bericht terug via de API

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Bekijk de gidsConnecting WhatsApp to Bird: from buying a number to a live channel Begrijp het conceptWhat is the 24-hour customer service window on WhatsApp?Gebruik de toolWhatsApp message builder Ontdek de mogelijkheidWhatsApp

Probeer de oefening en ontvang een implementatieoverzicht