Tanya jawab
Jawaban untuk pertanyaan yang paling sering muncul.
Pengiriman
Mengapa pesan saya tidak langsung sampai?
Itu disengaja. BGWA mengirim pesan satu per satu dengan jeda acak seperti orang memakai WhatsApp, supaya nomor Anda aman dari pemblokiran. Pesan bisa tiba beberapa detik sampai beberapa menit setelah request, tergantung panjang antrean. Lihat Cara pengiriman.
Arti ok: true pada respons?
Pesan diterima ke antrean, bukan sudah sampai. Hasil akhir dilihat lewat GET /messages/{id} atau webhook.
Status sent berarti pesan sudah dibaca?
Tidak. sent berarti pesan sudah diterima server WhatsApp. BGWA tidak melaporkan status dibaca penerima.
Apakah ada jaminan 100% pesan terkirim?
Tidak ada layanan yang bisa menjamin itu. Pesan bisa gagal jika nomor tidak terdaftar, ponsel penerima bermasalah, atau WhatsApp membatasi akun.
Pantau hasilnya lewat webhook dan tangani message.failed.
Bisakah mengirim ke grup WhatsApp?
Saat ini API hanya mengirim ke nomor pribadi (format 08... atau 62...).
Bisakah mengirim dokumen, video, atau stiker?
API publik mendukung teks dan gambar (JPG, PNG, WebP, maksimal 2 MB) dengan teks sebagai keterangan. Jenis lampiran lain belum tersedia lewat API.
Bagaimana menerima balasan dari penerima?
API ini difokuskan untuk mengirim. Balasan dapat dibaca di menu Pesan pada dashboard. Webhook saat ini hanya melaporkan hasil pengiriman, bukan pesan masuk.
Penolakan dan batas
Mengapa saya menerima 422 "Isi pesan terlalu seragam"?
Teks identik ke banyak penerima baru menyerupai spam. Variasikan isi dengan spintax {Halo|Hai} dan variabel {nama}
(lihat variasi isi pesan).
Mengapa pesan ke nomor yang sama ditolak?
Teks yang sama ke nomor yang sama dalam 10 menit dianggap duplikat (duplicate_message). Tunggu atau ubah isinya.
Mengapa saya kena 429 padahal belum banyak mengirim?
Ada beberapa kemungkinan: batas API 60 request/menit, kuota bulanan paket habis, atau batas penerima baru per jam/hari. Baca field reason dan
retry_after pada respons. Device yang baru terhubung punya batas lebih rendah (pemanasan).
Penerima membalas STOP, apa yang terjadi?
Nomor itu otomatis tidak akan dikirimi lagi dari device Anda. Percobaan berikutnya ditolak dengan recipient_opted_out, dan pesan yang masih antre dibatalkan.
Kuota saya terasa berkurang padahal pesan belum terkirim?
Pesan yang masih menunggu di antrean ikut dihitung terhadap kuota bulanan supaya antrean tidak melampaui batas paket.
Device dan akun
API menjawab 409 "Device belum terhubung". Apa yang harus dilakukan?
Sesi WhatsApp device terputus. Buka menu Device dan scan ulang QR. Cek juga dengan GET /device sampai status bernilai open.
Apa yang terjadi saat paket berakhir?
API menolak pengiriman dengan 403, pesan yang masih antre dibatalkan, dan beberapa menu dashboard dibatasi. Menu Dompet dan Akun tetap bisa dibuka
untuk top-up dan memperpanjang paket. Sesi WhatsApp tidak diputus.
API key saya bocor. Bagaimana?
Buat ulang atau cabut key di menu Device. Key lama langsung tidak berlaku. Perbarui key di server Anda.
Apakah nomor saya bisa diblokir WhatsApp?
Risikonya selalu ada bila nomor dipakai mengirim pesan yang tidak diharapkan. BGWA menekan risiko lewat jeda, batas, dan perlindungan otomatis, tetapi Anda tetap perlu mengirim hanya ke orang yang mengharapkannya, memakai isi yang bervariasi, dan menghormati permintaan berhenti. BGWA tidak berafiliasi dengan WhatsApp atau Meta.
Webhook
Tanda tangan webhook tidak pernah cocok.
Pastikan Anda menghitung HMAC dari body mentah (bukan JSON hasil parse), dengan format timestamp + "." + body, memakai secret yang benar, lalu
membandingkannya dengan sha256= + hex. Bila secret hilang, buat baru lewat POST /webhook/secret.
Webhook saya menerima event yang sama dua kali.
Itu normal bila jawaban server Anda lambat atau bukan 2xx; BGWA mencoba ulang. Simpan delivery_id dan abaikan yang sudah diproses.
URL webhook ditolak dengan 422.
URL harus https, port 443 atau 8443, dan domain publik. Alamat lokal seperti localhost atau IP privat tidak diterima. Untuk pengembangan
lokal gunakan layanan tunnel yang memberi URL HTTPS publik.
Masih butuh bantuan?
Jika pertanyaan Anda belum terjawab, masuk ke dashboard dan hubungi admin BGWA.
Sertakan id pesan dan waktu kejadian supaya pemeriksaan lebih cepat.