> For the complete documentation index, see [llms.txt](https://help.3sigmacrm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.3sigmacrm.com/whatsapp-business-api/waba-api-onboarding.md).

# WABA API onboarding

This guide shows how to connect your WhatsApp number to 3Sigma CRM through the official **WhatsApp Business API (WABA)**, add more numbers, and give your team access.

## Before You Begin

✅ **3Sigma Ultimate Plan**: the WhatsApp Business API needs the Ultimate plan or above.

✅ **Super Admin access**: only a Super Admin can see the **WhatsApp API** page in 3Sigma.

✅ **Phone Number**: either the number you already use on the **WhatsApp Business app**, or a fresh number that isn't on WhatsApp. Keep the phone handy for the OTP.

✅ **Facebook Business Manager**: access to your business's Facebook Business Manager.

✅ **Website & GST**: a working website and a valid GST number are needed for approval.

✅ **Migrating from another provider?** Turn off two-factor authentication (2FA) on the number before you start.

> **Prefer we set it up for you?** From the setup screen, click **Inquire on WhatsApp**. We offer assisted onboarding (₹2,000 one-time) and a full WhatsApp API + automation setup (₹5,000 one-time).

***

## Keep Using the WhatsApp Business App (Coexistence) 📱

You **don't** have to delete WhatsApp from your phone. When you connect, Meta lets you link the same number you already use on the **WhatsApp Business app**. You keep using the app on your phone, and on top of that you can:

* Receive every chat in the 3Sigma Inbox
* Run automations on incoming messages
* Build chatbots that auto-reply

During signup, Meta's window asks whether to connect your existing WhatsApp Business app number or a new number. Choose the option that fits you.

***

## Step-by-Step Setup

Go to **WhatsApp API** in the Admin section of the left menu. If WhatsApp isn't connected yet, you'll also see the setup screen when you open **Inbox** or **Templates**.

### Step 1: Connect WhatsApp API

Click **Connect WhatsApp**. A Meta window opens and walks you through the signup. It takes under 5 minutes.

1. **Log in with Facebook** and choose your Business Manager.

![](https://1560893721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ewU7Gm5ran9BpDzLUos%2Fuploads%2Fgit-blob-51341dfbfa6273a0ee8fbdaf60c62bf5d6175cb4%2Fimage%20\(9\).png?alt=media)

![](https://1560893721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ewU7Gm5ran9BpDzLUos%2Fuploads%2Fgit-blob-b23387209dbb2f04becfb0042d00d92082970961%2FWhatsApp%20Image%202024-10-04%20at%2023.35.53.jpeg?alt=media)

2. **Allow the permissions** so 3Sigma can manage your WhatsApp Business account.

![](https://1560893721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ewU7Gm5ran9BpDzLUos%2Fuploads%2Fgit-blob-f75216fdab083b875bc58391f25c1a36c45404df%2FWhatsApp%20Image%202024-10-04%20at%2023.35.53%20\(1\).jpeg?alt=media)

3. **Fill in your business details.** These are used to create your WhatsApp Business Account.

![](https://1560893721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ewU7Gm5ran9BpDzLUos%2Fuploads%2Fgit-blob-f068a7cf6375cba46aafaf1068401ed8521d2a0c%2FWhatsApp%20Image%202024-10-04%20at%2023.36.01%20\(1\).jpeg?alt=media)

4. **Set up your WhatsApp Business profile.** This is what customers see.

![](https://1560893721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ewU7Gm5ran9BpDzLUos%2Fuploads%2Fgit-blob-8f7db578ffb5bf4aa5c56d45e9775297a3cc234b%2FWhatsApp%20Image%202024-10-04%20at%2023.36.23.jpeg?alt=media)

<figure><img src="https://1560893721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ewU7Gm5ran9BpDzLUos%2Fuploads%2Fgit-blob-0e7c87759d6de5edf6ea61be9c651cd16f04030f%2FWhatsApp%20Image%202024-10-04%20at%2023.36.40.jpeg?alt=media" alt=""><figcaption></figcaption></figure>

5. **Choose your number**: link your existing WhatsApp Business app number, or add a new one and verify it with the OTP.

![](https://1560893721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ewU7Gm5ran9BpDzLUos%2Fuploads%2Fgit-blob-2e4b5420c3d16eb0861e8e462211361db427fb9e%2FWhatsApp%20Image%202024-10-04%20at%2023.36.49.jpeg?alt=media)

When it's done you'll see **"Connected successfully! You can now send messages."**

If it says **"Taking longer than expected"**, click **Check Status**. Your account may already be connected. Otherwise click **Cancel & Retry**.

### Step 2: Add Payment Method

Meta needs a payment method before you can send messages beyond the free testing tier. Click **Open Meta Business Manager** and add a card.

### Step 3: Verify Your Business

Verification lets your brand name show instead of a phone number and unlocks higher messaging limits. You'll need your legal business name and documents (GST / MOA) and a working website. Click **Verify in Meta**.

Click **Done — Go to my WhatsApp Profile** when finished.

> It can take a few minutes for Meta to finish setting up your profile. If you see **"WhatsApp Business is connecting"**, click **Refresh Profile** after a minute.

***

## Your WhatsApp API Profile 📊

The **WhatsApp Business API Profile** page shows how your number is doing:

* **Messaging status**: Available, Limited or Blocked, with a list of **Issues to resolve** if anything needs fixing
* **Message Limit**: how many new chats you can start per day
* **Quality Score**: Green, Yellow or Red. Red means the account is at risk of being banned.
* **Verified Name** and **Name Status**
* **Business profile**: edit your Category, Email, Website, Address, Description and profile picture, then click **Save Changes**

If a number shows **"can't send messages"** or **"needs attention"**, follow the button shown, such as **Register number** or **Reconnect WhatsApp**, then click **Check again**.

***

## Adding More Numbers ➕

You can connect several WhatsApp numbers to one 3Sigma account.

1. On the WhatsApp API page, click **Add Number**, then **Continue**.
2. Complete the same Meta signup for the new number.
3. With more than one number, use the number picker at the top of the page to switch between them.

**Where you pick the number:**

* **Templates**: each template belongs to one number
* **Campaigns**: choose **Send from**. Each number has its own daily limit.
* **Automations**: choose which number the rule sends from
* **Inbox**: filter by number. Replies go out from the number the customer chatted with.

***

## Giving Teammates Access to a Number 👥

Click **Manage Access** to open **Share WhatsApp Number**. Tick the teammates who should have access and click **Save**. Access lets them:

* Read this number's inbox
* Reply and send messages
* Use the number in campaigns
* Work leads on this number

You can remove access anytime. Removing someone stops new conversations from going to them, but doesn't delete past chats.

***

## Removing a Number

Super Admins can remove a number from the **Danger Zone** section by clicking **Deregister WhatsApp Business API**. Only the selected number is removed, and its scheduled messages are cancelled. If it was the last number on its WhatsApp account, its templates go back to draft and must be approved again.

***

**Need help?** Click **Need Help?** on the setup screen, or reach out to support via **"More > Help & support"** in the app.
