WEBHOOKS
Webhooks Overview
KelolaChat mengirim event ke server Anda melalui HTTP POST yang ditandatangani. Anda cukup mendaftarkan satu URL, memilih event yang dibutuhkan, lalu memproses event tersebut di backend Anda.
Event yang dikirim
Webhook digunakan untuk pesan masuk dan perubahan status pesan. Payload mengikuti event yang diterima dari WhatsApp Cloud API dan menyertakan identifier untuk korelasi di sistem Anda.
X-Kelola-Event: message.received
X-Kelola-Event-Id: wamid.HBgM...Verifikasi signature
Validasi X-Kelola-Signature menggunakan secret webhook sebelum memproses body. Jangan memproses event hanya karena request datang dari internet.
Content-Type: application/json
X-Kelola-Signature: t=1716480000,v1=<hex>Acknowledge delivery
Kembalikan HTTP 2xx setelah event diterima dan diproses atau dimasukkan ke queue Anda. Simpan pekerjaan berat di background worker agar endpoint cepat merespons.
Retries dan deduplication
Delivery dapat diulang ketika endpoint gagal. Simpan X-Kelola-Event-Id atau message ID dengan TTL dan pastikan handler idempotent agar event yang sama tidak menghasilkan efek ganda.
What’s next
Lanjutkan ke contoh payload, verifikasi signature, dan retry policy sebelum mengaktifkan webhook di production.