Troubleshooting
Masalah Setup Meta
Halaman ini membantu menentukan apakah masalah ada di sisi Meta atau di sisi tumbuh.ai. Untuk langkah persiapan, lihat Persiapan Meta Business dan Manual Login: siapkan di Meta.
Kode error pengiriman pesan ada di Error WhatsApp. Masalah koneksi umum ada di Masalah Koneksi Channel.
Saat menyambungkan (Manual Login)
Semua kegagalan pemeriksaan token dan WABA di tumbuh.ai tampil sebagai satu pesan galat INVALID_TOKEN. Isi pesannya diteruskan dari Meta, jadi bacalah teksnya.
| Yang Anda lihat | Kemungkinan penyebab | Perbaikan |
|---|---|---|
Pesan Meta tentang token tidak valid atau kedaluwarsa (kode Meta 190) | Token salah salin, sudah kedaluwarsa, atau dicabut | Buat token baru di System User, periksa di Access Token Debugger, lalu coba lagi |
Pesan Meta tentang izin (kode Meta 200 atau 10) | System User belum diberi akses Full control ke WABA, atau izin token kurang | Ulangi Add Assets untuk app dan WABA, lalu buat token dengan semua izin yang disebut di langkah 3 |
Pesan Meta tentang parameter (kode Meta 100) | WABA ID salah, misalnya yang diisi adalah Phone Number ID atau App ID | Ambil WABA ID dari Meta Business Suite, bagian WhatsApp Accounts |
| "Invalid access token or WABA ID" | Gabungan penyebab di atas | Jalankan dua perintah uji di langkah 4. Perbaiki sampai keduanya berhasil |
WABA_ALREADY_CONNECTED | WABA itu sudah dipakai akun tumbuh.ai lain | Putuskan dari akun lama, atau hubungi support bila Anda tidak mengenali akun itu |
| Berhasil, tetapi daftar nomor kosong | WABA valid tetapi belum punya nomor | Tambahkan dan daftarkan nomor di Meta (langkah 2) |
Saat mengatur webhook di Meta
| Yang Anda lihat | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Verify and Save gagal | Verify Token tidak sama persis, atau Callback URL salah ketik | Buka Webhook Info di kartu perangkat dan salin ulang keduanya. Bila Anda menekan Regenerate Token atau menghubungkan ulang, pakai Verify Token yang baru |
| Verify and Save berhasil, tetapi pesan tidak masuk | Field messages belum berlangganan | Berlangganan field messages di WhatsApp > Configuration |
| Pesan tetap tidak masuk | WABA belum berlangganan ke app Anda | Jalankan subscribed_apps (langkah 7). tumbuh.ai juga mencobanya otomatis sekitar satu jam setelah koneksi |
| Pesan tetap tidak masuk | Meta app masih berstatus Development | Ubah app ke Live setelah webhook terverifikasi |
| Pesan tetap tidak masuk | Nomor belum CONNECTED di Cloud API | Daftarkan nomor dengan PIN (langkah 2) |
| Pesan masuk berhenti setelah beberapa waktu | Token kedaluwarsa atau dicabut | Buat token baru, lalu hubungkan ulang WABA yang sama di tab Manual Login |
Nomor dan akun
| Yang Anda lihat | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Nomor tidak bisa ditambahkan karena sudah terdaftar | Nomor masih aktif di aplikasi WhatsApp biasa | Hapus akun WhatsApp pada nomor itu. Bila nomor dipakai di WhatsApp Business App dan ingin dipakai bersamaan dengan API, minta bantuan tim tumbuh.ai |
| Nomor sebelumnya diblokir | Pembatasan dari WhatsApp | Ajukan banding di Meta |
Error 133010 | Nomor belum terdaftar di platform | Panggil register dengan PIN (langkah 2) |
Error 133016 | Terlalu sering register atau deregister (batas 10 kali per 72 jam) | Tunggu sampai blokir selesai |
| Display name ditolak atau menunggu | Nama tidak sesuai pedoman Meta | Ajukan nama yang berkaitan dengan bisnis Anda di WhatsApp Manager |
Error 131031 atau 368 | Akun dibatasi atau dinonaktifkan karena pelanggaran kebijakan, atau data tidak cocok seperti PIN verifikasi dua langkah | Periksa status akun di WhatsApp Manager dan ajukan banding |
Pembayaran
Error 131042 berarti ada masalah pembayaran di akun WhatsApp Business Anda di Meta: metode pembayaran belum ada atau tidak aktif, atau akun ditangguhkan. Perbaiki di Meta Business Suite atau WhatsApp Manager. tumbuh.ai tidak menagih biaya pesan Meta.
Template
| Yang Anda lihat | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Status template tidak berubah setelah disetujui Meta | Status diperbarui saat sinkronisasi | Klik Sync from Meta di halaman Template |
| Template ditolak | Kategori tidak sesuai, variabel di awal atau akhir teks, atau melanggar kebijakan | Baca alasan penolakan, perbaiki, lalu kirim ulang |
| Gagal membuat template karena batas | Batas jumlah template di WABA tercapai | Hapus template yang tidak dipakai. Batas lebih tinggi tersedia untuk bisnis yang sudah terverifikasi |
Instagram dan Messenger
| Yang Anda lihat | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Instagram tidak mau tersambung | Akun bukan Professional, atau pop-up diblokir | Ubah akun ke Business atau Creator di Instagram, izinkan pop-up, lalu coba lagi |
| Halaman Facebook tidak muncul di daftar | Anda bukan admin Halaman tersebut | Minta admin Halaman memberi Anda peran admin |
| Muncul Needs Reauth atau Reconnect | Token akses habis atau izin dicabut | Klik tombol hubungkan ulang dan setujui semua izin |
| Meta menolak login atau izin tertentu padahal syarat terpenuhi | Konfigurasi atau persetujuan izin di Meta app platform | Hubungi tim tumbuh.ai dengan nama akun dan waktu kejadian |
| Komentar tidak muncul | Izin komentar native membutuhkan persetujuan Meta di tingkat platform | Hubungi tim tumbuh.ai. Alternatifnya, pakai Komentar via Repliz |
Bila masih buntu
Kumpulkan hal berikut sebelum menghubungi Kontak Support:
- Jalur yang dipakai (Embedded Signup, Manual Login, Instagram, atau Messenger).
- Pesan galat yang tampil, lengkap dengan kode Meta bila ada.
- Hasil dua perintah uji di langkah 4 (tanpa menyertakan token).
- Waktu kejadian.
Jangan pernah mengirim access token atau App Secret lewat chat atau email.
Last modified on