> For the complete documentation index, see [llms.txt](https://docs.cuoral.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuoral.com/integration/whatsapp.md).

# WhatsApp

Connect your WhatsApp Business account to Cuoral.

Connect your WhatsApp Business account to Cuoral so your team can receive and reply to customer messages from the Cuoral dashboard.

### Prerequisites

Before you begin, ensure the following:

* You can access the Cuoral organization you want to connect.
* You have a Facebook account with permission to manage the relevant Meta business portfolio and WhatsApp Business account.
* You have a WhatsApp Business phone number, or can add one during setup.
* Your Cuoral wallet is funded. Your organization's configured WhatsApp billing policy applies to messages.

### Connect WhatsApp

#### 1. Open the integration

Go to **Settings → Configuration → Integrations → WhatsApp**.

Select **Connect with Facebook**.

#### 2. Sign in

Sign in with the Facebook account that manages the business.

Allow pop-ups for Cuoral if the sign-in window does not open.

#### 3. Choose the business assets

In the guided setup, select or create the correct business portfolio.

Then select or create the WhatsApp Business account and phone number.

Review and grant the requested WhatsApp account and messaging access.

Meta may ask you to verify a newly added or migrated number. Verification uses SMS or voice call.

#### 4. Complete the connection

Return to Cuoral after the guided setup finishes.

Cuoral will verify and activate the connection.

When the status shows **Active**, the selected business name and WhatsApp number appear under **Connection details**.

#### 5. Test messaging

Send a WhatsApp message to the connected number.

Confirm that it appears on the **Conversations** page.

Reply from Cuoral within the 24-hour customer service window.

Use an approved WhatsApp template when starting a conversation. Use one when messaging outside that window.

### Wallet and billing

Keep the wallet funded to avoid interrupted outbound delivery.

Charges follow the WhatsApp billing policy configured for the organization.

Meta template fees may apply separately from Cuoral's infrastructure messaging charge.

### Troubleshooting

* **Sign-in window does not open:** Allow pop-ups. Confirm `app.cuoral.com` is permitted by the browser.
* **No business or number appears:** Use a Facebook account with permission to manage those assets.
* **Number is connected elsewhere:** The number may require migration from the existing provider before direct activation.
* **Connection is pending:** Refresh the status after a short wait. Start a new connection attempt if it remains pending or fails. You can also contact Cuoral Support.
* **Incoming messages do not appear:** Confirm the connection status is **Active**. Check that you are testing the displayed WhatsApp number.
* **Replies fail:** Check the wallet balance. Check whether the 24-hour customer service window has closed.

Setup complete — your team can now manage WhatsApp conversations from Cuoral.