---
title: "WhatsApp-webhooks"
description: "De WhatsApp-webhookgebeurtenissen die Bird naar je endpoint kan sturen, de envelop waar elke gebeurtenis in aankomt, en de velden die een berichtgebeurtenis altijd bevat."
canonical: "https://bird.com/nl-nl/documentatie/guides/whatsapp/webhooks"
---

# WhatsApp-webhooks

Bird pusht WhatsApp-activiteit naar je endpoint zodra die plaatsvindt, zodat je er niet voor hoeft te pollen. Abonneer je via de [**Webhooks**](https://bird.com/dashboard/w/webhooks)-pagina of met [`POST /v1/webhooks`](/docs/api/reference/create-webhook). De [Webhooks-gids](/docs/guides/webhooks) behandelt endpoints, handtekeningverificatie en opnieuw proberen.

## Gebeurtenissen waarop je je kunt abonneren

Elke gebeurtenis linkt naar zijn payload.

| Gebeurtenis                                                                                         | Wordt verstuurd wanneer                                        |
| --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| [`whatsapp.accepted`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                | Bird accepteert een uitgaand verzendverzoek                    |
| [`whatsapp.sent`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                    | Bird draagt het bericht over aan het WhatsApp-netwerk          |
| [`whatsapp.delivered`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)               | WhatsApp bevestigt aflevering op het apparaat van de ontvanger |
| [`whatsapp.read`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                    | De ontvanger opent het bericht                                 |
| [`whatsapp.failed`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                  | Het bericht kan niet worden afgeleverd                         |
| [`whatsapp.rejected`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                | Bird weigert het bericht voordat het wordt verzonden           |
| [`whatsapp.received`](/docs/guides/whatsapp/webhooks/messages)                                      | Een contact stuurt je een bericht                              |
| [`whatsapp.reacted`](/docs/guides/whatsapp/webhooks/reactions)                                      | Een contact voegt een reactie toe, wijzigt of verwijdert deze  |
| [`whatsapp_suppression.created`](/docs/guides/whatsapp/webhooks/suppressions)                       | Er wordt een onderdrukking geopend op je werkruimte            |
| [`whatsapp.group.join_request_created`](/docs/guides/whatsapp/webhooks/groups#join-request-created) | Iemand vraagt om lid te worden van een groep                   |
| [`whatsapp.group.join_request_revoked`](/docs/guides/whatsapp/webhooks/groups#join-request-revoked) | Iemand trekt het verzoek om lid te worden van een groep in     |

De lijst met gebeurtenistypen is open: er kunnen in de loop van de tijd nieuwe typen worden toegevoegd. Behandel een onbekende waarde als een toekomstige gebeurtenis, niet als een fout.

## De gebeurtenisenvelop

Elke WhatsApp-gebeurtenis gebruikt de standaard [webhook-envelop](/docs/guides/webhooks): een `type`, een `timestamp` en een typespecifiek `data`-object.

```json
{
  "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"
}
```

## Velden die elke berichtgebeurtenis bevat

Elke WhatsApp-webhookpayload voor een bericht bevat `whatsapp_id`, `workspace_id`, `direction`, `from`, `to`, `tags` en `metadata`. De reactie-, onderdrukkings- en groepsgebeurtenissen gaan niet over een bericht en hebben elk hun eigen structuur, beschreven op hun eigen pagina.

- **Adressen**: `from` en `to` kunnen een E.164-`phone_number`, een Meta [business-scoped user ID](/docs/guides/whatsapp/business-scoped-user-ids) in `bsuid`, of beide bevatten. Een bericht dat is ontvangen van een WhatsApp-gebruiker bevat ook het profiel dat deze publiceert, in `username` en `display_name`.
- **`tags` en `metadata`** zijn `null` wanneer het verzendverzoek er geen bevatte.
- **`in_reply_to_message_id`** verschijnt bij elke uitgaande gebeurtenis van een bericht dat als antwoord is verzonden, van `whatsapp.accepted` tot en met `whatsapp.read`, `whatsapp.failed` of `whatsapp.rejected`, en benoemt het bericht waarop wordt geantwoord.

Gebeurtenispayloads bevatten geen kosten. Lees het bericht terug met [`GET /v1/whatsapp/messages/{message_id}`](/docs/api/reference/get-whatsapp-message) om de kosten te bekijken.

## Volgende stappen

- [Berichtstatus-webhooks](/docs/guides/whatsapp/webhooks/message-status): payloads voor bezorging en mislukte berichten
- [Inkomende-bericht-webhooks](/docs/guides/whatsapp/webhooks/messages): de `whatsapp.received`-payload
- [Reactie-webhooks](/docs/guides/whatsapp/webhooks/reactions): de `whatsapp.reacted`-payload
- [Webhooks-gids](/docs/guides/webhooks): endpoints, handtekeningen, nieuwe pogingen en de volledige gebeurtenissencatalogus

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