Webhooki reakcji WhatsApp

whatsapp.reacted jest wysyłany, gdy kontakt zareaguje na jedną z Twoich wiadomości, zmieni emoji lub wycofa reakcję. Reakcje wysłane przez Twój numer firmowy nie generują tego zdarzenia. Subskrypcja whatsapp.received nie obejmuje reakcji, a reakcja nie otwiera okna obsługi klienta.

Reakcja to adnotacja do wiadomości, a nie osobna wiadomość, więc nie należy do osi czasu dostarczenia i nie zawiera pól, które niesie każde zdarzenie wiadomości.

Ładunek

whatsapp_id wskazuje wiadomość, na którą zareagowano, a nie samą reakcję, natomiast emoji to zmiana dokonana przez użytkownika. Użytkownik, który zareaguje, zmieni emoji, a potem wycofa reakcję, wygeneruje trzy zdarzenia dla tej jednej wiadomości. WhatsApp nie wysyła usunięcia między dwoma pierwszymi zdarzeniami, więc zmiana dociera jako pojedyncze zdarzenie z nowym 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 podaje czas reakcji z dokładnością do sekundy, więc dwa z tych trzech zdarzeń mogą mieć ten sam timestamp. Sortowanie po nim nie ustali ich kolejności, podobnie jak kolejność dostarczenia, którą ponowne próby czynią zawodną. Reaguj na reakcję zawartą w każdym zdarzeniu jako na opisywaną przez nie zmianę. Nie próbuj rekonstruować sekwencji ze zdarzeń ani traktować ostatniego otrzymanego zdarzenia jako aktualnej reakcji na wiadomość, ponieważ ani znaczniki czasu, ani kolejność dostarczenia tego nie gwarantują. Odczytaj wiadomość, aby sprawdzić obowiązujące reakcje: GET /v1/whatsapp/messages/{message_id} zwraca jeden wpis na nadawcę w reactions, a dziennik reakcji wiadomości zawiera każdą zmianę.

emoji jest obecne i ma wartość null, gdy użytkownik wycofał reakcję, więc null oznacza samo usunięcie, a nie brakującą wartość. Emoji jest dostarczane dokładnie tak, jak wysłał je WhatsApp, bez normalizacji, więc ❤ i ❤️ docierają jako różne ciągi znaków.

• from to kontakt, a to to Twój numer WhatsApp. Obsłuż identyfikatory użytkowników w zakresie firmy, gdy adres kontaktu nie zawiera numeru telefonu.

Następne kroki

• Wyślij lub usuń reakcję: reaguj na wiadomość z numeru firmowego
• Webhooki WhatsApp: wybierz inne zdarzenia do subskrypcji