Webhook Masuk

Webhook masuk adalah alamat rahasia. Tool lain mengirim data ke alamat itu. Konektor membaca kiriman tersebut lalu menambah lead, atau memperbarui lead yang sudah ada.

Pakai dengan Zapier, Make, n8n, pembuat formulir, atau CRM. Anda tidak perlu API key.

Untuk arah sebaliknya, saat Konektor mengirim event ke tool Anda, baca Webhooks. Untuk panduan langkah demi langkah, baca Zapier, Make, dan n8n.

Syarat

Anda adalah pemilik workspace.
Paket mencakup API: Pro, Enterprise, atau paket Custom yang mengaktifkannya. Trial dan Starter tidak mencakup webhook masuk.
Workspace punya webhook masuk yang lebih sedikit dari batas paket: 20 di Pro dan Custom, dan 50 di Enterprise.

Buat webhook masuk

Buka API & Webhooks.
Di Webhook masuk, pilih Tambah webhook masuk.
Isi nama yang menunjukkan tool pengirim lead, lalu pilih Buat.
Salin alamatnya. Bentuknya https://konektor.id/api/hooks/in/....

Siapa pun yang punya alamat ini bisa menambah lead. Jaga kerahasiaannya. Untuk membacanya lagi, buka menu webhook lalu pilih Tampilkan alamat. Hanya pemilik yang bisa melakukannya.

Kirim contoh dan pilih kolom

Konektor belum tahu bentuk data Anda sampai melihat satu kiriman.

Pilih Atur pada webhook, lalu pilih Tunggu contoh.
Kirim satu contoh dari tool Anda ke alamat tadi. Pakai data yang mirip aslinya.
Konektor menyimpan kiriman ini sebagai contoh dan menampilkan daftar kolomnya. Kiriman ini tidak membuat lead.
Untuk tiap kolom lead, pilih kolom kiriman yang mengisinya.
Atur nilai awal dan kolom pencocok (lihat di bawah), lalu pilih Simpan.

Editor menunggu 2 menit. Jika tidak ada kiriman, pilih tombolnya lagi. Contoh baru menggantikan contoh lama.

Pilih minimal nama, nomor telepon, atau email.

Kolom lead

Kolom lead	Yang diisi
Nama	Kata pertama menjadi nama depan. Sisanya menjadi nama belakang.
Telepon	Nomor telepon. Sampai 20 karakter.
Email	Alamat email. Harus alamat yang valid.
Status	Status lead seperti `new` atau `qualified`. Nilai yang tidak dikenal diabaikan, lalu nilai awal berlaku.
Sumber	Sumber lead seperti `website` atau `ads`. Nilai yang tidak dikenal diabaikan, lalu nilai awal berlaku.
Nilai	Perkiraan nilai. Angka, atau teks yang hanya berisi digit.
Catatan	Teks bebas. Sampai 5000 karakter.
Referensi dari tool lain	ID dari tool lain. Sampai 150 karakter.
UTM source, medium, campaign, term, content	Tag kampanye. Sampai 200 karakter masing-masing.

Path menunjuk ke kolom di dalam kiriman. Pakai titik untuk masuk lebih dalam: contact.email. Pakai angka untuk item daftar: items.0.sku. Konektor menampilkan path dari contoh Anda, jadi Anda cukup memilih dari daftar.

Jika kiriman tidak punya nama, Konektor memakai nama dari email atau nomor telepon sebagai nama depan.

Nilai awal dan lead yang sudah ada

Sumber untuk lead baru dan Status untuk lead baru berlaku saat kiriman tidak membawanya. Keduanya tidak pernah mengubah lead yang sudah ada.

Cari lead yang sudah ada lewat menentukan apa yang terjadi saat kiriman masuk:

Pencocok	Hasil
Tidak ada	Setiap kiriman membuat lead baru.
Referensi dari tool lain	Lead dengan referensi yang sama diperbarui.
Telepon	Lead dengan nomor telepon yang sama diperbarui.
Email	Lead dengan email yang sama diperbarui.

Jika tidak ada lead yang cocok, Konektor membuat lead baru. Jika Anda memetakan referensi tanpa mengatur pencocok, kiriman dengan referensi yang sudah ada memperbarui lead itu, sehingga kiriman ulang tidak membuat data ganda.

Pembaruan hanya mengubah kolom yang Anda petakan. Lead yang dibuat atau diubah lewat cara ini juga mengirim webhook keluar lead.created dan lead.updated, dengan source bernilai inbound_webhook.

Yang diterima alamat

Hal	Aturan
Metode	`POST`
Isi	JSON (`application/json`) atau data formulir (`application/x-www-form-urlencoded`).
Ukuran	Sampai 64 KB.
Kecepatan	Sampai 60 kiriman per menit dari satu alamat IP.

Jawaban

Status	Arti
`202` dengan `"lead_id"`	Lead dibuat atau diperbarui. `"action"` bernilai `created` atau `updated`.
`202` dengan `"captured": true`	Kiriman disimpan sebagai contoh. Tidak ada lead yang dibuat.
`202` dengan `"mapped": false`	Webhook belum punya pengaturan kolom. Tidak ada lead yang dibuat.
`404`	Alamat salah, mati, dihapus, atau tidak tersedia di paket. Semuanya memberi jawaban yang sama.
`409`	Kiriman cocok dengan lead yang sudah ada dan tidak bisa ditambahkan lagi.
`413`	Isi lebih besar dari 64 KB.
`415`	Isi bukan JSON atau data formulir.
`422`	Kiriman tidak punya nama, telepon, atau email, atau punya nilai yang tidak bisa disimpan di lead.
`429`	Batas lead harian workspace penuh, atau alamat dipanggil terlalu sering.
`503`	Konektor belum bisa menyimpan kiriman. Kirim lagi.

Kartu webhook menampilkan waktu kiriman terakhir, jumlah kiriman, dan alasan kegagalan terakhir.

Ubah atau hentikan alamat

Pakai tombol sakelar untuk mematikan alamat. Alamat menjawab 404 sampai Anda menyalakannya lagi.
Pilih Buat alamat baru jika alamat bocor. Alamat lama berhenti saat itu juga. Tempel alamat baru di tool Anda.
Hapus webhook untuk menghilangkannya. Ini tidak bisa dibatalkan.

Kelola dari Claude dan Agent API

Claude dan agen AI bisa menampilkan, membuat, mengubah, dan menghapus webhook masuk setelah Anda setuju, serta membaca daftar kolom dari contoh kiriman. Mereka tidak pernah melihat isi nilai contoh. Lihat Agent API dan Connector untuk Claude.

Butuh Bantuan Lebih Lanjut?

Tim kami siap membantu Anda memaksimalkan tracking iklan dan atribusi bisnis.

support@konektor.idYouTube

Wulan bantu jawab dan kirim video panduan. Jadwal sesi tersedia lewat Wulan bila masih perlu.