Error & Solusi

Error itu bagian dari hidup, apalagi hidup developer. Semua error dari Zawa bentuknya sama:

{
  "statusCode": 404,
  "message": "session not found"
}

Cocokin statusCode dan message yang kamu dapet sama tabel di bawah, terus ikutin solusinya.

400: Request-nya Kurang Pas

message	Artinya	Solusi
invalid header	Header id atau session-id nggak dikirim.	Kirim dua header itu di semua endpoint selain POST /session.
invalid phone, group or newsletter	Kirim Pesan tanpa tujuan.	Isi salah satu dari phone, group, atau newsletter.
invalid phone or group	Kirim Typing tanpa tujuan.	Isi phone atau group.
invalid receiver	Nomor atau ID kurang dari 8 digit setelah dirapihin.	Cek lagi formatnya di Konsep Dasar.
type must be one of the following values: ...	Nilai type nggak dikenal.	Pakai salah satu nilai yang disebut di pesan error-nya.
text should not be empty	type diisi text, tapi text kosong.	Isi kolom text.
image should not be empty (juga video, audio, dst.)	Objek media untuk type itu nggak dikirim.	Kirim objeknya, misalnya image buat type: "image".
image.url should not be empty, video.duration must be a positive number, dst.	Ada kolom wajib di dalam objek yang kosong atau salah.	Cek tabel objek di Kirim Pesan.
groupId should not be empty / channelId should not be empty	Query parameter wajib nggak dikirim.	Tambahin parameternya ke URL.

404: Sesinya Nggak Ketemu

message	Artinya	Solusi
session not found	id atau session-id salah, atau sesinya udah dihapus.	Cek lagi dua header itu. Kalau udah bener, berarti sesinya udah hilang, jadi bikin sesi baru.

Sesi bisa hilang karena beberapa hal: QR nggak di-scan sekitar 3 menit, sesi terputus lebih dari 30 menit, atau kamu sendiri yang hapus. Detailnya ada di Siklus Hidup Sesi.

500: Ada Masalah Waktu Diproses

message	Artinya	Solusi
session not connected	Sesinya ada, tapi lagi nggak nyambung ke WhatsApp.	Cek Ambil Session. Kalau qrcode terisi, scan lagi. Kalau kosong, tunggu sebentar karena Zawa lagi nyambung ulang.
session not found	Sesinya ada di database tapi belum aktif di server, misalnya karena server baru restart.	Tunggu beberapa detik, terus coba lagi. Kalau tetap gagal, reset atau bikin sesi baru.
error parser file from url ...	Media gagal diunduh dari URL yang kamu kasih.	Pastikan URL-nya publik, langsung ke file, dan servernya cepat jawab.
send timeout after 240s	Proses kirim lebih dari 4 menit.	Pakai file yang lebih kecil atau server file yang lebih cepat.
error compress image: ...	Gambar buat status gagal diproses.	Pastikan URL-nya beneran gambar yang valid (JPG atau PNG).
contacts not synced, reconnect the session or set status privacy to "only share with"	Buku kontak belum tersinkron, jadi Zawa nggak tahu status harus dikirim ke siapa.	Reset Session terus scan ulang, atau ubah privasi status di HP ke Hanya bagikan dengan....
status privacy "only share with" has no contacts	Privasi status kamu Hanya bagikan dengan..., tapi daftarnya kosong.	Tambahin minimal satu kontak ke daftar itu di HP.
channel not found	ID channel salah, atau channelnya nggak ada.	Ambil ID yang bener dari Ambil Channel.
internal server error atau pesan lainnya	Ada yang nggak beres di server.	Coba lagi beberapa saat. Kalau masih, kabarin kita ya.

Pertanyaan yang Sering Muncul

qrcode kosong terus, gimana dong?

Di beberapa detik pertama setelah Buat Session atau Reset Session, itu wajar. Panggil Ambil Session tiap 2–3 detik. Kalau lebih dari 30 detik masih kosong dan isConnected juga false, coba Reset Session.

Udah scan QR, tapi isConnected masih false.

Habis di-scan, WhatsApp butuh beberapa detik buat nyelesaiin proses tautan. Tunggu sebentar, terus cek lagi. Kalau tiba-tiba muncul QR baru, berarti tautannya gagal, jadi scan sekali lagi.

Dapet messageId, tapi pesannya nggak nyampe.

messageId artinya pesan udah diterima server WhatsApp. Kalau nggak nyampe, biasanya karena nomor tujuan nggak terdaftar di WhatsApp (Zawa nggak ngecek ini), format nomornya salah, atau nomor kamu lagi dibatasi WhatsApp karena kebanyakan kirim pesan.

Status kekirim, tapi nggak muncul di kontak tertentu.

Penerima status ngikutin pengaturan privasi status di HP kamu dan buku kontak yang tersinkron. Ingat juga aturan WhatsApp: status cuma kelihatan buat orang yang juga nyimpen nomor kamu di kontaknya.

Nomor saya diblokir WhatsApp, kenapa ya?

Biasanya karena kirim pesan ke banyak orang yang nggak kenal kamu dalam waktu singkat, atau banyak penerima yang ngelaporin pesan kamu sebagai spam. Baca lagi Sebelum Mulai buat tips biar nomor kamu tetap aman.