API Cloud

Messages de réaction

Les messages de réaction sont des emoji-réactions que vous pouvez appliquer à un message WhatsApp que vous avez reçu.

Limites

Lorsque vous envoyez un message de réaction, seul un webhook de message envoyé (status défini sur sent) sera déclenché. Les webhooks de message distribué et lu ne seront pas déclenchés.

Envoyer des messages de réaction

Utilisez le point de terminaison POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages pour appliquer une réaction avec emoji à un message WhatsApp que vous avez reçu.

Syntaxe de la requête

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Corps de la requête POST

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "type": "reaction",
  "reaction": {
    "message_id": "<WHATSAPP_MESSAGE_ID>",
    "emoji": "<EMOJI>"
  }
}

Paramètres du corps de la requête POST

Espace réservéDescriptionExemple de valeur

<EMOJI>

Chaîne

Obligatoire.

Séquence d’échappement Unicode de l’emoji, ou emoji lui-même, à appliquer au message.

Exemple de séquence d’échappement Unicode :

\uD83D\uDE00

Exemple d’emoji :

😀

<WHATSAPP_MESSAGE_ID>

Chaîne

Obligatoire.

ID de message WhatsApp du message auquel vous souhaitez appliquer l’emoji.

Si le message auquel vous réagissez date de plus de 30 jours, ne correspond à aucun message de la conversation, a été supprimé ou est lui-même un message de réaction, le message de réaction ne sera pas diffusé et vous recevrez un webhook de messages avec le code 131009.

wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQUZCMTY0MDc2MUYwNzBDNTY5MAA=

<WHATSAPP_USER_PHONE_NUMBER>

String

Required.

WhatsApp user phone number.

+16505551234

Exemple de requête

Exemple de requête pour appliquer l’emoji souriant (😀) à un message reçu précédemment.

curl 'https://graph.facebook.com/v21.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "reaction",
  "reaction": {
    "message_id": "wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQUZCMTY0MDc2MUYwNzBDNTY5MAA=",
    "emoji": "\uD83D\uDE00"
  }
}'

Exemple de réponse

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}