DOKUMENTASI
Webhook NADI untuk sistemmu.
NADI mengirim kejadian penting ke URL milikmu, bertanda tangan HMAC SHA-256, supaya sistemmu bisa memverifikasi bahwa kiriman itu asli.
Ilustrasi tampilan. Nama dan isi pesan adalah contoh.
Kejadian yang bisa dikirim
new_chat
Pesan pertama dari sebuah kontak.
chat_received
Setiap pesan masuk dari pelanggan.
ai_replied
Setiap balasan yang dikirim AI.
lead_converted
Status lead berubah menjadi closing.
lead_lost
Status lead berubah menjadi batal.
payment_received
Pembayaran terkonfirmasi oleh pendeteksi penjualan.
appointment_booked
Janji atau reservasi tercatat.
escalation_triggered
Pemilik diberi tahu karena kata kunci pemicu.
Bentuk kiriman dan verifikasi
POST https://url-milikmu.example/webhook
X-Nadi-Signature: sha256=<hex>
{ "event": "new_chat", "customerId": "cust_...", "timestamp": "2026-10-24T08:00:00.000Z", "data": { ... } }
// Node.js: bandingkan tanda tangan dengan isi mentah (raw body)
const sig = "sha256=" + crypto.createHmac("sha256", SECRET).update(rawBody).digest("hex");
const ok = crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(req.headers["x-nadi-signature"]));Cara memasang webhook
- 01
Siapkan URL
Gunakan alamat publik yang menerima POST. Alamat lokal atau jaringan privat ditolak.
- 02
Pilih kejadian
Centang hanya kejadian yang kamu butuhkan.
- 03
Simpan secret
NADI membuat secret saat webhook dibuat. Simpan, karena secret dipakai untuk memverifikasi tanda tangan.
- 04
Balas 2xx
Balas dengan status 2xx. Kiriman yang gagal terus menerus menonaktifkan webhook secara otomatis.
Pertanyaan umum
Berapa webhook yang bisa dibuat?
Sampai 10 webhook per akun.
Apa yang terjadi bila URL-ku gagal menerima?
NADI mencatat kegagalan. Setelah 10 kegagalan, webhook itu dinonaktifkan otomatis dan kamu perlu mengaktifkannya lagi setelah URL-mu diperbaiki.
Apakah ada daftar endpoint API publik?
Belum. Dokumentasi ini hanya mencakup webhook keluar.
Lanjut ke
Coba NADI di bisnismu hari ini.
Mulai dari paket harian Rp 20.000, atau lihat demo untuk melihat AI menjawab.