Integrasi Webhook mengirimkan HTTP request bertanda tangan (signed) ke server Anda setiap kali ada kejadian dalam sebuah percakapan — pesan baru masuk, balasan terkirim, status pengiriman berubah, reaksi ditambahkan, atau percakapan di-assign maupun di-resolve. Alih-alih melakukan polling ke API, sistem Anda bisa langsung bereaksi begitu event terjadi.
Webhook dikonfigurasi per channel. Anda dapat menambahkan satu atau lebih endpoint ke channel WhatsApp, Instagram, Telegram, Facebook Messenger, atau Webchat, masing-masing berlangganan event yang Anda butuhkan.
Cara kerjanya
- Anda menambahkan webhook endpoint ke sebuah channel dari Integrations → Webhook, dengan memilih URL tujuan dan jenis event yang ingin diterima.
- Ketika event yang sesuai terjadi pada channel tersebut, Chatmo membangun payload JSON dan mengirimkannya ke URL Anda sebagai
HTTP POST, ditandatangani dengan secret yang hanya diketahui oleh Anda dan Chatmo. - Server Anda memverifikasi signature, memproses payload, lalu mengembalikan response
2xx. Jika server Anda tidak dapat dijangkau atau mengembalikan error, Chatmo akan otomatis mencoba ulang (retry) selama beberapa waktu sebelum berhenti (lihat Percobaan Ulang & Jaminan Pengiriman). - Setiap percobaan pengiriman — berhasil maupun gagal — dicatat dan dapat dilihat dari dashboard, sehingga Anda bisa memeriksa request dan response yang persis kapan saja.
:::info Persyaratan paket Webhook tersedia mulai dari paket Professional ke atas. Jika organisasi Anda menggunakan paket di bawahnya, kartu Webhook pada halaman Integration akan meminta Anda untuk upgrade. :::
Yang bisa Anda bangun dengan ini
- Sinkronkan setiap pesan masuk dan keluar ke CRM atau data warehouse Anda sendiri.
- Picu alert internal saat sebuah percakapan di-assign ke sebuah tim.
- Tutup tiket dukungan di sistem Anda sendiri begitu percakapan di-resolve di Chatmo.
- Lacak perubahan status persetujuan template WhatsApp tanpa perlu polling API.
- Kirim data rate pengiriman/dibaca secara real time ke dashboard BI Anda.
Langkah selanjutnya
| Halaman | Isi |
|---|---|
| Pengaturan | Menambahkan webhook dari dashboard langkah demi langkah, dan apa yang perlu dilakukan server penerima Anda |
| Event & Payload | Daftar lengkap event, channel mana yang mendukung masing-masing, dan bentuk payload persis per event dan channel |
| Keamanan & Keandalan | Cara kerja signing dan cara memverifikasinya, serta percobaan ulang dan apa yang terjadi saat endpoint Anda lambat atau down |
| Pengujian & Contoh Kode | Mengirim test event, membaca log pengiriman, dan verifikasi signature dalam cURL, Node.js, Python, PHP, dan Go |