Skip to main content

Overview

Connect your NEW WhatsApp number to Chakra Chat.

Type of WhatsApp Connection

  1. Connecting a NEW Phone Number to WhatsApp API
  2. Connecting an Existing WhatsApp Business app Number (WhatsApp Coexistence)
  3. Migrating an Existing WhatsApp Business API Number

Connect NEW Number to WhatsApp​

** Prerequisites**

  • A Phone Number (unlinked to WhatsApp Messenger/WhatsApp Business app/WhatsApp API)
  • Facebook Business Manager access

Steps to Connect a New Number to WhatsApp Business Platform (API)

Go to 👉 Chakra Chat Dashboard

1. Connect WhatsApp Number​

Go to Quick Start or navigate to *WhatsApp Setup, click on Connect with Facebook. This opens the Embedded Signup (ES) widget.

Connect WhatsApp Number Facebook

2. Grant Permissions​

In the Embedded Signup flow, click Get Started to share permissions with ChakraHQ.

Grant Permissions

3. Select Business Portfolio​

Create OR Select a Business Portfolio

Select Business Portfolio

4. Select WhatsApp Business Account​

Choose an appropriate option to move forward:

Select Business Account

Choose OPTION 1 to Create a WhatsApp Business account OR OPTION 3 (Choose an Existing WhatsApp Business Account)​

5. Add your WhatsApp phone number​

  • In the the Add your WhatsApp Phone Number section choose Add a New Number, Verify and continue with the setup
Add your WhatsApp phone number

6. Add your WhatsApp Number​

Choose your WhatsApp Number type using the 2 options. Use your New Number or a display name provided by WhatsApp Free of Charge.

Add WhatsApp Number

Add a New Number​

Add New Number

Use a Display Name Only​

WhatsApp Provides a Virtual Number +1 555 series which is Display FREE of cost. This can be used for small volume use cases and testing purposes.

Add Display Number

7. Verify Phone Number​

Confirm the number using the Call or Text verification option.

Verify Phone Number

8. Review Access Request​

Check the access request details in the Embedded Signup flow.

Review Access Request

9. Setup COMPLETE​

Your WhatsApp Business account is now connected. Return to the Chakra Dashboard to Verify the Connection.

Setup Complete

10. Verify Connection​

Return to the WhatsApp Setup section in the left-side navigation in Chakra Chat, where your connected WhatsApp number will be displayed.

Verify Connection

Connect WhatsApp Coexistence​

  • ⚠️ Currently Meta supports only a one-time registration of the WhatsApp Business Number using Coexistence. Disconnection and Re-connection with same or different BSP is NOT supported as of now
  • ⚠️ For Coexistence (WhatsApp Business app + API) connected numbers display names are not auto approved as of now. Meta currently doesn't support display names for Coexistence except for Meta verified WhatsApp Business app accounts.

Prerequisites

  • A WhatsApp Business number
  • An Active WhatsApp Business app
  • Facebook Business Manager access

Step to Connect an existing WhatsApp Business app number

1. Connect WhatsApp Number​

Go to Quick Start or navigate to *WhatsApp Setup, click on Connect with Facebook. This opens the Embedded Signup (ES) widget.

Connect WhatsApp Number Facebook

2. Grant Permissions​

In the Embedded Signup flow, click Get Started to share permissions with ChakraHQ.

Grant Permissions

3. Select Business Portfolio​

Create OR Select a Business Portfolio

Select Business Portfolio

4. Select WhatsApp Business Account​

Choose an appropriate option to move forward:

Select Business Account

Choose the Connect a WhatsApp Business app OPTION 2​

5. Input WhatsApp Business Number​

Enter your WhatsApp Business phone number.

WhatsApp Business Number

6. Confirm/Edit WhatsApp Business​

Confirm or update your WhatsApp Business Account details as needed.

Verify or Edit Account

7. Review Access Request​

Check the access request details in the Embedded Signup flow.

Review Access Request

8. Verify Phone Number​

Confirm the number using the Call or Text verification option.

Share Contact and Chats

Open your WhatsApp Business App now

9. Scan QR Code​

Open your WhatsApp Business app, where you would've received a message. Click on Scan QR Code to proceed.

Scan QR Code

10. Connect to Business Platform​

Follow the prompts to connect your account to the Business Platform. Share the Chat history as required.

Connect to the Business Platform

11. Scan to Complete Connection​

Scan the QR code in Chakra Chat setup using the business app's Scan QR Code option.

Share Chat History

12. Connected to Chakra Chat​

You're connected

Migrate a WhatsApp API number​

** WhatsApp Business Number (using Coexistence) don't have migration support currently from Meta.**​

An WhatsApp Business number already connected with WhatsApp Business API (using coexistence) with another BSP cannot be migrated with Chakra as of now. The migration for Coexistence numbers is expected in early 2026

Before starting the signup process in Chakra Chat, ensure two-factor authentication (2FA) is disabled in your existing WhatsApp Business Account.

Disable 2-step-authentication​

Option 1: Request your current WhatsApp Solution Provider (BSP) to disable this.

Option 2: Disable the Two-factor authentication (2FA) directly in your WhatsApp Business Manager:

1. Go to WhatsApp Manager​

Go to 👉 WhatsApp Manager in Facebook Business

2. 2-Step-Verification​

Select the relevant phone number and navigate to the Two-step verification tab

Select Phone Number

3. Turn-off 2-step-verification​

Click on turn-off-two-step verification

Turn-Off 2FA

4. Continue with WhatsApp API setup​

Once the 2FA is disabled in the existing WhatsApp Business Account, continue with the setup process for connecting a NEW WhatsApp Number.

** End: Your WhatsApp Number is now connected with Chakra Chat. You can start receiving Inbound Messages now.**