Status pesan

2 min read

Event message_status hanya WABA. Kirisan POST saat Meta melaporkan status pengiriman atau baca untuk pesan WABA keluar.

Aktifkan Message status (atau event status WABA setara) di Webhooks → Webhook untuk nomor WABA terhubung. Device WhatsApp dan Telegram tidak menggunakan event ini di halaman webhook.

Header:

X-Kirisan-Event: message_status

Field payload

Field	Tipe	Arti
`event`	string	`message_status`
`channel`	string	`waba`
`device`	string	Token device WABA
`recipient`	string	Nomor telepon pelanggan
`message_id`	string	ID pesan Meta (`wamid.…`)
`status`	string	Status Meta — misalnya `sent`, `delivered`, `read`, `failed`
`metadata`	object	`message_id`, `status`, array `errors` opsional
`timestamp`	integer	Detik Unix
`production`	boolean	`true` untuk lalu lintas live

Saat Meta melaporkan error, metadata.errors mungkin mencantumkan objek dengan code, title, dan message.

Contoh — delivered

{
  "event": "message_status",
  "channel": "waba",
  "device": "your-waba-device-token",
  "recipient": "6281234567890",
  "message_id": "wamid.HBgLNjI4MTIzNDU2Nzg5MBUCABIYFDN...",
  "status": "delivered",
  "metadata": {
    "message_id": "wamid.HBgLNjI4MTIzNDU2Nzg5MBUCABIYFDN...",
    "status": "delivered"
  },
  "timestamp": 1735689600,
  "production": true
}

Contoh — failed

{
  "event": "message_status",
  "channel": "waba",
  "device": "your-waba-device-token",
  "recipient": "6281234567890",
  "message_id": "wamid.HBgLNjI4MTIzNDU2Nzg5MBUCABIYFDN...",
  "status": "failed",
  "metadata": {
    "message_id": "wamid.HBgLNjI4MTIzNDU2Nzg5MBUCABIYFDN...",
    "status": "failed",
    "errors": [
      {
        "code": 131026,
        "title": "Message undeliverable",
        "message": "Receiver is incapable of receiving this message"
      }
    ]
  },
  "timestamp": 1735689600,
  "production": true
}

Terkait

Pesan masuk — balasan pelanggan WABA
Ringkasan webhook — event khusus WABA
Device WABA — hubungkan nomor terlebih dahulu
Send API — kirim WABA keluar yang memicu pembaruan status