Mercuri Docs
  • Welcome to Mercuri
  • 📩Communication Channels
    • WhatsApp Integration
      • Onboarding on WhatsApp Business
      • FAQ
    • SMS Integration
      • SMS Policies
      • Getting started with TFN
      • TFN verification process
      • Issues with TFN verification
      • SMS Length
  • 🧤Features
    • Conversations Inbox
      • Starting a New Chat with a Customer
      • Adding / Updating Contact details in Inbox
      • Interactive Message Options for WhatsApp Conversations
      • Use case of WhatsApp Interactive Messages
    • Contacts
    • Marketing
      • Track Campaign Performance
    • Automations
      • Automated workflow for e-commerce businesses
        • Order Cancelled Template
        • Order Created Template
        • Cart Abandoned Template
        • FulFilment Created Template
      • Automated Workflow For Booking Related Events
        • Booking ConfirmedTemplate
        • Booking Rescheduled Template
        • Booking CanceledTemplate
      • Automated Workflow For Restaurant Table Reservations
        • Table Reservation Created Template
        • Table Reservation Canceled Template
      • Automated Workflow For Restaurant Order Events
        • Restaurant Order Accepted Template
        • Restaurant Order Fulfilled Template
        • Restaurant Order Cancelled Template
        • Pickup / Delivery Order Created Template
      • Automated Workflow For Consumer Signup
      • Automated Workflow For Forms
    • Templates
      • Creating Your First WhatsApp Template
      • Understand WhatsApp Template components
    • Users Management
      • Simplifying Role-Based Access in Mercuri: Use Cases and Solutions
    • WhatsApp Widget
  • 🛍️Integrations Guide
    • Pipedrive
      • Install the Mercuri in Pipedrive
      • Using Mercuri in Pipedrive
        • SMS & WhatsApp Inbox
        • Configuring SMS
        • Adding Agents to the Shared Inbox
        • SMS and WhatsApp Marketing
    • Microsoft Teams
      • Install the Mercuri App in Microsoft Teams
      • Configure Mercuri for Microsoft Teams
      • WhatsApp Onboarding
      • How to use Mercuri?
Powered by GitBook
On this page
  1. Communication Channels
  2. WhatsApp Integration

Onboarding on WhatsApp Business

A step-by-step guide to onboard your first WhatsApp number.

PreviousWhatsApp IntegrationNextFAQ

Last updated 1 day ago

Step 1: Start the WhatsApp Business Onboarding

  1. From the Mercuri 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:

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

  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: Verify Your Business

  1. Enter your business details, including:

    • Business Name

    • Business Address

    • Industry Category

  2. Follow Meta’s prompts to complete the business verification process. (Note: Business verification is required to activate WhatsApp Business API.)


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

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

A. Connect your Existing WhatsApp Business App:

⚠️ 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)

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 entering the phone number, a QR code screen will appear.

  1. 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.

  1. Click on “Scan QR Code” in the message you receive on your WhatsApp Business App.

  2. 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.

  1. 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.

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

If you don’t have an existing WhatsApp Business number, you can onboard using a new number by following the steps below.

B. Start with a new WhatsApp number

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.

  1. 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

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


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 conversationinbox to send and receive WhatsApp messages with customers.

  • Automate messages based on CRM triggers or use pre-approved templates for campaigns.

or

📩
Connect your existing WhatsApp Business App
start with a new WhatsApp number
Log in with Facebook