How to connect

Steps to connect

Before starting, make sure that your Facebook account is an Admin of the Meta Business Portfolio which owns the WhatsApp Account.

1. Go to the Integrations Area – Navigate to Settings > Integrations in Zaapi.

2. Click "WhatsApp Business" – you will see two different connection options each with separate instructions below:

   1. Connect WhatsApp Business App - known as "coexistence", this option will allow you to use both Zaapi and your existing WhatsApp Business app

   2. Connect a new WhatsApp Cloud API Phone Number - use this option to connect a new WhatsApp phone number, or migrate an existing Cloud API number to Zaapi

Connecting WhatsApp Business App (aka Coexistence)

Requirements

• This is only available to businesses that are actively using the WhatsApp Business App and are eligible according to Meta's criteria, based on tenure and messaging quality

• WhatsApp Business App version 2.24.17 or later

• The phone number is added to your Meta Business Portfolio - learn more

• Your business must not be registered in a currently unsupported country - see list of unsupported countries

Steps to Connect

After selecting the "Connect WhatsApp Business App" option, a Facebook login modal will appear. Log in to your Facebook account and follow the steps

1. Choose the Meta Business Portfolio that your phone number belongs to

2. Enter and verify the phone number

3. Scan a QR code using the WhatsApp business app

4. Leave the WhatsApp Business app for a few minutes whilst the connection is in progress. Once complete, your Business app will refresh and show that the number is now connected to the API via Zaapi

Note: when asked if you would like to "Share chat history", you can select "Don't share chats" since chat history import is not yet supported.

Connect a new WhatsApp Business App

After selecting the the "Connect WhatsApp Business App" option, a Facebook login modal will appear. Log in to your Facebook account and follow the steps

1. Choose the Meta Business Portfolio that your phone number belongs to.

2. Choose or create a WhatsApp Business account and profile

3. Confirm and finish

Migrating from another cloud API provider

Ready for a better WhatsApp experience? You can migrate to Zaapi from any WhatsApp Business Solution Provider (BSP) in a few simple steps.

Migrated ✅	Not Migrated ❌
Quality rating	Chat history
Approved, high quality templates	Rejected and low quality templates
Official Business Account Status
Display name
Messaging limit

You can find more about this migration process in the official WhatsApp documentation.

Prerequisites

Before you begin, make sure:

• Your Meta Business Account is verified.

• Your WhatsApp Business Account (WABA) is approved.

• Your WABA has a valid payment method added in Payment Settings.

• Two-step verification is disabled for the phone number. You can disable it in WhatsApp Manager (see this guide).

• You can receive a one-time password (OTP) on the phone number being migrated (via SMS or voice).

Migration process

Once you’ve met the prerequisites, log in to your Zaapi account and follow these steps:

1. Open Integrations: Go to Settings → Integrations.

2. Select WhatsApp Business: Choose “Connect a new or existing WhatsApp Cloud API phone number.”

3. Authenticate with Facebook: Log in and select the relevant Business Portfolio.

4. Create a new WhatsApp Business Account & Profile—this is for internal reference only and is not public. Your Meta Business Portfolio will remain the same.

5. Enter your phone number: select your preferred OTP delivery method. When migrating from another provider, you’ll see a yellow warning message like the one shown below.

6. Verify the number: enter the OTP and click Next.

7. Confirm and finish: review your selections and complete the migration.

In step 5, the yellow warning appears specifically when you’re migrating a phone number from another provider. This is expected—continue with the verification to proceed.