Wazapin mengirimkan peristiwa (event) ke URL yang kamu konfigurasi di bawah Developer → Webhook. Setiap permintaan ditandatangani — verifikasi terlebih dahulu. Cek Contoh tanda tangan webhook and Webhook.
Lakukan deduplikasi mengpakai header svix-id (atau webhook-id) pada setiap pengiriman. Cek Siklus hidup pesan dan idempotensi.
Teks Masuk (message.new)
Panduan tugas: Menangani teks masuk
Pengguna mengirim pesan teks ke nomor WhatsApp kamu.
{
"message_id": "9f1fd66d-c37a-4b50-a8c2-b4dca523f9c8",
"conversation_id": "0f89b0f9-74b4-44f9-b9b6-48f6d4de57aa",
"contact_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
"channel_id": "wzp_abc123",
"direction": "inbound",
"from_phone": "6281234567890",
"msg_type": "text"
}Balasan tombol interaktif (message.new)
Panduan tugas: Menangani balasan interaktif
Pengguna mengetuk tombol balasan cepat (quick-reply) dari pesan buttons kamu.
{
"message_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"conversation_id": "0f89b0f9-74b4-44f9-b9b6-48f6d4de57aa",
"channel_id": "wzp_abc123",
"direction": "inbound",
"from_phone": "6281234567890",
"msg_type": "interactive"
}Ambil konten lengkap dengan GET /v1/messages/{messageID} saat kamu butuh id / judul tombol.
Balasan daftar interaktif (message.new)
Panduan tugas: Menangani balasan interaktif
Pengguna memilih baris dari pesan daftar (list).
{
"message_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"conversation_id": "0f89b0f9-74b4-44f9-b9b6-48f6d4de57aa",
"direction": "inbound",
"from_phone": "6281234567890",
"msg_type": "interactive"
}Lokasi yang dibagikan oleh pengguna (message.new)
Setelah adanya permintaan lokasi, pengguna dapat membagikan koordinat.
{
"message_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"conversation_id": "0f89b0f9-74b4-44f9-b9b6-48f6d4de57aa",
"direction": "inbound",
"from_phone": "6281234567890",
"msg_type": "location"
}Status pengiriman (message.status_update)
Panduan tugas: Menangani status pengiriman
Ketika pesan keluar bergerak melalui status sent (terkirim), delivered (diterima), read (dibaca), atau failed (gagal):
{
"message_id": "9f1fd66d-c37a-4b50-a8c2-b4dca523f9c8",
"conversation_id": "0f89b0f9-74b4-44f9-b9b6-48f6d4de57aa",
"status": "delivered",
"organization_id": "org_123"
}