WhatsApp-Reaktions-Webhooks

whatsapp.reacted wird ausgelöst, wenn ein Kontakt auf eine Ihrer Nachrichten reagiert, sein Emoji ändert oder die Reaktion zurücknimmt. Reaktionen, die von Ihrer Geschäftsnummer gesendet werden, lösen das Ereignis nicht aus. Ein Abonnement von whatsapp.received enthält keine Reaktionen, und eine Reaktion öffnet kein Kundenservice-Fenster.

Eine Reaktion ist eine Anmerkung zu einer Nachricht und keine eigenständige Nachricht. Sie ist daher nicht Teil der Zustellungs-Timeline und enthält nicht die Felder, die jedes Nachrichtenereignis enthält.

Das Payload

whatsapp_id benennt die Nachricht, auf die reagiert wurde, nicht die Reaktion, und emoji ist die Änderung, die der Nutzer vorgenommen hat. Ein Nutzer, der reagiert, sein Emoji ändert und dann die Reaktion zurücknimmt, erzeugt drei Ereignisse zu dieser einen Nachricht. WhatsApp sendet zwischen den ersten beiden kein Entfernungsereignis, sodass eine Änderung als einzelnes Ereignis mit dem neuen Emoji eintrifft.

{
  "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 gibt die Reaktionszeit sekundengenau an, sodass zwei dieser drei Ereignisse denselben timestamp haben können. Eine Sortierung danach ergibt keine Reihenfolge, und die Zustellreihenfolge ist durch Wiederholungsversuche ebenfalls unzuverlässig. Behandeln Sie die Reaktion jedes Ereignisses als die Änderung, die es beschreibt. Rekonstruieren Sie nicht die Abfolge aus den Ereignissen und behandeln Sie das zuletzt eintreffende Ereignis nicht als die aktuelle Reaktion der Nachricht, da weder die Zeitstempel noch die Eingangsreihenfolge das stützen. Lesen Sie die Nachricht zurück, um die bestehenden Reaktionen zu erhalten: GET /v1/whatsapp/messages/{message_id} gibt einen Eintrag pro Absender in reactions zurück, und das Reaktionsprotokoll der Nachricht enthält jede Änderung.

emoji ist vorhanden und null, wenn der Nutzer seine Reaktion zurückgenommen hat. Ein Null-Wert ist also die Entfernung selbst und kein fehlender Wert. Das Emoji wird genau so geliefert, wie WhatsApp es gesendet hat, und wird nicht normalisiert, sodass ❤ und ❤️ als unterschiedliche Strings bei Ihnen ankommen.

• from ist der Kontakt und to ist Ihre WhatsApp-Nummer. Behandeln Sie geschäftsbereichsbezogene Nutzer-IDs, wenn die Adresse des Kontakts keine Telefonnummer enthält.

Nächste Schritte

• Reaktion senden oder entfernen: Mit Ihrer Geschäftsnummer auf eine Nachricht reagieren
• WhatsApp-Webhooks: Andere Events zum Abonnieren auswählen