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

# Connect your WhatsApp Business Account

> Connect your WhatsApp Business Account (WABA) to Uservox so you can create templates and send WhatsApp messages from your own number.

## Overview

To send WhatsApp templates from your own number, connect your **WhatsApp Business Account (WABA)** to Uservox. You do this once per project, in a few minutes, through a short Meta window.

Until a WABA is connected, the **WhatsApp** page shows the onboarding screen below.

![Connect WhatsApp onboarding page](https://mintcdn.com/uservox/qfIbUoc4a0UqKRwq/images/whatsapp/connect-onboarding-page.png?fit=max\&auto=format\&n=qfIbUoc4a0UqKRwq\&q=85\&s=c5188814363d12e5f52b3ef588f5d962)

***

## Before you start

Keep these ready:

* **A Facebook account** with admin access to your business on Meta (your business portfolio).
* **A phone number for WhatsApp** that can receive an SMS or a call for verification. It must **not** be in use on the WhatsApp or WhatsApp Business app.
* **Billing in INR.** If you create a new WhatsApp Business Account during signup, choose **INR** as its currency. Accounts in other currencies can't be connected.
* **A display name** that follows [WhatsApp's display name guidelines](https://www.facebook.com/business/help/757569725593362), usually your business or brand name.

> [!NOTE]
>
> Only a **project admin** can connect WhatsApp. Other members see a message asking them to contact an admin.

***

## Connect your account

1. Open [**WhatsApp**](https://app.uservox.ai/whatsapp) from the left menu.
2. Click **Connect WhatsApp**. A Meta window opens.
3. Follow the steps in the Meta window (below).
4. When you click **Confirm** in the last step, the window closes and Uservox starts setting up your number.

### Step 1: Start

Meta explains what you are connecting. Click **Continue**.

![Meta window: connect your account to Uservox](https://mintcdn.com/uservox/qfIbUoc4a0UqKRwq/images/whatsapp/connect-meta-1-intro.png?fit=max\&auto=format\&n=qfIbUoc4a0UqKRwq\&q=85\&s=a12720839c510e47095d333d4ce94d0b)

### Step 2: Add your WhatsApp phone number

Choose the number you want customers to see, then choose how to verify it: **Text message** or **Phone call**. Enter the code Meta sends you.

![Meta window: add your WhatsApp phone number](https://mintcdn.com/uservox/qfIbUoc4a0UqKRwq/images/whatsapp/connect-meta-2-phone-number.png?fit=max\&auto=format\&n=qfIbUoc4a0UqKRwq\&q=85\&s=265e3b5c429c6c9eadb916f48c4cf0ae)

### Step 3: Choose your business assets

Select your **Business portfolio** and **WhatsApp account**, or create new ones.

![Meta window: select the business assets to share with Uservox](https://mintcdn.com/uservox/qfIbUoc4a0UqKRwq/images/whatsapp/connect-meta-3-business-assets.png?fit=max\&auto=format\&n=qfIbUoc4a0UqKRwq\&q=85\&s=cebcbe7356936349f5c26627bbf3776e)

### Step 4: Set your display name

Enter the name customers will see on your messages. A green tick means it meets WhatsApp's guidelines.

![Meta window: WhatsApp Business display name](https://mintcdn.com/uservox/qfIbUoc4a0UqKRwq/images/whatsapp/connect-meta-4-display-name.png?fit=max\&auto=format\&n=qfIbUoc4a0UqKRwq\&q=85\&s=f9d036e8519ef666e95d81e5e259045f)

### Step 5: Review and confirm

Meta lists the access Uservox needs to send and receive WhatsApp messages for your business. Click **Confirm**.

![Meta window: review what you'll share with Uservox](https://mintcdn.com/uservox/qfIbUoc4a0UqKRwq/images/whatsapp/connect-meta-5-review.png?fit=max\&auto=format\&n=qfIbUoc4a0UqKRwq\&q=85\&s=8d66322a85ba04315e27c37ac1897b72)

***

## After you confirm

Uservox registers your number. This usually takes a few minutes, and the page updates on its own, so you can leave it open or come back later.

![WhatsApp number being set up](https://mintcdn.com/uservox/qfIbUoc4a0UqKRwq/images/whatsapp/connect-setting-up.png?fit=max\&auto=format\&n=qfIbUoc4a0UqKRwq\&q=85\&s=c525b1343eabd821a7870e17f748306e)

When the last step shows **Live**, your number is connected. The **WhatsApp** page then opens your conversations, and you can [create your first template](https://docs.uservox.ai/whatsapp/create-template.md).

### If setup fails

If something goes wrong, the page shows **Setup failed** with the reason, for example a number that is already registered on another WhatsApp Business Account. Fix the cause and click **Retry WhatsApp signup**.

![WhatsApp setup failed](https://mintcdn.com/uservox/qfIbUoc4a0UqKRwq/images/whatsapp/connect-failed.png?fit=max\&auto=format\&n=qfIbUoc4a0UqKRwq\&q=85\&s=5b772a4c116eeb4f9298c81948cfcfd2)

Common reasons:

| Message | What to do |
| :- | :- |
| Billed in a currency other than INR | Run signup again and create a new WhatsApp Business Account in **INR**. |
| Already connected to another project | That account is linked to another Uservox project. Use a different account or ask your Uservox contact. |
| Account was not shared | In the Meta window, select a WhatsApp Business Account in step 3, then confirm. |
| Signup session expired | Run signup again and finish it without long pauses. |

***

## Already sending WhatsApp through another provider?

If your processes already send WhatsApp through another provider, your **WhatsApp** page keeps showing your conversations as before. You can still connect your own WhatsApp Business Account at any time from **WhatsApp → Settings**.


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