WhatsApp-reactiewebhooks

whatsapp.reacted wordt geactiveerd wanneer een contact reageert op een van je berichten, de emoji wijzigt of de reactie intrekt. Reacties die door je zakelijke nummer worden verstuurd, activeren het event niet. Een abonnement op whatsapp.received bevat geen reacties, en een reactie opent geen klantenservicevenster.

Een reactie is een annotatie op een bericht en geen eigen bericht, dus maakt het geen deel uit van de bezorgtijdlijn en bevat het niet de velden die elk berichtevent bevat.

De payload

whatsapp_id verwijst naar het bericht waarop is gereageerd, niet naar de reactie, en emoji is de wijziging die de gebruiker heeft aangebracht. Een gebruiker die reageert, de emoji wijzigt en vervolgens de reactie intrekt, produceert drie events op dat ene bericht. WhatsApp stuurt geen verwijdering tussen de eerste twee, dus een wijziging komt binnen als één event met de nieuwe 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 rapporteert de reactietijd tot op de seconde, dus twee van die drie events kunnen dezelfde timestamp delen. Sorteren op dat veld ordent ze niet, en de bezorgvolgorde evenmin, want herhaalpogingen maken die onbetrouwbaar. Handel naar de reactie die elk event bevat, als de wijziging die het beschrijft. Reconstrueer de volgorde niet uit de events en beschouw het laatst ontvangen event niet als de geldende reactie op het bericht, want noch de tijdstempels noch de aankomstvolgorde ondersteunen dat. Lees het bericht terug voor de reacties die gelden: GET /v1/whatsapp/messages/{message_id} retourneert één entry per afzender in reactions, en het reactielog van het bericht bevat elke wijziging.

emoji is aanwezig en null wanneer de gebruiker de reactie heeft ingetrokken, dus een null is de verwijdering zelf en geen ontbrekende waarde. De emoji wordt precies afgeleverd zoals WhatsApp deze heeft verstuurd en wordt niet genormaliseerd, dus ❤ en ❤️ komen als verschillende strings bij je aan.

• from is het contact en to is je WhatsApp-nummer. Verwerk bedrijfsgebonden gebruikers-ID's wanneer het adres van het contact geen telefoonnummer heeft.

Volgende stappen

• Een reactie verzenden of verwijderen: reageer op een bericht vanuit je zakelijke nummer
• WhatsApp-webhooks: kies andere events om je op te abonneren