# 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](/docs/guides/whatsapp/webhooks#the-event-envelope) en bevat de [velden die elke berichtgebeurtenis bevat](/docs/guides/whatsapp/webhooks#fields-every-message-event-carries).

## 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:

```json
{
  "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}`](/docs/api/reference/get-whatsapp-message) documenteert ze allemaal.

## Vervolgstappen

- [WhatsApp-berichten ontvangen](/docs/guides/whatsapp/receiving-whatsapp): elke inhoudsarm en het ophalen van inkomende media
- [Reactie-webhooks](/docs/guides/whatsapp/webhooks/reactions): reacties van een contact komen apart binnen
- [Berichtstatus-webhooks](/docs/guides/whatsapp/webhooks/message-status): bezorg- en foutpayloads voor berichten die je verstuurt

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/whatsapp-api) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)