Ringkasan webhook
Webhook Kirisan adalah permintaan HTTPS POST keluar dari Kirisan ke URL yang Anda kendalikan. Ini bukan bagian dari https://api.kirisan.com — server Andalah yang menerima permintaan; Kirisan tidak menyediakan API langganan webhook.
Pakai webhook jika CRM, helpdesk, atau backend Anda perlu bereaksi terhadap pesan masuk atau Submission Autoreply yang selesai — tanpa harus poll dashboard.
Konfigurasi di dashboard
- Buka Webhooks → Webhook dan klik Add webhook.
- Masukkan HTTPS URL Anda, hubungkan device, dan pilih event.
- Jalankan tes berhasil di Webhooks → Test agar status menjadi Active.
Lihat Referensi webhook untuk tur UI lengkap dan Tambahkan endpoint webhook untuk tutorial langkah demi langkah.
Channel yang didukung
| Channel | Event webhook |
|---|---|
| Incoming Message, Submission | |
| Telegram | Incoming Message, Submission |
| WABA | Incoming Message, Submission, Message status (tanda terima pengiriman) |
| API | Send Status (opsional) — notifikasi async POST /v1/send ke server Anda (selevel akun, tanpa device); log Kirisan tetap otomatis |
| Incoming Message — saat email diterima untuk alamat pengirim yang tertaut |
Jenis event
| Event | Header X-Kirisan-Event | Kapan Kirisan POST |
|---|---|---|
incoming_message | incoming_message | Pelanggan mengirim pesan ke device chat terhubung, atau email diterima untuk alamat email terhubung |
submission | submission | Pengguna menyelesaikan formulir submission autoreply pada device terhubung |
message_status | message_status | Hanya WABA — status pengiriman/baca Meta untuk pesan WABA keluar |
send_status | send_status | Opsional — POST /v1/send dengan mode: async selesai; satu POST per permintaan (hanya jika Anda mengonfigurasi endpoint) |
Referensi field payload: Pesan masuk, Submission, Status pesan, Status kirim.
Kontrak pengiriman
| Aturan | Detail |
|---|---|
| Metode | POST |
| Body | application/json |
| Sukses | Server Anda mengembalikan 200 atau 201 |
| Timeout | Sekitar 30 detik per pengiriman live (45 detik untuk Webhooks → Test) |
| Percobaan ulang | Tidak ada — Kirisan mengirim sekali per event dan mencatat hasil di Webhooks → Logs |
| Tes vs live | Payload sampel menyertakan "production": false; lalu lintas live menggunakan "production": true |
Jika server Anda mengembalikan status lain, habis waktu, atau tidak bisa dijangkau, pengiriman ditandai failed. Perbaiki handler dan tunggu event live berikutnya, atau kirim tes lain dari Webhooks → Test.
Header permintaan
Setiap pengiriman menyertakan:
Content-Type: application/json
User-Agent: Kirisan-Webhook/1.0
X-Kirisan-Event: incoming_message
X-Kirisan-Device: <device token or number>Saat Anda mengatur Signing secret pada endpoint, Kirisan juga mengirim:
X-Webhook-Secret: <your secret>Lihat Verifikasi untuk cara memvalidasi permintaan dan merespons dengan aman.
Catatan Telegram
Untuk Incoming Message di Telegram, Kirisan bisa mengaktifkan otomatis endpoint Pending test saat pesan nyata pertama tiba di bot yang terhubung — tetap jalankan Webhooks → Test saat setup agar URL dikonfirmasi lebih awal.
Terkait
- Verifikasi — signing secret, header, dan aturan respons
- Payload pesan masuk — contoh WhatsApp, Telegram, dan WABA
- Status kirim — hasil async
POST /v1/send - Webhooks → Logs — riwayat pengiriman dan error
- Send API — pesan keluar dari aplikasi Anda