Webhook reaksi WhatsApp

whatsapp.reacted aktif saat kontak memberi reaksi pada salah satu pesan Anda, mengubah emoji, atau mencabutnya. Reaksi yang dikirim oleh nomor bisnis Anda tidak memicu event ini. Langganan ke whatsapp.received tidak mencakup reaksi, dan reaksi tidak membuka jendela layanan pelanggan.

Reaksi adalah anotasi pada pesan, bukan pesan tersendiri, sehingga tidak termasuk dalam lini waktu pengiriman dan tidak membawa field yang dimiliki setiap event pesan.

Payload

whatsapp_id menyebut pesan yang diberi reaksi, bukan reaksinya, dan emoji adalah perubahan yang dilakukan pengguna. Pengguna yang memberi reaksi, mengubah emoji, lalu mencabut reaksi menghasilkan tiga event pada satu pesan tersebut. WhatsApp tidak mengirim penghapusan di antara dua event pertama, sehingga perubahan tiba sebagai satu event yang membawa emoji baru.

{
  "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 melaporkan waktu reaksi hingga detik, sehingga dua dari tiga event tersebut bisa memiliki timestamp yang sama. Mengurutkan berdasarkan nilai itu tidak akan menghasilkan urutan yang benar, begitu juga urutan pengiriman yang tidak dapat diandalkan karena pengulangan coba lagi. Tindak lanjuti reaksi yang dibawa setiap event sebagai perubahan yang dideskripsikannya. Jangan merekonstruksi urutan dari event atau memperlakukan event terakhir yang tiba sebagai reaksi aktif pesan tersebut, karena baik timestamp maupun urutan kedatangan tidak mendukungnya. Baca kembali pesan untuk melihat reaksi yang masih berlaku: GET /v1/whatsapp/messages/{message_id} mengembalikan satu entri per pengirim di reactions, dan log reaksi pesan tersebut memuat setiap perubahan.

emoji hadir dan bernilai null saat pengguna mencabut reaksi, sehingga null adalah penghapusan itu sendiri, bukan nilai yang hilang. Emoji dikirim persis seperti yang dikirimkan WhatsApp dan tidak dinormalisasi, sehingga ❤ dan ❤️ sampai kepada Anda sebagai string yang berbeda.

• from adalah kontak dan to adalah nomor WhatsApp Anda. Tangani ID pengguna cakupan bisnis jika alamat kontak tidak memiliki nomor telepon.

Langkah berikutnya

• Kirim atau hapus reaksi: bereaksi terhadap pesan dari nomor bisnis Anda
• Webhook WhatsApp: pilih event lain untuk dilanggani