Status kirim

2 min read

Event send_status memberi tahu server Anda saat POST /v1/send dengan context.behaviour.mode: "async" selesai — sukses atau gagal. Ini adalah webhook selevel akun (channel API di dashboard): tidak terikat device, dan mencakup kombinasi channel apa pun di permintaan yang sama (hanya email, Telegram saja, WABA + email, dan seterusnya).

Siapkan di dashboard

Buka Webhooks → Webhook → Add webhook.
Pilih channel API.
Centang event Send Status / Status Kirim.
Simpan URL HTTPS Anda, lalu jalankan tes di Webhooks → Test hingga status Active.

Webhook ini opsional. mode: async tetap berjalan tanpa webhook — Kirisan tetap mencatat hasil di log akun Anda. Pakai send_status hanya jika server Anda sendiri perlu menerima notifikasi. Lihat Send API.

Kapan Kirisan POST

Setelah kiriman async selesai (cascade channel selesai), Kirisan mengirim satu POST ke setiap endpoint send_status aktif Anda. Header X-Kirisan-Event adalah send_status. Header X-Kirisan-Device bisa kosong karena event ini tidak terikat device.

Contoh payload

{
  "event": "send_status",
  "id": 98765,
  "request_id": 12345,
  "status": "sent",
  "channels": {
    "email": {
      "status": true,
      "id": 98766,
      "processing_time": "891ms"
    },
    "whatsapp": {
      "status": false,
      "id": 98765,
      "reason": "Device disconnected",
      "processing_time": "89ms"
    }
  },
  "timestamp": 1735689600,
  "production": true
}

Field	Arti
`event`	Selalu `send_status`
`id`	`send.id` utama (integer — channel `sent` pertama, atau baris pertama)
`request_id`	`send_log.id` yang dikembalikan saat antre (`queued` response)
`status`	`sent` jika minimal satu channel berhasil; `failed` jika semuanya gagal atau permintaan diblokir
`channels`	Map hasil per channel — bentuk sama seperti respons sync `POST /v1/send` (termasuk `id` = `send.id` per channel)
`timestamp`	Unix detik
`production`	`false` pada Webhooks → Test; `true` untuk lalu lintas live

Cocokkan request_id dengan respons antrean Anda untuk menghubungkan hasil ke permintaan asli.

Terkait

Ringkasan webhook — channel dan kontrak pengiriman
Verifikasi — signing secret dan header
Send API — behaviour.mode dan respons queued