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.

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.

{
  "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} renvoie une entrée par expéditeur dans reactions, et le journal des réactions 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 quand l'adresse du contact ne contient pas de numéro de téléphone.

Étapes suivantes

• Envoyer ou supprimer une réaction : réagir à un message depuis votre numéro professionnel
• Webhooks WhatsApp : choisir d'autres événements auxquels vous abonner