Webhooks voor inkomende WhatsApp-berichten

Wanneer een contact je een bericht stuurt, pusht Bird whatsapp.received naar je endpoint. De payload gebruikt de WhatsApp-event-envelope en bevat de velden die elke berichtgebeurtenis bevat.

De received-payload

whatsapp.received bevat de inhoud van het bericht bovenop de velden die elke berichtgebeurtenis bevat, zodat een endpoint op een inkomend bericht kan handelen zonder het terug te lezen. Een tik op een interactief bericht komt binnen als interactive_reply, en in_reply_to_message_id bevat het bericht waarop het antwoordt:

Codevoorbeeld

{
  "data": {
    "direction": "inbound",
    "from": {
      "display_name": "Alex Rivera",
      "phone_number": "+14155550100",
      "username": "alexr"
    },
    "in_reply_to_message_id": "wam_01ky7qbvswf3fvyaw3az90391c",
    "interactive_reply": {
      "list": {
        "description": "Next day to 2 days",
        "slug": "priority_express",
        "text": "Priority Mail Express"
      },
      "type": "list"
    },
    "metadata": null,
    "tags": null,
    "to": { "phone_number": "+13124495569" },
    "whatsapp_id": "wam_01ky8b3xq4gd7pmzn2ka51f7te",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b"
  },
  "timestamp": "2026-07-23T14:52:04.118Z",
  "type": "whatsapp.received"
}

De overige inhoudsarmen volgen dezelfde een-van-deze-structuur: text, image, video, audio, sticker, document, location, contact_cards, en unsupported voor een type dat de API niet modelleert. GET /v1/whatsapp/messages/{message_id} documenteert ze allemaal.

Vervolgstappen

WhatsApp-berichten ontvangen: elke inhoudsarm en het ophalen van inkomende media
Reactie-webhooks: reacties van een contact komen apart binnen
Berichtstatus-webhooks: bezorg- en foutpayloads voor berichten die je verstuurt

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