---
title: "Connecting WhatsApp"
description: "Connect a WhatsApp Business number to your agent through Meta, so customers can chat with your agent on WhatsApp."
---

:::note[Plan]
Available on the **Starter** plan and above.
:::

Connect a WhatsApp Business number and your agent answers customers who message it on WhatsApp. The connection uses Meta's secure sign-up window, so you sign in with Facebook and choose your business account there.

## Before you start

- A **Facebook account** with access to your business, or permission to create one.
- A phone number for WhatsApp. It can be a number already on the WhatsApp Business app, a number already on the WhatsApp Business Platform, or a new number.
- Pop-ups allowed for Chatvox in your browser, since Meta opens in a new window.

## Connect a number

1. **Open WhatsApp settings**

    In your agent, go to **Deploy** and select **WhatsApp**.

2. **Start the connection**

    Under **Connect WhatsApp**, choose how you want to connect:

    - **Keep using an existing WhatsApp Business App number**: connect the number you already use in the WhatsApp Business app.
    - **Connect an existing WhatsApp Business Platform account**: connect a number already set up on Meta's platform.
    - **Set up a new WhatsApp Business number**: register a new number.

3. **Finish in the Facebook window**

    Follow the steps in Meta's window: sign in, choose or create your business account, and verify your number. Chatvox continues automatically when you finish.

4. **Wait for activation**

    Chatvox verifies your number and turns on messaging. This can take a moment, so keep the page open.

When it's done, the **WhatsApp number** card shows your connected number.

## Use a number from another agent

WhatsApp numbers belong to your team. If your team already has a connected number, it's listed under **Existing Team WhatsApp numbers**. Select **Connect to this agent** to use it here.

## Connection status

If the card says **This connection needs attention**, open **Technical details** to see the message from Meta. Most issues are fixed by selecting **Reconnect WhatsApp** and completing the Facebook window again.

## Disconnect or move a number

- **Unassign from Agent**: removes the number from this agent but keeps it in your team, so you can connect it to another agent.
- **Disconnect account**: disconnects the WhatsApp account from Chatvox.

## Next steps

- [Configure WhatsApp instructions](/docs/deployments/whatsapp/configuration)
- [Sync message templates](/docs/deployments/whatsapp/message-templates)