Payload & balasan

Data webhook

Event utama untuk chat dan email adalah incoming_message. Namanya juga ada di header:

X-Kirisan-Event: incoming_message

WhatsApp, Telegram, WABA, dan email memakai kerangka yang sama, jadi parser Anda bisa sebagian besar seragam:

Field	Arti
event	Selalu incoming_message
device	Token device atau alamat email yang menerima
channel	whatsapp, telegram, waba, atau email
sender	Siapa yang menulis — target balasan di sender.sender
message	Tipe, teks, plus opsional file / lokasi / tombol
metadata	Data ekstra per channel (subjek, flag grup, …)
timestamp	Detik Unix
production	false untuk uji dari dashboard

Kalau media masuk disimpan ke Files (paket + storage mengizinkan), message.file berisi url unduhan sementara dan file_id Kirisan. Bentuk lengkap: Pesan masuk.

Event lain (status kirim, submission selesai, …) ada di Webhook.

Apa yang bisa dilakukan dengan data ini

• Routing otomasi menurut channel dan message.type
• Simpan sender / message.text ke CRM
• Unduh lampiran dari message.file.url segera (URL sementara akan kedaluwarsa)
• Jalankan logika yang tidak bisa diungkapkan Flow dashboard

Konsep balasan

Webhook hanya memberitahu bahwa ada yang menulis — bukan mengirim balasan. Untuk menjawab, kirim pesan keluar ke sender.sender (telepon, chat id Telegram, atau alamat email) lewat:

• API: Send dengan kunci channel yang cocok, atau
• Dashboard: balas / teruskan di inbox channel tersebut

Autoreply dan Flow juga bisa membalas tanpa webhook. Pakai webhook kalau keputusan harus ada di sistem Anda.

Selanjutnya

Lihat sampel: Playground webhook.