Semua panduan
Otomasi7 menit baca

Panduan · Panduan integrasi

Cara mengirim event iBuat.Link ke CRM atau tool otomasi dengan webhook

Kirim event bertanda tangan ke CRM atau alur otomasi kamu setiap kali iBuat.Link mengarahkan pengunjung ke agent sales, mencatat closing, atau ada perubahan di link dan kuota plan kamu.

Ilustrasi produk

Webhook

Link, kode QR & Sales Router

CRM lead sync

https://crm.example.com/hooks/ibuat

Aktif
sales_assignment.createdsales_closing.recordedSemua Sales Team

Log pengiriman

CRM lead syncSUCCEEDED
CRM lead syncRETRYING

Pengiriman diproses terpisah dari redirect link.

Webhook mengirim event dari iBuat.Link ke sistem apa pun yang bisa menerima request HTTPS, misalnya CRM kamu atau alur otomasi. Kamu sendiri yang memilih kabar apa saja yang diterima tiap webhook: chat yang dibagikan ke agent atau nomor cadangan, closing yang tercatat, link yang tembus angka klik tertentu, halaman tujuan yang tidak bisa dibuka atau sudah normal lagi, dan kuota plan yang hampir atau sudah habis. Event dikirim di background, jadi tim kamu bisa menindaklanjutinya tanpa memperlambat redirect sedikit pun. Webhook tidak membaca chat WhatsApp dan tidak memastikan pesan terkirim. Mau pakai workflow yang sudah jadi daripada menyusun sendiri? Panduan n8n punya 8 template yang memakai event yang sama.

  1. 1

    Langkah 1

    Siapkan endpoint HTTPS penerima

    Sistem penerima kamu butuh URL HTTPS publik yang menerima request JSON POST. Bisa endpoint CRM, alur otomasi, atau endpoint kecil buatan developer kamu. Jangan pakai localhost, alamat server private, atau URL yang berisi username dan password. iBuat.Link memblokir tujuan seperti itu demi keamanan.

  2. 2

    Langkah 2

    Buka Integrasi lalu tambahkan webhook

    Di sidebar Dashboard, pilih Integrasi, lalu Tambah webhook. Isi Nama dan tempel URL HTTPS-nya. Di Event yang dikirim, centang kabar apa saja yang perlu diterima URL ini. Event-nya dibagi tiga kelompok: Sales Router, Link & kode QR, dan Akun. Begitu kamu mencentang event Sales Router, kolom Sales Team muncul: biarkan Semua Sales Team untuk menerima chat dan closing dari semua tim, atau pilih satu tim saja. Filter ini hanya berlaku untuk event Sales Router; event link dan akun tetap terkirim. Klik Simpan webhook. Event-nya bisa diubah nanti lewat Ubah event.

    Atau pakai workflow n8n yang sudah jadi
  3. 3

    Langkah 3

    Salin signing secret saat itu juga

    Setelah disimpan, iBuat.Link menampilkan signing secret satu kali saja. Langsung simpan di sistem penerima, karena secret ini tidak akan ditampilkan lagi. Kalau butuh yang baru, pakai Ganti secret. Secret lama langsung tidak berlaku.

  4. 4

    Langkah 4

    Verifikasi setiap request di sistem penerima

    Setiap request membawa header x-ibuat-event, x-ibuat-event-id, x-ibuat-timestamp, dan x-ibuat-signature. Hitung HMAC SHA-256 dengan signing secret kamu dari string persis “timestamp.raw-json-payload”, lalu bandingkan dengan signature setelah awalan “sha256=”. Pakai event ID sebagai idempotency key supaya retry otomatis tidak membuat data ganda. Pakai template n8n siap pakai? Pengecekan ini sudah ada di node “Check the signature”, jadi kamu cukup menempel secret-nya di “Sign the request”.

  5. 5

    Langkah 5

    Kirim delivery tes lalu periksa log

    Klik Kirim tes di baris webhook, lalu buka Log di baris yang sama. Setiap pengiriman menampilkan PENDING atau RETRYING selama diproses, SUCCEEDED kalau endpoint membalas 2xx, atau FAILED kalau jatah retry sudah habis. Pengiriman yang gagal tidak bisa dikirim ulang secara manual: perbaiki endpoint kamu, klik Kirim tes untuk memastikan endpoint sudah menjawab, dan event baru akan masuk seperti biasa. Endpoint yang dinonaktifkan tidak menerima delivery baru.

Data yang dikirim webhook

Webhook hanya menerima event yang kamu centang. Setiap delivery berupa body JSON yang field event-nya menyebut nama event, dan nama yang sama ada di header x-ibuat-event, jadi satu endpoint bisa menangani beberapa event dengan mengecek itu dulu. Berikut daftar event-nya, dengan label yang kamu lihat di form dan tipe yang diterima endpoint kamu. Contoh payload untuk setiap event ada di referensi API.

  • Sales Router · Chat dibagikan ke agent (sales_assignment.created): kunjungan diarahkan ke agent atau nomor cadangan. Isinya waktu penugasan, tim, agent, Short Link, campaign (kalau ada), Ref, mode penugasan, dan apakah sticky routing dipakai ulang.
  • Sales Router · Closing tercatat (sales_closing.recorded): chat yang dibagikan ditandai sebagai penjualan oleh kamu, agent, atau API, atau nilainya diubah. Isinya tim, agent, link, campaign, dan Ref yang sama, plus nilai, mata uang, waktu, dan siapa yang menandai closing. Menyimpan nilai yang sama lagi tidak membuatnya terkirim dua kali.
  • Link & kode QR · Klik tembus angka tertentu (click_milestone.reached): link atau kode QR melewati 100, 1.000, 10.000, 100.000, atau 1.000.000 klik.
  • Link & kode QR · Halaman tujuan tidak bisa dibuka (link.destination_down) dan Halaman tujuan bisa dibuka lagi (link.destination_recovered): halaman web tujuan link menjawab “tidak ditemukan” atau tidak bisa dihubungi dua kali berturut-turut, atau sudah normal lagi.
  • Akun · Kuota plan hampir habis (usage.limit_approaching) dan Kuota plan habis (usage.limit_reached): link, kode QR, Bio Page, campaign, Sales Team, atau klik terlacak sudah 80% atau 100% dari batas plan kamu.
  • Pesanan · Pesanan dibuat (order.created), Status pesanan berubah (order.status_changed), dan Pembayaran pesanan berubah (order.payment_changed): pesanan ditambahkan, pindah ke langkah lain, atau harga, DP, maupun status lunasnya berubah. Isinya pesanan tersebut, termasuk nama dan nomor WhatsApp pelanggan yang kamu ketik, serta info toko.
  • Tidak ada event yang berisi anonymous visitor hash, alamat IP pengunjung, atau isi pesan. Nomor WhatsApp yang dikirim hanya nomor yang kamu ketik sendiri di pesanan, lewat event pesanan.
  • Chat dibagikan ke agent menjelaskan kunjungan yang diarahkan, bukan bukti percakapan WhatsApp atau lead yang sudah terverifikasi.
  • Event masuk antrean setelah catatannya tersimpan, jadi endpoint penerima yang lambat atau mati tidak menahan redirect pengunjung.

Contoh payload

Begini contoh delivery asli Chat dibagikan ke agent untuk kunjungan yang sampai ke agent. Field agent, link, dan campaign masing-masing bisa bernilai null: agent kalau tidak ada agent yang tersedia dan nomor fallback yang dipakai, link kalau tidak ada Short Link terkait, dan campaign kalau link-nya tidak masuk campaign.

  • assignmentMode salah satu dari ROUND_ROBIN, WEIGHTED, atau FALLBACK.
  • Kirim tes mengirim payload yang berbeda dan lebih sederhana: { "event": "sales_assignment.test", "occurredAt": "...", "test": true, "message": "..." }, tanpa field team, agent, link, atau campaign. Jangan asumsikan setiap delivery yang diterima endpoint kamu pasti mengikuti skema di bawah ini.

JSON body: sales_assignment.created

{
  "event": "sales_assignment.created",
  "occurredAt": "2026-09-21T09:15:32.000Z",
  "team": { "id": "8f2c1a10-4b3d-4e2a-9c7f-1a2b3c4d5e6f", "name": "Jakarta Sales" },
  "agent": { "id": "b7e4d2f0-6a1c-4f9b-8d3e-2f1a0b9c8d7e", "name": "Ayu" },
  "link": { "id": "3a9c7e21-5d4b-4a8c-9e1f-7b6c5d4e3f2a", "slug": "ask-sales" },
  "campaign": { "id": "1d6f0a44-2c3b-4d5e-8f9a-0b1c2d3e4f5a", "name": "Ramadan Sale" },
  "referenceToken": "IB-7F3A21C9D0",
  "assignmentMode": "ROUND_ROBIN",
  "stickyReused": false
}

Verifikasi signature

Setiap request membawa header berikut. Hitung HMAC-nya dari raw request body yang benar-benar diterima server kamu. Kalau kamu serialize ulang JSON yang sudah di-parse, urutan key atau whitespace-nya bisa berubah dan menghasilkan hash yang beda dari yang dikirim iBuat.Link.

  • Bandingkan hash dengan timing-safe comparison (misalnya crypto.timingSafeEqual di Node), bukan ===, dan tolak request yang X-Ibuat-Timestamp-nya lebih tua dari beberapa menit untuk mencegah replay.
  • Pakai X-Ibuat-Event-Id sebagai idempotency key. Retry otomatis mengirim ulang event ID yang sama, bukan yang baru.

Header

Content-Type: application/json
User-Agent: iBuat.Link Webhooks/1.0
X-Ibuat-Event: sales_assignment.created
X-Ibuat-Event-Id: evt_5f3a9c1b8e2d4a6fbd170c92
X-Ibuat-Timestamp: 1758445200
X-Ibuat-Signature: sha256=6b0a3fcf1e9d7a4b2c5f8e0d3a6b9c1e4f7a0d3c6b9e2f5a8d1c4b7e0a3d6c9e2f1

// Verifikasi Node.js
const crypto = require('crypto');

function isValidSignature(rawBody, timestampHeader, signatureHeader, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${timestampHeader}.${rawBody}`)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signatureHeader.replace('sha256=', ''))
  );
}

Cara retry bekerja

Gangguan jaringan, timeout, HTTP 408, HTTP 429, dan error server akan dicoba ulang dengan jeda eksponensial terbatas selama sekitar 3 jam. Respons 4xx lain dianggap masalah konfigurasi dan ditandai gagal. Kalau sebuah delivery akhirnya gagal, pemilik workspace mendapat email (paling banyak sekali sehari per endpoint) berisi link ke log pengiriman; event baru tetap dikirim begitu endpoint berfungsi lagi. Catatan delivery tetap ada ketika worker restart; delivery yang sedang diproses saat worker berhenti akan memenuhi syarat diproses ulang setelah masa lease singkatnya berakhir.

Sekarang coba sendiri

Kirim event ke tool kamu tanpa memperlambat pengunjung

Webhook tersedia di plan Pro ke atas. Pilih event yang kamu butuhkan, lalu CRM atau workflow kamu dikabari di belakang layar.