---
title: "Webhooks WhatsApp"
description: "Les événements webhook WhatsApp que Bird peut envoyer à votre endpoint, l'enveloppe dans laquelle chacun arrive, et les champs que tout événement de message contient."
canonical: "https://bird.com/fr-fr/documentation/guides/whatsapp/webhooks"
---

# Webhooks WhatsApp

Bird envoie l'activité WhatsApp à votre endpoint en temps réel, ce qui vous évite de l'interroger. Abonnez-vous depuis la page [**Webhooks**](https://bird.com/dashboard/w/webhooks) ou avec [`POST /v1/webhooks`](/docs/api/reference/create-webhook). Le [guide Webhooks](/docs/guides/webhooks) couvre les endpoints, la vérification de signature et les réessais.

## Événements auxquels vous pouvez vous abonner

Chaque événement renvoie vers son payload.

| Événement                                                                                           | Se déclenche quand                                            |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| [`whatsapp.accepted`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                | Bird accepte une requête d'envoi sortant                      |
| [`whatsapp.sent`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                    | Bird transmet le message au réseau WhatsApp                   |
| [`whatsapp.delivered`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)               | WhatsApp confirme la livraison sur l'appareil du destinataire |
| [`whatsapp.read`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                    | Le destinataire ouvre le message                              |
| [`whatsapp.failed`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                  | Le message n'a pas pu être livré                              |
| [`whatsapp.rejected`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                | Bird refuse le message avant de l'envoyer                     |
| [`whatsapp.received`](/docs/guides/whatsapp/webhooks/messages)                                      | Un contact vous envoie un message                             |
| [`whatsapp.reacted`](/docs/guides/whatsapp/webhooks/reactions)                                      | Un contact ajoute, modifie ou supprime une réaction           |
| [`whatsapp_suppression.created`](/docs/guides/whatsapp/webhooks/suppressions)                       | Une suppression s'ouvre sur votre espace de travail           |
| [`whatsapp.group.join_request_created`](/docs/guides/whatsapp/webhooks/groups#join-request-created) | Quelqu'un demande à rejoindre un groupe                       |
| [`whatsapp.group.join_request_revoked`](/docs/guides/whatsapp/webhooks/groups#join-request-revoked) | Quelqu'un annule sa demande pour rejoindre un groupe          |

La liste des types d'événements est ouverte : de nouveaux types peuvent apparaître au fil du temps. Traitez une valeur non reconnue comme un événement futur plutôt que comme une erreur.

## L'enveloppe d'événement

Chaque événement WhatsApp utilise l'[enveloppe webhook](/docs/guides/webhooks) standard : un `type`, un `timestamp` et un objet `data` propre au type.

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

## Champs présents dans tout événement de message

Chaque payload webhook WhatsApp pour un message contient `whatsapp_id`, `workspace_id`, `direction`, `from`, `to`, `tags` et `metadata`. Les événements de réaction, de suppression et de groupe ne concernent pas un message : chacun a sa propre structure, décrite sur sa page.

- **Adresses** : `from` et `to` peuvent inclure un `phone_number` E.164, un [identifiant utilisateur à portée business](/docs/guides/whatsapp/business-scoped-user-ids) Meta dans `bsuid`, ou les deux. Un message reçu d'un utilisateur WhatsApp contient aussi le profil qu'il publie, dans `username` et `display_name`.
- **`tags` et `metadata`** sont `null` quand l'envoi n'en comportait pas.
- **`in_reply_to_message_id`** apparaît sur chaque événement sortant d'un message envoyé en réponse, de `whatsapp.accepted` à `whatsapp.read`, `whatsapp.failed` ou `whatsapp.rejected`, en nommant le message auquel il répond.

Les payloads d'événement ne contiennent pas de coût. Récupérez le message avec [`GET /v1/whatsapp/messages/{message_id}`](/docs/api/reference/get-whatsapp-message) pour voir ce qu'il a coûté.

## Étapes suivantes

- [Webhooks de statut de message](/docs/guides/whatsapp/webhooks/message-status) : charges utiles de livraison et d'échec
- [Webhooks de message entrant](/docs/guides/whatsapp/webhooks/messages) : la charge utile `whatsapp.received`
- [Webhooks de réaction](/docs/guides/whatsapp/webhooks/reactions) : le payload `whatsapp.reacted`
- [Guide des webhooks](/docs/guides/webhooks) : points de terminaison, signatures, réessais et catalogue complet des événements

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