> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatflows.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your WhatsApp Business number

> Connect your WhatsApp Business number to ChatFlows through Meta's own pop-up window, keep the WhatsApp Business app on your phone, and check your number's health.

Your WhatsApp number is what your customers see. Connect it once, and ChatFlows can send your cart reminders, order updates and campaigns from it, and every reply lands in your **Inbox**.

Meta's own pop-up window walks you through it. Behind your number sits a WhatsApp Business Account (Meta calls it a **WABA**), which you create or pick in that window.

## Before you connect

> [!TIP]
>
> Make sure you have the following ready:
>
> * A Facebook account.
> * A **Meta Business account** — Business Verification is not mandatory to connect, but it is strongly recommended; without it your account stays on limited messaging tiers.
> * One mobile number for WhatsApp that must be either:
>   * **not connected to any WhatsApp account**, or
>   * **already connected to the WhatsApp Business App**
> * A **payment method** in Meta's WhatsApp Manager. Meta needs it to send your template messages. See [WhatsApp costs](https://docs.chatflows.io/billing/whatsapp-costs.md).
> * Your **WABA ID**, **Access Token**, **Meta App ID**, and **App Secret** (for manual connections only).

## Connecting WhatsApp

**1. Click Connect**

Go to **WhatsApp Setup**, click **Connect Channel**, choose **WhatsApp**, then click **Continue**.

![WhatsApp Setup page showing a Connect Channel button and a Supported channels panel listing WhatsApp and Messenger, both marked Available](https://docs.chatflows.io/core-setup/channels/img/channels-connect.png)

Image shows the WhatsApp Setup page with the Connect Channel button.

**2. Pick a connection method**

You'll see two tabs:

![Connect a WhatsApp Account sheet shown twice: the Embedded Signup tab with four setup steps, a Channel Name field and a Launch button, and the Manual tab with fields for channel name, Business Account ID, access token, Meta App ID, and App Secret](https://docs.chatflows.io/core-setup/channels/img/whatsapp-connect-methods.png)

Image shows the Connect a WhatsApp Account sheet with its Embedded Signup and Manual tabs.

* **Embedded Signup** — connect with Meta's secure sign-up window.
  * Enter a **Channel Name**, then click **Launch**.
  * Log in to your Facebook account.
  * Choose your Business Manager and WhatsApp number.
  * Grant the WhatsApp permissions.
    Your channel is created automatically when you finish.
* **Manual** — use this for advanced setups with existing WhatsApp Business API credentials.
  * Enter the **WABA ID**.
  * Paste the **Access Token**.
  * Provide the **Meta App ID** and **App Secret**.

**3. Confirm it's connected**

Once connected, the channel appears in your list on the **WhatsApp Setup** page with an **Active** status, and a webhook subscription is set up automatically so incoming messages reach your workspace.

![The WhatsApp Setup list showing a connected WhatsApp channel with an Active status, the Manual connection method, and the date connected](https://docs.chatflows.io/core-setup/channels/img/channels-list-connected.png)

Image shows the WhatsApp Setup list with a connected channel and its Active status.

## Coexistence mode

You can connect a WhatsApp number in **coexistence mode** — this keeps your existing WhatsApp Business app active on your phone alongside the API connection. Chat history and contacts from the app are imported, and messages stay in sync between the app and ChatFlows.

## WABA health

![WABA Health panel showing an overall Available status, with Waba, Business, and App each listed as Available alongside their IDs](https://docs.chatflows.io/core-setup/channels/img/waba-health.png)

Image shows the WABA Health panel.

Open a connected WhatsApp channel to view:

* **Quality rating**, review status, and business verification.
* **Conversation analytics** for the account.
* Per-number quality, if you have multiple phone numbers under the same WABA.

## Business Profile

![Phone number card showing the profile photo and number, a GREEN quality badge, messaging throughput and daily limit, and the business name, description, and location](https://docs.chatflows.io/core-setup/channels/img/business-profile.png)

Image shows the phone number and business profile card.

Open a connected channel and click **Edit profile** on its phone number card to edit the public WhatsApp Business Profile your contacts see: about text, address, description, email, websites, business vertical/category, and profile photo.

## Test message

![Send Test Message dialog with a Template picker showing an approved marketing template and a Recipient Phone Number field, opened from the Test button on an active channel](https://docs.chatflows.io/core-setup/channels/img/send-test-message.png)

Image shows the Send Test Message dialog with a template picker and recipient number field.

Use the **Test** button on a channel to confirm the connection actually works end-to-end before relying on it. You'll pick an approved **template** and a **recipient number** — so this needs at least one approved template on the account.

## Common problems

> [accordion] Meta's pop-up window doesn't open
>
> Your browser may be blocking pop-ups. Allow pop-ups for ChatFlows and click **Connect Channel** again.

> [accordion] The number is already registered on WhatsApp
>
> * **On the WhatsApp Business app?** That's fine. Connect it alongside the app (coexistence).
> * **On the personal WhatsApp app?** Delete that WhatsApp account on the phone first, or use another number.
> * **On another provider's WhatsApp API?** Ask that provider to release the number, then connect it here.

> [accordion] Templates don't send after connecting
>
> Check that your WhatsApp Business account has a payment method in Meta's WhatsApp Manager, and that the template shows **Approved**.
> The reason for a failed message shows in **Setup → WhatsApp Message Log**.

> [accordion] Messages stop at a daily limit
>
> New numbers start with a limit on how many customers they can message in a day. Meta raises it as you send good-quality messages, and after business verification.
> This is a WhatsApp rule, not a ChatFlows one. Meta explains it under [messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits).

For other problems, see [Troubleshooting](https://docs.chatflows.io/getting-started/troubleshooting.md).

## Common questions

> [accordion] Will I lose my WhatsApp Business app chats if I connect to ChatFlows?
>
> No. If your number is on the WhatsApp Business app, connect it in coexistence mode and the app keeps working on your phone.
> ChatFlows imports your chat history and contacts, and messages stay in sync between the app and your Inbox.

> [accordion] Can I connect my personal WhatsApp number to ChatFlows?
>
> Not while it is on the personal WhatsApp app. Delete that WhatsApp account on the phone first, or use another number.
> A number already on the WhatsApp Business app can connect as it is.

> [accordion] Do I need Meta Business Verification to connect WhatsApp?
>
> No. Business Verification is not required to connect, but Meta strongly recommends it.
> Without it your number stays on limited messaging tiers, which Meta explains under [messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits).

> [accordion] Can I connect Instagram as well as WhatsApp?
>
> No. ChatFlows works with WhatsApp and Messenger, and Instagram isn't available.
> To add a Facebook Page, see [Connecting Messenger](https://docs.chatflows.io/core-setup/channels/messenger.md).

## What's next

> [card] [Connecting Messenger](https://docs.chatflows.io/core-setup/channels/messenger.md)
>
> Connect a Facebook Page the same way.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.