Appearance
Error WhatsApp Business API
Halaman ini menjelaskan error yang umum terjadi saat berinteraksi dengan WhatsApp Business API melalui TESHA, dan apa yang bisa Anda lakukan dari sisi platform.
Error saat onboarding dan koneksi
| Error | Penyebab | Tindakan |
|---|---|---|
| WABA ID tidak valid | ID yang dimasukkan tidak terdaftar di Meta Business Manager | Verifikasi WABA ID di Meta Business Settings |
| Token tidak memiliki akses | System User tidak memiliki permission yang cukup atau tidak di-assign ke WABA | Pastikan token memiliki whatsapp_business_management dan whatsapp_business_messaging, serta System User memiliki akses ke WABA |
| Nomor sudah terdaftar | Phone Number ID sudah aktif di WABA lain | Gunakan nomor yang berbeda atau lepaskan nomor dari WABA lama |
| PIN salah | PIN 6 digit yang dimasukkan tidak sesuai | Dapatkan PIN yang benar dari Meta Business Settings |
| Code expired (Embedded Signup) | Kode otorisasi dari Meta sudah tidak valid | Ulangi proses Embedded Signup dari awal |
Error saat kirim pesan
| Error | Penyebab | Tindakan |
|---|---|---|
| Template tidak ditemukan | Template yang digunakan belum disetujui atau nama template salah | Cek Message Template dan pastikan template aktif |
| Parameter template tidak valid | Variabel placeholder di template tidak diisi dengan benar | Periksa payload dan pastikan semua parameter yang diperlukan tersedia |
| Jendela 24 jam tertutup | Pesan non-template dikirim ke pelanggan yang tidak berinteraksi dalam 24 jam terakhir | Gunakan template pesan yang sudah disetujui untuk memulai percakapan baru |
| Nomor pelanggan tidak valid | Nomor WhatsApp pelanggan tidak aktif atau tidak valid | Verifikasi nomor pelanggan di database |
| Rate limit | Terlalu banyak request dalam waktu singkat | Kurangi frekuensi pengiriman atau tunggu beberapa saat |
Error saat menerima pesan
| Error | Penyebab | Tindakan |
|---|---|---|
| Webhook verification failed | Verify token yang dikonfigurasi di TESHA tidak cocok dengan Meta | Cek konfigurasi webhook verify token |
| Signature tidak valid | Payload webhook dimodifikasi atau bukan berasal dari Meta | Pastikan SSL/TLS aktif dan tidak ada proxy yang memodifikasi payload |
| Media download gagal | URL media dari Meta sudah expired atau file terlalu besar | TESHA akan mencoba ulang otomatis; jika tetap gagal, file mungkin tidak tersedia |
Status pesan yang perlu diperhatikan
| Status | Arti | Apakah normal? |
|---|---|---|
| sent | Pesan sudah diterima server Meta | Ya — tahap awal |
| delivered | Pesan sampai ke perangkat pelanggan | Ya — biasanya terjadi dalam beberapa detik |
| read | Pelanggan membuka pesan | Ya — tergantung kapan pelanggan membuka WhatsApp |
| failed | Pesan tidak berhasil diproses | Tidak — cek log untuk detail error |
| deleted | Pesan dihapus oleh pelanggan | Ya — pelanggan memilih untuk menghapus pesan |
Kapan harus menghubungi tim internal?
Hubungi tim teknis internal jika:
- Error berulang meski semua langkah di atas sudah benar.
- Akun WhatsApp berstatus aktif di TESHA tetapi semua pesan gagal.
- Ada perubahan kebijakan dari Meta yang berdampak pada seluruh akun.
- Error muncul setelah update atau perubahan di sistem dealer (NMS/SIMANDE).
Halaman terkait
- Masalah Umum — Kasus umum dan investigasi dasar.
- FAQ — Pertanyaan yang sering ditanyakan.
- Message Log — Melacak status dan error per pesan.