---
title: "Webhooks de réaction WhatsApp"
description: "Le payload whatsapp.reacted lorsqu'un contact ajoute, modifie ou supprime une réaction emoji, et pourquoi les événements ne peuvent pas être ordonnés pour reconstituer l'état actuel."
canonical: "https://bird.com/fr-fr/documentation/guides/whatsapp/webhooks/reactions"
---

# Webhooks de réaction WhatsApp

`whatsapp.reacted` se déclenche quand un contact réagit à l'un de vos messages, change son emoji ou retire sa réaction. Les réactions envoyées par votre numéro professionnel ne le déclenchent pas. Un abonnement à `whatsapp.received` n'inclut pas les réactions, et une réaction n'ouvre pas de fenêtre de service client.

Une réaction est une annotation sur un message et non un message à part entière : elle ne fait pas partie de la chronologie de livraison et ne contient pas les [champs présents dans chaque événement de message](/docs/guides/whatsapp/webhooks#fields-every-message-event-carries).

## Le payload

`whatsapp_id` désigne le message ayant reçu la réaction, et non la réaction elle-même, et `emoji` est la modification effectuée par l'utilisateur. Un utilisateur qui réagit, change son emoji, puis retire sa réaction produit trois événements sur ce même message. WhatsApp n'envoie pas de suppression entre les deux premiers : une modification arrive donc comme un seul événement portant le nouvel emoji.

```json
{
  "data": {
    "emoji": "👍",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "whatsapp_id": "wam_01ky8b3xq4gd7pmzn2ka51f7te",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b"
  },
  "timestamp": "2026-07-23T14:52:11.000Z",
  "type": "whatsapp.reacted"
}
```

WhatsApp indique l'heure de la réaction à la seconde près, donc deux de ces trois événements peuvent partager le même `timestamp`. Les trier par cette valeur ne les ordonnera pas, pas plus que l'ordre de livraison, que les réessais rendent peu fiable. Traitez la réaction portée par chaque événement comme la modification qu'il décrit. Ne reconstituez pas la séquence à partir des événements et ne considérez pas le dernier reçu comme la réaction en vigueur sur le message, car ni les horodatages ni l'ordre d'arrivée ne le permettent. Relisez le message pour obtenir les réactions en vigueur : [`GET /v1/whatsapp/messages/{message_id}`](/docs/api/reference/get-whatsapp-message) renvoie une entrée par expéditeur dans `reactions`, et le [journal des réactions](/docs/api/reference/list-whatsapp-message-reaction-events) du message contient chaque modification.

`emoji` est présent et `null` quand l'utilisateur a retiré sa réaction : un null est la suppression elle-même et non une valeur manquante. L'emoji est livré exactement tel que WhatsApp l'a envoyé, sans normalisation : `❤` et `❤️` vous parviennent donc comme des chaînes différentes.

- `from` est le contact et `to` est votre numéro WhatsApp. Gérez les [identifiants utilisateur à portée professionnelle](/docs/guides/whatsapp/business-scoped-user-ids) quand l'adresse du contact ne contient pas de numéro de téléphone.

## Étapes suivantes

- [Envoyer ou supprimer une réaction](/docs/guides/whatsapp/reactions) : réagir à un message depuis votre numéro professionnel
- [Webhooks WhatsApp](/docs/guides/whatsapp/webhooks) : choisir d'autres événements auxquels vous abonner

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