Konfigurasi webhook

Kelola dari dashboard

Percakapan dan delivery API menggunakan scope messages:read.

Buka Developer → Webhook, pilih Buat webhook, isi nama dan endpoint HTTPS yang menerima POST, lalu pilih message.received.v1, message.sent.v1, dan/atau message.status.updated.v1. Untuk event status, pilih status yang ingin dikirim per URL. Secret ditampilkan satu kali saat dibuat atau saat memilih Buat secret baru; simpan sebelum menutup dialog.

Webhook aktif dapat diuji dengan Kirim webhook percobaan, dijeda dengan Jeda webhook, dan dilanjutkan dengan Lanjutkan webhook. Nonaktifkan webhook bersifat permanen: pengiriman baru berhenti dan pengiriman yang masih menunggu dibatalkan. Riwayat pengiriman menampilkan percobaan, status HTTP, error, latency, dan waktu retry berikutnya.

Verifikasi request

Gunakan raw body yang diterima, bukan JSON yang sudah diparse. Header publiknya adalah:

x-metaflowhub-event-id
x-metaflowhub-event-type
x-metaflowhub-delivery-id
x-metaflowhub-timestamp
x-metaflowhub-signature

Hitung HMAC-SHA256 dengan secret webhook atas string <timestamp>.<rawBody>. Cocokkan hasil hex dengan nilai v1= pada x-metaflowhub-signature, dan terapkan pemeriksaan timestamp/replay di sistem kamu. Simpan event-id atau delivery-id untuk deduplikasi.

Balas dengan status HTTP yang sesuai dan proses secara idempotent. Jika delivery gagal, gunakan riwayat pengiriman untuk melihat status, error, latency, dan retry berikutnya; jangan membocorkan secret dalam log.

Event message.sent.v1 membawa snapshot lengkap dan dapat memuat data sensitif. Event status sengaja ringan. Pada transisi SENT, kedua event dapat diterima; deduplikasi berdasarkan event ID. URL asset template stabil tetapi dapat dicabut, jadi jangan log atau membagikannya.