Pengenalan
Sistem webhook CSKU AI memungkinkan Anda menerima notifikasi real-time tentang event yang terjadi dalam percakapan chatbot AI Anda. Webhook memungkinkan Anda membangun integrasi yang bereaksi terhadap pesan pelanggan, respons AI, aktivitas agen, dan perubahan status perangkat.Mulai Cepat
Siapkan webhook dalam hitungan menit
Event
Jelajahi event webhook
Autentikasi
Amankan webhook Anda
Contoh
Contoh kode dalam berbagai bahasa
Cara Kerja Webhook
1
Konfigurasi
Siapkan URL webhook Anda di Settings → Webhook
2
Terima
Dapatkan request HTTP POST dengan data event
3
Proses
Tangani payload di aplikasi Anda
4
Respons
Kembalikan HTTP 200 OK untuk mengonfirmasi penerimaan
Alur Webhook
Event yang Didukung
Webhook mendukung berbagai jenis event untuk memberikan informasi tentang semua aktivitas penting.
| Event | Deskripsi | Trigger |
|---|---|---|
channel.message_in | Pesan masuk dari pelanggan | Pelanggan mengirim pesan |
agent.message_out | Pesan dari agen manusia | Agen mengirim pesan |
ai.message_generated | Respons dari agen AI | AI menghasilkan respons |
device.connected | Perangkat online | Perangkat terhubung |
device.disconnected | Perangkat offline | Perangkat terputus |
Pelajari lebih lanjut tentang setiap jenis event di Bagian Event.
Status Pengiriman Pesan
CSKU AI melacak status pengiriman pesan keluar melalui webhook. Setiap status mewakili tahap dalam siklus pengiriman pesan.| Status | Deskripsi | Indikator Visual |
|---|---|---|
pending | Pesan tersimpan di database, menunggu untuk dikirim | Centang abu-abu tunggal |
process | Pesan dikirim ke API channel (WABA, Instagram, Facebook, WhatsApp) | Centang abu-abu tunggal |
sent | Pesan berhasil terkirim ke penerima | Centang abu-abu ganda |
delivered | Pesan dikonfirmasi terkirim ke perangkat penerima | Centang abu-abu ganda |
read | Penerima telah membaca pesan (via webhook dari WABA, Instagram, WhatsApp, Facebook) | Centang biru ganda |
failed | Pengiriman pesan gagal | Indikator merah |
Diagram Alur Status
Status
read hanya tersedia untuk channel yang mendukung tanda baca: WhatsApp Business API (WABA), Instagram, WhatsApp, dan Facebook.Persyaratan
Sebelum menyiapkan webhook, pastikan Anda memiliki:- Endpoint HTTPS yang dapat diakses publik (untuk produksi)
- Server yang dapat menerima request POST
- Business ID dan Secret Key Anda untuk autentikasi
Manfaat
Notifikasi Real-Time
Notifikasi Real-Time
Terima notifikasi instan saat event terjadi, menghilangkan kebutuhan untuk polling.
Alur Kerja Otomatis
Alur Kerja Otomatis
Trigger aksi otomatis berdasarkan event tertentu, seperti mengirim email follow-up atau memperbarui CRM Anda.
Sinkronisasi Data
Sinkronisasi Data
Jaga sistem eksternal Anda tetap sinkron dengan data CSKU AI secara otomatis.
Analitik Lebih Baik
Analitik Lebih Baik
Kumpulkan event webhook untuk analitik dan pelaporan kustom.
Langkah Selanjutnya
Siapkan Webhook
Konfigurasi endpoint webhook Anda
Autentikasi
Pelajari cara mengamankan webhook
Referensi Event
Dokumentasi event lengkap
Praktik Terbaik
Pastikan penanganan webhook yang andal
Pertimbangan Keamanan
- Selalu validasi header
Authorization - Gunakan HTTPS untuk endpoint produksi
- Jangan pernah log informasi sensitif dari payload
- Rotasi secret key Anda secara berkala
- Implementasikan rate limiting pada endpoint Anda