Kirim & Status Pesan

Kirim

to hanya angka, 10 sampai 15 digit, tanpa tanda +. Awalan 0 diubah otomatis menjadi 62.

params harus persis sama dengan placeholder template. Untuk placeholder berurutan, key-nya "1", "2", dan seterusnya.

Kirim Idempotency-Key unik per pesan. Request ulang dengan key yang sama tidak mengirim dua kali.

Respons	Arti
`201 WhatsApp message queued`	Masuk antrean. Simpan `data._id` untuk dipantau
`200 WhatsApp message already queued`	`Idempotency-Key` yang sama sudah pernah dipakai
`201 Recipient is suppressed`	Nomor tujuan ada di daftar suppression. Tidak dikirim
`402 Subscription is not active`	Langganan WhatsApp tidak aktif
`403 WhatsApp number is suspended`	Nomor ditangguhkan. Hubungi tim Notiblast
`409 WhatsApp number is not connected`	Hubungkan ulang nomor
`422 Template parameters do not match`	Samakan `params` dengan placeholder template
`429`	Batas kecepatan terlampaui. Tunggu, lalu ulangi

201 berarti diantrekan, belum terkirim.

WhatsApp tidak punya kuota pesan bulanan di Notiblast. Biaya percakapan ditagih Meta langsung ke akun Meta Anda.

Baca status dengan GET /v1/wa/messages atau GET /v1/wa/messages/{wa_message_id}, memakai API key full_access.

Status	Arti
`queued`	Diterima, menunggu dikirim
`sent`	Diterima WhatsApp
`delivered`	Sampai di HP penerima
`read`	Dibaca penerima (hanya bila penerima mengaktifkan centang biru)
`failed`	Gagal permanen. Alasan ada di `error`
`failed_rate_limit`	Ditolak karena batas kecepatan nomor
`suppressed`	Tidak dikirim karena nomor tujuan ter-suppress

Status hanya bergerak maju: pesan yang sudah read tidak turun ke delivered meskipun laporan delivered datang terlambat.

Gejala	Solusi
`400` pada field `to`	Kirim angka saja tanpa `+`, spasi, atau tanda hubung
`422 Template parameters do not match`	Nama dan jumlah key `params` harus sama dengan placeholder
`403 Template is not approved`	Tunggu template `approved` di dasbor
`422 This template belongs to a different WhatsApp Business Account`	Pakai template dari WABA yang sama dengan nomor pengirim
`403 This API key is not authorized to send from this WhatsApp number`	Key `sending_access` dikunci ke nomor lain