Webhook di reazione WhatsApp

whatsapp.reacted si attiva quando un contatto reagisce a uno dei tuoi messaggi, cambia emoji o ritira la reazione. Le reazioni inviate dal tuo numero aziendale non lo emettono. Un abbonamento a whatsapp.received non include le reazioni, e una reazione non apre una finestra di assistenza clienti.

Una reazione è un'annotazione su un messaggio, non un messaggio a sé, quindi non fa parte della cronologia di consegna e non include i campi presenti in ogni evento messaggio.

Il payload

whatsapp_id indica il messaggio che ha ricevuto la reazione, non la reazione stessa, e emoji è la modifica effettuata dall'utente. Un utente che reagisce, cambia emoji e poi ritira la reazione produce tre eventi su quello stesso messaggio. WhatsApp non invia alcuna rimozione tra i primi due, quindi un cambio arriva come un singolo evento con la nuova 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 riporta l'orario della reazione al secondo, quindi due di quei tre eventi possono condividere lo stesso timestamp. Ordinarli in base a quel valore non li metterà in sequenza, e nemmeno l'ordine di consegna, reso inaffidabile dai tentativi ripetuti. Gestisci la reazione che ogni evento contiene, come la modifica che descrive. Non ricostruire la sequenza dagli eventi e non trattare l'ultimo arrivato come la reazione attuale del messaggio, perché né i timestamp né l'ordine di arrivo lo garantiscono. Rileggi il messaggio per le reazioni in vigore: GET /v1/whatsapp/messages/{message_id} restituisce una voce per mittente in reactions, e il log delle reazioni del messaggio contiene ogni modifica.

emoji è presente e vale null quando l'utente ha ritirato la reazione, quindi un null è la rimozione stessa e non un valore mancante. L'emoji viene consegnata esattamente come WhatsApp l'ha inviata e non viene normalizzata, quindi ❤ e ❤️ arrivano come stringhe diverse.

• from è il contatto e to è il tuo numero WhatsApp. Gestisci gli ID utente con ambito aziendale quando l'indirizzo del contatto non ha un numero di telefono.

Passaggi successivi

• Inviare o rimuovere una reazione: reagire a un messaggio dal proprio numero aziendale
• Webhook WhatsApp: scegliere altri eventi a cui iscriversi