Panduan ยท Developer
Cara Memasang Webhook
Panduan langkah demi langkah: kita akan mendaftarkan satu webhook dari nol supaya setiap kejadian penting di platform โ pesan masuk, pesanan dibayar โ otomatis dikirim ke sistemmu. Lengkap dengan gambar layarnya.
Untuk siapa panduan ini
Panduan ini untuk developer atau tim teknis pada akun Bisnis (B2B) dan Pemerintah (B2G). Webhook membuat platform aktif mengirim pemberitahuan ke sistemmu setiap kali terjadi sesuatu โ pesan masuk, pesanan dibayar, percakapan dialihkan ke agen.
Pakai panduan ini saat: kamu ingin sistemmu sendiri (ERP, akuntansi, dashboard internal) ikut bereaksi otomatis tiap ada kejadian di platform, tanpa harus memeriksa berkala.
Webhook vs API key. Dengan API key, sistemmu yang aktif memanggil platform. Dengan webhook, platform yang aktif memanggil sistemmu saat ada kejadian. Keduanya saling melengkapi.
Yang perlu disiapkan
- Sebuah alamat (URL) penerima di sistemmu yang bisa diakses dari internet dan siap menerima data โ misalnya
https://erp.perusahaan.com/hook/pesanan. - Sistem penerima yang andal โ sebaiknya tahan bila ada data yang terkirim ulang (idempoten).
- Pemahaman dasar menerima HTTP request โ atau bantuan rekan developer.
Mengenal halaman Webhooks
Semua webhook dikelola di satu halaman: Webhooks. Perhatikan gambar di bawah. Yang perlu kamu kenali:
- Tombol daftarkan webhook baru di pojok kanan atas.
- Daftar webhook di tengah โ tiap baris satu alamat penerima beserta event yang dipilihnya.

Langkah 1 โ Siapkan alamat penerima di sistemmu
Sebelum membuka dashboard, pastikan sistemmu punya satu alamat (URL) yang siap menerima kiriman data โ bisa diakses dari internet (bukan alamat lokal). Inilah tujuan ke mana platform akan mengirim data tiap ada kejadian.
Langkah 2 โ Buka halaman Webhooks
Pada sidebar kiri, cari grup menu DEVELOPER, lalu klik Webhooks. Halaman terbuka menampilkan daftar webhook yang sudah ada.
Langkah 3 โ Daftarkan alamat penerima
Klik tombol daftarkan webhook baru, lalu tempel alamat (URL) penerima dari Langkah 1. Pastikan disalin utuh tanpa spasi tersisa.
Langkah 4 โ Pilih event yang ingin diterima
Pilih event โ jenis kejadian yang ingin dikabari ke alamat itu. Antara lain:
- Pesan masuk โ ada pesan baru dari pelanggan.
- Pesanan dibayar โ sebuah pesanan lunas.
- Percakapan dialihkan ke agen โ bot meminta bantuan manusia.
Mulai dari satu atau dua event dulu, lalu tambah sesuai kebutuhan. Simpan.
Cara tahu berhasil
Webhookmu bekerja benar bila:
- Webhook muncul di daftar halaman Webhooks dengan alamat dan event yang kamu pilih.
- Pancing salah satu event (mis. kirim pesan tes ke channelmu untuk event "pesan masuk") โ sistemmu menerima kiriman data kejadian itu.
- Data yang masuk berisi detail kejadian yang relevan untuk diproses sistemmu.
Tips
- Mulai dari sedikit event. Aktifkan event yang benar-benar dipakai dulu โ lebih mudah ditelusuri saat ada masalah.
- Rancang penerima yang tahan ulang. Kadang data bisa terkirim lebih dari sekali; sistemmu sebaiknya tidak mencatat ganda.
Pertanyaan Umum
Apa beda API dengan webhook?
Dengan API, sistemmu yang memanggil platform untuk mengirim/membaca data. Dengan webhook, platform yang mengabari sistemmu saat ada kejadian. Keduanya saling melengkapi.
Bagaimana kalau alamat penerima sedang mati?
Kejadian saat alamat mati bisa terlewat. Pastikan alamat penerima andal, rancang sistemmu agar tahan bila ada data terkirim ulang, dan pantau agar tidak ada event yang lolos.
Event apa saja yang bisa dipilih?
Antara lain pesan masuk, pesanan dibayar, dan percakapan dialihkan ke agen. Mulai dari satu atau dua event dulu, lalu tambah sesuai kebutuhan.
Apakah satu webhook bisa menerima banyak event?
Bisa. Satu alamat penerima dapat dipilih menerima beberapa event sekaligus. Sistemmu membedakannya dari data yang masuk.
Lihat fitur ini bekerja di industrimu
Begini webhook dipakai menjaga sistem internal selalu terkini di berbagai bidang.
Hotel & Penginapan
Sistem reservasi hotel menerima webhook "pesanan dibayar" lalu otomatis mengunci kamar dan mencatat tamu โ tanpa input manual resepsionis.
SelengkapnyaInstansi & Layanan Publik
Sistem internal instansi menerima webhook "percakapan dialihkan ke agen" untuk mencatat dan mendistribusikan aduan warga ke unit terkait.
Selengkapnya