> For the complete documentation index, see [llms.txt](https://docs.cekat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cekat.ai/ai-and-platform/connected-platforms/whatsapp/common-issues-and-solutions.md).

# Common Issues & Solutions

### 1. Error Case: Phone Number Not Eligible to Onboard

<figure><img src="/files/nEBJPqEbn42SFYR50nUS" alt="" width="375"><figcaption></figcaption></figure>

### Kemungkinan 1: Akun sudah terhubung ke halaman Facebook Business

**1. Buka Business Facebook**

* Buka [business.facebook.com](https://business.facebook.com).

**2. Masuk ke Business Portfolio**

* Pilih "Cekat AI" lalu masuk ke bagian "Settings."

**3. Cek WhatsApp Account**

* Masuk ke bagian "WhatsApp Account."
* Jika tombol titik tiga untuk "Disconnect" tidak bisa diklik karena masih terhubung ke partner, lanjutkan ke langkah berikut.

**4. Hapus Koneksi dari Partner**

* Masuk ke bagian "Partner," lalu klik "Manage."
* Pilih "Remove Account."
* Pilih "Remove from Business Portfolio."

**5. Reconnect ke Cekat**

* Setelah itu, coba lakukan re-connect ke Cekat lagi.

### Kemungkinan 2: Akun sudah terhubung ke Facebook Page

**1. Buka Facebook Page**

* Buka halaman Facebook Page Anda, lalu masuk ke "Settings."
* Atau langsung ke [tautan ini](https://www.facebook.com/settings/?tab=linked_profiles).

**2. Periksa Koneksi WhatsApp**

* Pilih "WhatsApp."
* Jika ada "Connection Request Pending," klik tombol "Request Cancel."

**3. Hapus Nomor WhatsApp**

* Masukkan nomor telepon dan verifikasi ulang dengan OTP.
* Di bagian bawah "Your WhatsApp Number," klik tombol "Remove."

**4. Reconnect ke Cekat**

* Setelah itu, bisa dicoba ulang proses menghubungkan akun whatsapp business kamu ke Cekat lagi.

### **Solusi Alternatif:**&#x20;

Karena ini adalah fitur baru milik Meta, belum ada detail lebih lanjut mengenai jenis nomor yang tidak memenuhi syarat untuk menggunakan WhatsApp Coexistence. Gunakan nomor WhatsApp Business lain yang Anda miliki.

***

### 2. Error while pairing Cloud API

<figure><img src="/files/eJCrZuQjh4dUAw39KWgu" alt="" width="367"><figcaption></figcaption></figure>

**Pesan Error:**\
`Error while pairing Cloud API`

**Solusi:**\
Untuk mengatasi masalah ini:

* **Hapus aplikasi WhatsApp Business** di perangkat kamu
* **Pastikan data sudah dibackup terlebih dahulu**
* **Install ulang WhatsApp Business** lalu coba kembali proses pairing

***

### 3. Error: WhatsApp Business Account Already Connected to Another Business

<figure><img src="/files/TexnvlgDnkS1WCi2yhZk" alt="" width="563"><figcaption></figcaption></figure>

**Solution:**

Add the WhatsApp number to your Facebook Page:

* Go to **Facebook Page → Settings → Linked Accounts**.

  <figure><img src="/files/Wnophj1B4vIWexaQkelW" alt="" width="563"><figcaption></figcaption></figure>
* Connect the WhatsApp number to your page.

  <figure><img src="/files/LrRdZVkM62pKc2rU2jrH" alt="" width="563"><figcaption></figcaption></figure>

***

### **4. Permintaan Offboarding ke Others**

1. Langkah pertama adalah mengirim email resmi ke support Others untuk meminta pelepasan akun WABA (termasuk 2FA/PIN).\
   Berikut contoh email yang bisa digunakan:

***

**To:** <support@others.com>\
**Subject:** Request Offboarding WhatsApp Business API – \[Business name]

**Body Email:**

```
Yth. Tim Support Others,

Saya ingin mengajukan permintaan offboarding akun WhatsApp Business API kami. Berikut detail informasinya:

Nama Perusahaan     : XXXXXXX  
Nomor WhatsApp API  : +62XXXXXXX
Alasan              : Migrasi ke BSP lain  
Tanggal Request     : 18 Januari 2024  

Akun Admin  
Email    : xxxx@gmail.com
Password : xxxxxx

PIC Pengaju  
Nama     : Alexander 
Email    : xxxx@gmail.com

Mohon bantuannya untuk proses pelepasan 2FA. Terima kasih.
```

***

**2. Tunggu Konfirmasi dari Others**

Tim Others akan memproses permintaan offboarding dan melakukan pelepasan **2FA (Two-Factor Authentication)** dari sistem mereka.

> Tandanya berhasil: kamu sudah bisa mengakses Meta WhatsApp Manager dan menu 2FA-nya (lihat step selanjutnya).

***

**3. Matikan Two-Step Verification (2FA) dari Meta WhatsApp Manager**

<figure><img src="/files/wpUwBjhMRvejN2jfTV88" alt=""><figcaption></figcaption></figure>

Setelah 2FA dilepas oleh Others, masuk ke halaman WhatsApp Manager:

📍 business.facebook.com → Business Settings → WhatsApp Accounts → pilih nomor → **tab "Two-step verification"**

Lalu klik:

* 🔘 **Turn off two-step verification**
* Atau jika perlu, ubah PIN dengan klik **Change PIN**

***

### **5. Pesan Terkirim tapi Tidak Terdeliver**

Beberapa kondisi dapat menyebabkan pesan tampak sudah terkirim tetapi tidak sampai ke penerima. Dalam banyak kasus, Cekat dan Meta tidak akan mengungkapkan alasan spesifiknya karena alasan privacy dan policy platform.

<figure><img src="/files/rsktcjiHuBhLcDAVneuf" alt=""><figcaption></figcaption></figure>

Berikut beberapa kemungkinan penyebabnya:

* **Customer tidak online dalam 30 hari** : Meta hanya menyimpan pesan selama 30 hari untuk customer yang sedang offline. Jika customer tidak membuka WhatsApp dalam periode tersebut, pesan akan gagal terdeliver.
* **Nomor bisnis di-block oleh customer** : Customer mem-block nomor bisnis kamu, atau nomor bisnis lain yang dimiliki oleh bisnis yang sama.
* **Customer berada di negara yang di-restrict** : Customer berlokasi di negara yang di-restrict atau terkena sanksi oleh Meta.
* **Issue pada sistem Meta** : Di luar ketiga kondisi di atas, dalam kasus yang jarang terjadi pesan bisa stuck di status "sent" akibat gangguan internal di sisi Meta. Kondisi ini di luar kendali Cekat maupun pengguna.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cekat.ai/ai-and-platform/connected-platforms/whatsapp/common-issues-and-solutions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.