> For the complete documentation index, see [llms.txt](https://docs.watzap.id/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.watzap.id/help/waba-official/cara-connect-nomor-waba-official/cara-mengatasi-kendala-connect-whatsapp-business-api-and-coexistence.md).
# Cara Mengatasi Kendala Connect WhatsApp Business API & Coexistence
Arti pesan error saat menghubungkan nomor WABA Official (WhatsApp Business API & Coexistence) di WatZap, cara mengecek statusnya di Business Profile, dan solusi kendala di jendela Meta.
Proses connect nomor WABA Official berjalan di dua tempat: di **WatZap** (tombol **Connect Your Number** dan jendela syarat) dan di **jendela pop-up Meta** (login Facebook, pilih Business Portfolio, verifikasi nomor). Kalau prosesnya terhenti, WatZap menampilkan pesan yang menjelaskan penyebabnya.
Panduan ini membahas arti setiap pesan tersebut, cara mengecek status nomor setelah terhubung, dan kendala yang sering muncul di jendela Meta. Untuk langkah connect dari awal, lihat [Cara Connect Nomor WABA Official](/help/waba-official/cara-connect-nomor-waba-official.md).
## Sebelum mencoba lagi
1. **Pakai komputer atau laptop.** Proses connect tidak berjalan dari HP.
2. **Izinkan pop-up** dari WatZap di browser, dan matikan sementara ekstensi pemblokir iklan yang bisa memblokir Facebook.
3. **Paket WatZap sudah termasuk WABA Official.**
4. **Login Facebook** memakai akun yang menjadi admin Business Manager (Business Portfolio) Kamu.
5. **Siapkan metode pembayaran** di akun Meta. Lihat [Menyiapkan Metode Pembayaran](/help/waba-official/syarat-pakai-waba-official/menyiapkan-metode-pembayaran.md).
{% hint style="warning" %}
**Khusus Coexistence:** nomor WhatsApp Business harus sudah aktif lebih dari 3 bulan dan bebas blokir dalam 3 bulan terakhir. Kelayakan akhirnya ditentukan oleh Meta. Pastikan juga nomor itu tidak sedang terhubung sebagai nomor WhatsApp unofficial (scan QR) di WatZap.
{% endhint %}
## Ulangi proses connect
{% stepper %}
{% step %}
### Buka halaman WABA Integration
Di menu samping bagian **WABA OFFICIAL**, klik **Business Profile**. Selama nomor belum terhubung, menu ini membuka halaman **WABA Integration**. Klik **Connect Your Number** (1).
{% endstep %}
{% step %}
### Centang semua syarat, lalu klik Hubungkan Sekarang
1. Centang **ketiga syarat**.
2. Klik **Hubungkan Sekarang**. Tombol ini tetap abu-abu sampai ketiga syarat dicentang.
{% endstep %}
{% step %}
### Selesaikan langkah di jendela Meta, lalu tunggu
Ikuti langkah di jendela Meta sampai klik **Finish**. Setelah itu WatZap menampilkan **Menghubungkan akun...**. Jangan tutup atau refresh halaman. Kamu otomatis diarahkan ke **Business Profile**, tab **Connect Account**.
{% endstep %}
{% endstepper %}
## Arti pesan yang muncul di WatZap
| Pesan | Artinya | Yang perlu dilakukan |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **This action isn’t supported on mobile.** | Halaman dibuka dari HP atau layar sempit. Tombol **Connect Your Number** dikunci. | Buka WatZap dari komputer atau laptop. |
| Jendela **Paket WABA Official** | Paket Kamu belum termasuk WABA Official. | Klik **Aktifkan** untuk menuju halaman upgrade paket. |
| **Connecting to Facebook** / **Facebook SDK Not Ready** | Skrip Facebook belum selesai dimuat (lebih dari 8 detik) atau diblokir browser. | Tunggu sebentar, lalu klik **Hubungkan Sekarang** lagi. Matikan pemblokir iklan, atau coba browser lain. |
| **Connection Failed** | Jendela login Facebook gagal dibuka. | Refresh halaman, lalu ulangi. |
| **Login Cancelled** | Jendela Meta ditutup sebelum login selesai, atau login tidak valid. | Klik **Hubungkan Sekarang** lagi dan selesaikan login sampai akhir. |
| **Login Error** | Facebook mengembalikan error saat login. Pesan dari Facebook ditampilkan di bawah judul. | Baca pesannya, perbaiki (misalnya login ulang ke Facebook), lalu ulangi. |
| **Access Token Expired** | Sesi login Meta sudah habis. | Login ulang ke [Business Manager](https://business.facebook.com/), lalu ulangi dari **Hubungkan Sekarang**. |
| **Authorization Failed** | WatZap tidak menerima kode izin dari Facebook. | Ulangi, dan pastikan Kamu menyetujui semua izin yang diminta di jendela Meta. |
| **Setup Cancelled** (*Setup dibatalkan di step …*) | Kamu keluar dari jendela Meta di tengah proses. Nama langkah terakhir ikut ditampilkan. | Ulangi dan selesaikan semua langkah sampai **Finish**. |
| **Signup Error** | Meta menolak pendaftaran. Pesan dari Meta ditampilkan setelah kata *Error:*. | Perbaiki sesuai pesan Meta (lihat bagian [Kendala di jendela Meta](#kendala-di-jendela-meta)), lalu ulangi. |
| **Failed** (*Gagal: …*) atau **Error** (*Terjadi kesalahan: …*) | Data koneksi gagal diproses atau disimpan di WatZap. | Refresh halaman lalu ulangi. Kalau tetap gagal, kirim screenshot pesannya ke tim support WatZap. |
Contoh tampilan pesan:
{% hint style="info" %}
Kalau jendela Meta tidak muncul sama sekali dan ikon tombol **Hubungkan Sekarang** kembali normal setelah sekitar 15 detik, kemungkinan besar pop-up diblokir browser. Izinkan pop-up untuk WatZap, lalu klik lagi.
{% endhint %}
## Cek status nomor setelah terhubung
Buka **Business Profile**. Ikon di sebelah setiap tab (**Connect Account**, **Messaging Limit**, **Display Name**, **Quality Rating**) berwarna hijau bila normal, kuning bila masih diproses, dan merah bila ada masalah.
### Tab Connect Account
| Tampilan | Artinya |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Your account is connected 🎉** | Nomor terdaftar di Cloud API dan siap dipakai. |
| **Account Verification in Progress** | Nomor sudah masuk WhatsApp Business Account, tapi belum terdaftar di Cloud API sehingga belum bisa mengirim pesan. |
| **Your account is …** (kotak merah) | Ada kendala dari Meta, misalnya **Disconnected**, **Unverified**, **Flagged**, **Restricted**, atau **Banned**. Penjelasan dari Meta tampil di bawahnya. |
1. Ikon tab **Connect Account** berubah kuning.
2. Pesan **Account Verification in Progress**.
Kalau status ini tidak berubah setelah beberapa jam, buka lagi halaman **Business Profile** untuk memuat ulang status. Kalau tetap sama, hubungi tim support WatZap. Untuk status **Restricted**, **Flagged**, atau **Banned**, lihat [Cara Mengatasi Kendala WABA Terkena Restricted](/help/waba-official/cara-connect-nomor-waba-official/cara-mengatasi-kendala-waba-terkena-restricted.md).
### Tab Display Name
Nama tampilan (Display Name) harus disetujui Meta sebelum nomor bisa dipakai normal.
1. Klik tab **Display Name**.
2. Status nama tampilan: **Approved** atau **Available Without Review** berarti aman. **In Review** berarti masih ditinjau Meta. **Rejected** berarti ditolak. **Expired** berarti sertifikat kedaluwarsa.
3. Langkah mengajukan ulang nama tampilan lewat WhatsApp Manager.
## Kendala di jendela Meta
Status nomor "Pending" atau nama tampilan "In Review" terlalu lama
Meta sedang meninjau nama tampilan, dan sertifikat nomor belum terbit. Tunggu hingga 48 jam. Selama proses ini, jangan mengganti nama tampilan atau menghapus nomor, supaya antrean peninjauan tidak mulai dari awal.
Pastikan nama tampilan sama dengan nama merek di website Kamu, dan website bisa dibuka (bukan halaman "coming soon" atau "under construction"). Panduan resmi: [Display Name Guidelines](https://developers.facebook.com/documentation/business-messaging/whatsapp/display-names/).
Nama tampilan ditolak (Rejected)
Ajukan nama baru lewat WhatsApp Manager: buka [Meta Business Manager](https://business.facebook.com/) → **Business Settings** → **WhatsApp Accounts** → **WhatsApp Manager**, cari nomor Kamu, lalu edit dan kirim nama tampilan yang baru. Langkah ini juga tertulis di tab **Display Name** di WatZap.
Kode OTP tidak masuk (metode nomor baru)
Filter SMS operator bisa memblokir kode dari luar negeri. Di jendela Meta, pilih verifikasi lewat **panggilan suara** (voice call) bila SMS tidak kunjung masuk. Pastikan juga nomor bisa menerima SMS/telepon dan tidak sedang terpasang di aplikasi WhatsApp mana pun.
Nomor ditolak karena masih terdaftar di WhatsApp
Metode nomor baru (Non-Coexistence) hanya menerima nomor yang belum terdaftar di WhatsApp maupun WhatsApp Business. Hapus dulu akun WhatsApp dari nomor itu di HP, atau pakai metode **Coexistence** bila Kamu ingin tetap memakai aplikasi WhatsApp Business. Panduan resmi Coexistence: [Onboarding Business App Users](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/).
QR Code Coexistence tidak bisa dipindai atau nomor dinyatakan tidak memenuhi syarat
* Perbarui aplikasi WhatsApp Business di HP ke versi terbaru.
* Pastikan nomor sudah aktif lebih dari 3 bulan dan tidak pernah diblokir dalam 3 bulan terakhir.
* Pastikan nomor tidak sedang terhubung ke WatZap sebagai nomor WhatsApp unofficial (scan QR). Putuskan dulu dari menu **WhatsApp**.
Nomor sudah terhubung di Meta tapi belum bisa mengirim pesan
Nomor yang sudah diverifikasi masih harus didaftarkan ke Cloud API. WatZap mendaftarkannya otomatis setelah Kamu klik **Finish**. Kalau tab **Connect Account** tetap menampilkan **Account Verification in Progress**, hubungi tim support WatZap. Proses pendaftaran nomor menurut Meta: [Register Phone Number](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration/).
Ingin menghubungkan ulang nomor yang sudah pernah terhubung
Putuskan dulu koneksi lamanya, lalu hubungkan lagi. Lihat [Cara Reconnect Nomor WABA](/help/waba-official/cara-connect-nomor-waba-official/cara-reconnect-nomor-waba.md).
## Tampilan di HP
Kalau WatZap dibuka dari HP, halaman **WABA Integration** menampilkan:
1. Peringatan **This action isn’t supported on mobile.**
2. Tombol **Connect Your Number** yang terkunci.
Pindah ke komputer atau laptop untuk melanjutkan.