# Onboarding on WhatsApp Business

### Prerequisites for Onboarding to WhatsApp Business API with Mercuri

Before integrating WhatsApp Business API with Mercuri CX , ensure you have the following requirements ready. This will streamline the onboarding process and help you quickly activate your WhatsApp Business account.

* **Facebook Business Manager Account:** Must be verified. [Verify here](https://business.facebook.com/settings)​
* **Phone Number:** During WhatsApp Business onboarding on Mercuri CX, you’ll need to provide a phone number , this can either be a standalone number or one that’s already associated with a WhatsApp Business account
* **Payment Profile:** Have a **credit card** ready and your **business information** (e.g., **GST Number**) to complete the payment setup.

***

### Onboarding Process

**Step 1: Start the WhatsApp Business Onboarding**

1. From the Mercuri CX dashboard, go to **Settings** and select **Channels**.
2. Click the **Onboard WhatsApp channel** button to begin the onboarding process.
3. You will be redirected to **Meta's Embedded Signup flow** (powered by Facebook).

**Step 2: Create or Link Your WhatsApp Business Account**

1. **Log in with Facebook:**

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FLdQxbtgeDcOy7I1ebsYC%2FMercuri%20screen%20shot%20edits.png?alt=media&#x26;token=fd513571-5d25-41c3-be65-b5f63e36db2f" alt=""><figcaption><p>Log in with Facebook</p></figcaption></figure>

* Sign in using your Facebook credentials. Ensure you log into the account that manages your business on Meta.

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FxMuqH2OXuWuYe2R1Z18M%2Fconnection%201.png?alt=media&#x26;token=de436e4e-3310-4a44-9aff-d9f2284c42a9" alt="" width="278"><figcaption></figcaption></figure>

1. **Create or Link Your Business Manager:**
   * If you already have a Business Manager account, select it from the list.
   * If you don’t have one, click **Create New Business** and follow the on-screen instructions.

***

**Step 3:Fill in your business information**

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FPsBU19FxzBd1lB5EYuTg%2F464108786_525408773457989_4187761113109762850_n.png?alt=media&#x26;token=d1e1c99f-b9a4-4d06-a1a2-88836c4731ce" alt=""><figcaption></figcaption></figure>

1. Enter your business details, including:
   * Business Name
   * Business Address
   * Industry Category
2. Follow Meta’s prompts to complete the business verification process.\
   \&#xNAN;*(Note: Business verification is required to activate WhatsApp Business API.)*

***

**Step 4: Connect your existing WhatsApp Business App or add a new phone number**

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FabCiXVwDDBAUfJwrlFV5%2Fimage.png?alt=media&#x26;token=2679b57f-71a2-41fe-863e-06bec9057fab" alt=""><figcaption></figcaption></figure>

***There are two ways to onboard to the WhatsApp Business API:***

<details>

<summary><strong>A. Connect your Existing WhatsApp Business App</strong></summary>

{% hint style="info" %}
**⚠️ Not Supported in These Countries**

Currently, this flow **won’t work** if your WhatsApp Business number has a country code from:

* **Australia, Japan, Nigeria, Philippines, Russia, South Korea, South Africa, Turkey**
* Any country in the **European Union (EU)**, **European Economic Area (EEA)**, or the **United Kingdom (UK)**
  {% endhint %}

Many businesses already use the **WhatsApp Business App** to communicate with their customers. Now, it's possible to **onboard using the existing WhatsApp Business account and phone number**.

Select **Connect your existing WhatsApp Business App** to proceed.

**What This Flow Lets You Do:**

* Use the **same number** you're already using on the WhatsApp Business App.
* Send messages at scale.
* Still reply 1:1 via your WhatsApp Business App.
* Keep your **chat history synced** across both platforms.

**Steps to follow to onboard with the existing WhatsApp Business App :**

1. Select **Connect your existing WhatsApp Business App.**
2. After selecting the option to use your **existing WhatsApp Business number** and enter the phone number.

<figure><img src="/files/g9Bw3fLT2qpaFcsA6dvg" alt="" width="279"><figcaption></figcaption></figure>

3. After entering the phone number, a **QR code screen** will appear.

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FssM4lQQZ6hJziGqwyWKP%2Fimage.png?alt=media&#x26;token=5e111d28-356c-4398-b50a-ac347fb1347b" alt="" width="279"><figcaption></figcaption></figure>

4. At the same time, you'll receive a message on your WhatsApp Business App from Meta.\
   Open that message and tap on the **“Scan QR Code”** button to scan the QR code displayed on the screen.\\

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2F49mvHZG3JREM3on2FL6E%2Fimage.png?alt=media&#x26;token=be84a2e7-e9a2-49ee-9c1f-112ff43d0e73" alt="" width="188"><figcaption></figcaption></figure>

5. **Click on “Scan QR Code”** in the message you receive on your WhatsApp Business App.
6. **Connect to the Business Platform**: This will open a page prompting you to scan the QR code shown on your screen to complete the **connection to the business platform.** On that page, once again, click **Scan QR Code** to proceed and establish the link.

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2F082lIlfjsuX6VuKxNWE5%2Fimage.png?alt=media&#x26;token=4dc6ad5e-14ca-4bca-b57e-366c35eb13da" alt="" width="205"><figcaption></figcaption></figure>

5. After clicking **Scan QR Code**, a pop-up will appear asking whether you want to share your **chat history** with the Business Platform.

   * Tap **Share chats** to allow past messages to be visible on the Business Platform.
   * Tap **Don’t share chats** if you prefer to keep previous messages private.

   ***Note: This choice is final and cannot be changed later.***

   <figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FyfGPWTLZGRhzz2B1FZ8l%2Fimage.png?alt=media&#x26;token=efdd32a5-0f6a-44a5-b46f-4310d078ddf5" alt="" width="199"><figcaption></figcaption></figure>
6. Success Screen: Click **"Add Payment Method"**, then select **"Finish"** to complete the onboarding process.

<figure><img src="/files/7DIjDn18Rsw9uL81KVlv" alt="" width="265"><figcaption></figcaption></figure>

*If you don’t have an existing WhatsApp Business number, you can onboard using a new number by following the steps in section* **B. Start with a new WhatsApp number**

<mark style="color:blue;">**Want to know how to set up Payment Method for WhatsApp Business API,**</mark> [*<mark style="color:blue;">**Click here**</mark>*](/communication-channels/whatsapp-integration/faq.md#how-to-add-a-payment-method-for-whatsapp-business-api)

</details>

<details>

<summary><strong>B. Start with a new WhatsApp number</strong></summary>

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FOSIIxzWlWZH82uVdzo8q%2Fimage.png?alt=media&#x26;token=586f1a39-59b2-4a56-b1a9-2bc63516f66d" alt="" width="285"><figcaption></figcaption></figure>

This option allows businesses to onboard by **adding a new phone number** instead of using an existing WhatsApp Business App account.

1. Enter the phone number you want to use for the WhatsApp Business API and choose your preferred verification method—either via text message or phone call.
2. Once selected, you must complete the verification to continue with the setup.

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2F3zLmim15x9ebpkLHRuWG%2Fimage.png?alt=media&#x26;token=b7b25065-45af-4dc3-b228-3327e1b9645a" alt="" width="269"><figcaption></figcaption></figure>

3. **Permissions Review Screen**: Next, the **Permissions Review Screen will appear.** This screen displays a summary of the permissions your business is about to grant. Click on **Continue**

<figure><img src="/files/g9Bw3fLT2qpaFcsA6dvg" alt="" width="279"><figcaption></figcaption></figure>

4. **Success Screen:** Click **"Add Payment Method"**, then select **"Finish"** to complete the onboarding process.

<figure><img src="/files/DBJ9SQvmmQLQD88z6Rbf" alt="" width="265"><figcaption></figcaption></figure>

<mark style="color:blue;">**Want to know how to set up Payment Method for WhatsApp Business API,**</mark> [*<mark style="color:blue;">**Click here**</mark>*](/communication-channels/whatsapp-integration/faq.md#how-to-add-a-payment-method-for-whatsapp-business-api)

</details>

***

**Step 5: Configure Messaging**

1. Select a display name for your WhatsApp Business profile (e.g., your business name).
2. Add a profile picture, business description, and working hours to complete your WhatsApp profile.
3. Configure automated messaging templates such as:
   * Order confirmations
   * Appointment reminders
   * Support messages

***

**Step 6: Complete Integration with Mercuri**

1. After completing the setup on Meta, you will be redirected back to Mercuri.
2. Link the verified WhatsApp number to your Mercuri account.
3. Test your WhatsApp messaging capabilities via the **Mercuri Conversations** to ensure everything is working correctly.

***

**Step 7: Start Messaging**

* Use Mercuri’s conversation inbox to send and receive WhatsApp messages with customers.
* Automate messages based on CRM triggers or use pre-approved templates for campaigns.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mercuri.cx/communication-channels/whatsapp-integration/onboarding-on-whatsapp-business-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.