Lewati ke konten
TERSEDIA

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

  1. 01

    Siapkan URL

    Gunakan alamat publik yang menerima POST. Alamat lokal atau jaringan privat ditolak.

  2. 02

    Pilih kejadian

    Centang hanya kejadian yang kamu butuhkan.

  3. 03

    Simpan secret

    NADI membuat secret saat webhook dibuat. Simpan, karena secret dipakai untuk memverifikasi tanda tangan.

  4. 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.

Coba NADI di bisnismu hari ini.

Mulai dari paket harian Rp 20.000, atau lihat demo untuk melihat AI menjawab.