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.

Event example
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.

Webhook headers
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.