Submission

Event submission aktif saat pengguna menyelesaikan formulir submission autoreply pada device terhubung ke webhook Anda.

Aktifkan Submission di Webhooks → Webhook dan hubungkan device yang memiliki formulir. Lihat Submission autoreply.

Header:

X-Kirisan-Event: submission

Field payload

Field	Tipe	Arti
event	string	submission
submission	object	id (ID formulir) dan name (judul formulir)
device	string	Token atau pengenal device
sender	string	Pengguna yang menyelesaikan formulir (telepon atau chat id)
channel	string	whatsapp, telegram, atau waba
answers	array	Satu objek per pertanyaan, sesuai urutan tanya
started_at	integer	Detik Unix saat sesi dimulai
completed_at	integer	Detik Unix saat formulir dikirim
timestamp	integer	Detik Unix saat Kirisan mengirim webhook
production	boolean	true live; false di Webhooks → Test

Setiap item answers[]

Field	Arti
question	Teks pertanyaan yang ditampilkan ke pengguna
answer	Objek jawaban — lihat di bawah

Objek answer

answer.type	Field
text	text — string biasa
image, video, audio, file	file dengan url, filename, filetype (dan mime_type opsional)

Jawaban kosong atau yang dilewati muncul sebagai { "type": "text", "text": "" }.

Contoh

{
  "event": "submission",
  "submission": {
    "id": 42,
    "name": "Registration form"
  },
  "device": "your-device-token",
  "sender": "6281234567890",
  "channel": "whatsapp",
  "answers": [
    {
      "question": "What is your name?",
      "answer": {
        "type": "text",
        "text": "Jane Doe"
      }
    },
    {
      "question": "Upload your ID photo",
      "answer": {
        "type": "image",
        "file": {
          "url": "https://cdn.example.com/uploads/id-photo.jpg",
          "filename": "id-photo.jpg",
          "filetype": "image",
          "mime_type": "image/jpeg"
        }
      }
    }
  ],
  "started_at": 1735689480,
  "completed_at": 1735689600,
  "timestamp": 1735689600,
  "production": true
}

Terkait

• Ringkasan webhook — aktifkan Submission pada endpoint Anda
• Pesan masuk — pesan pelanggan sebelum formulir
• Uji webhook submission — tutorial uji langkah demi langkah
• Submission autoreply — buat formulir di dashboard