API Cloud

Messaggi con reazione

I messaggi con reazione sono risposte tramite emoji che si applicano al messaggio precedente di un utente di WhatsApp che hai ricevuto.

Limitazioni

Quando si invia un messaggio con reazione, viene attivato soltanto il webhook del messaggio inviato (status impostato su sent). I webhook dei messaggi consegnati e letti non saranno attivati.

Invio di messaggi con reazione

Usa l'endpoint POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages per applicare una reazione sotto forma di emoji a un messaggio che hai ricevuto da un utente di WhatsApp.

Sintassi della richiesta

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Corpo del post

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

Parametri del corpo del post

PlaceholderDescrizioneValore di esempio

<EMOJI>

Stringa

Obbligatorio

Sequenza di escape Unicode dell'emoji, o l'emoji stesso, da applicare al messaggio dell'utente.

Esempio di sequenza di escape Unicode:

\uD83D\uDE00

Esempio di emoji:

😀

<WHATSAPP_MESSAGE_ID>

Stringa

Obbligatorio

ID del messaggio WhatsApp a cui vuoi applicare l'emoji.

Se il messaggio a cui stai aggiungendo una reazione è stato creato da più di 30 giorni, non corrisponde a nessun messaggio nella conversazione, è stato eliminato o è a sua volta un messaggio con reazione, il tuo messaggio con reazione non verrà consegnato e riceverai un webhook dei messaggi con il codice errore 131009.

wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQUZCMTY0MDc2MUYwNzBDNTY5MAA=

<WHATSAPP_USER_PHONE_NUMBER>

String

Required.

WhatsApp user phone number.

+16505551234

Esempio di richiesta

Esempio di richiesta per applicare l'emoji della faccina sorridente (😀) al messaggio dell'utente ricevuto in precedenza.

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

Esempio di risposta

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