Cara Memasang Webhook

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.
• Pantau penerima. Bila alamat penerima sempat mati, kejadian saat itu bisa terlewat — pastikan ia andal dan terpantau.
• Sudah ada plugin? Untuk platform populer, sering tidak perlu menyiapkan webhook sendiri — lihat panduan Plugin Tokens.

Masalah umum

• Sistemmu tidak menerima apa pun — cek alamat penerima bisa diakses dari internet (bukan alamat lokal/intranet) dan event yang relevan sudah dipilih.
• Data terkirim ganda — wajar pada sistem webhook; buat penerima yang aman bila menerima data yang sama dua kali.
• Menu Webhooks tidak terlihat — fitur Developer hanya untuk akun Bisnis dan Pemerintah.