Error
Semua error memakai format yang sama:
{ "statusCode": 400, "message": "Akun \"CS Utama\" belum terhubung — hubungkan dulu sebelum mengirim.", "error": "Bad Request"}Untuk error validasi, message berupa array berisi daftar field yang salah:
{ "statusCode": 400, "message": ["phoneNumber must be a string"], "error": "Bad Request"}Kode status
Section titled “Kode status”| Kode | Arti | Yang perlu dilakukan |
|---|---|---|
200 / 201 |
Berhasil. | — |
400 |
Body tidak valid, akun belum terhubung, atau pengiriman ditolak WhatsApp. | Baca message, perbaiki request. |
401 |
X-API-Key tidak ada, salah, atau sudah dicabut. |
Periksa key di Developer → API Key. |
404 |
deviceId tidak ditemukan di workspace Anda. |
Periksa ID akun. |
5xx |
Gangguan di sisi server. | Coba lagi dengan jeda. |
Pesan error yang sering muncul
Section titled “Pesan error yang sering muncul”message |
Penyebab |
|---|---|
Akun "…" belum terhubung … |
Akun pengirim tidak berstatus Terhubung. Hubungkan ulang dari Perangkat. |
Sesi tidak berjalan — tekan Start pada akun ini. |
Sesi akun berhenti. Jalankan lagi dari dashboard. |
Tidak ada berkas yang diunggah. |
POST /messages/media dipanggil tanpa field file. |
Payload bukan JSON yang sah. |
Field payload di /messages/interactive bukan JSON yang valid. |
Gagal mengirim: … |
WhatsApp menolak pesan; detailnya ada setelah titik dua. |
Field yang tidak dikenal di body diabaikan (tidak menyebabkan error).