Core Navigation
Products & Features
Industries
Resources
Coexistence

Use the WhatsApp Business App and the API Together on One Number

Already use the WhatsApp Business app? You don’t have to give it up to run campaigns and a team inbox. With coexistence, CampaigningTool connects your existing WhatsApp Business app number to the official Cloud API. You keep answering customers one-to-one in the app, and your team uses CampaigningTool for bulk campaigns, automation and shared replies, with messages kept in sync between both.

OFFICIAL META COEXISTENCE ONBOARDING FLOW (6 STEPS) Connect your existing WhatsApp Business app number to Cloud API without losing your app or phone access 1 Start in CampaigningTool Launch Connection Log in to your CampaigningTool dashboard and choose "Connect existing WhatsApp Business app number" via Meta Embedded Signup v4. 2 Enter Phone & Copy Code Meta Verification Code Enter your current phone number. Meta generates a secure 6-digit coexistence verification code. Copy this code to your clipboard before switching to your phone. 3 Open Business App & Tap In-App Notification Open your WhatsApp Business app. You will see a notification from official Facebook Business Account. Tap "Connect" → "Connect to the Business Platform". 4 Share Chat History? Sync Consent Choose whether to share past chats. Tap "Confirm" in your app to grant CampaigningTool permission to import up to the last 6 months of one-to-one chat messages and contacts. 5 Paste Code & Finish Complete Registration Return to the Embedded Signup screen in CampaigningTool, paste the confirmation code, and accept permissions to complete the official API registration. 6 Wait for Sync & Keep Open 24-Hour Mirror Window Synchronization takes a few minutes. Meta allows up to 24 hours to complete. Keep your Business app open and active on your phone while the initial import finishes running. Prerequisite: WhatsApp Business app version 2.24.17+ • Primary phone must remain active (inactivity >14 days triggers disconnect)
Coexistence Benefits

What Coexistence Gives You

Keep the simplicity of your mobile phone app while unlocking enterprise WhatsApp Cloud API powers.

Keep Your App and Your Number

Businesses can onboard with their existing WhatsApp Business app account and phone number, and still message customers one-to-one in the app. No need to buy a separate number or migrate entirely away from your phone.

Campaigns and Automation on the API

Send approved template campaigns, schedule drips and use the AI agent from CampaigningTool, without changing the number customers know. See bulk broadcasts for reach at scale.

Explore Bulk Broadcasts

Chats Stay in Sync

Messages sent and received are mirrored between the Cloud API and the app, and contacts and recent chat history can be synchronized. Your phone and team inbox stay updated simultaneously.

Explore Multi-User Team Inbox
Connection Walkthrough

How to Connect Your WhatsApp Business App Number

Follow Meta's official Embedded Signup flow to link your phone app and Cloud API in minutes.

1

Start in CampaigningTool

Start in CampaigningTool and choose to connect your existing WhatsApp Business app number via Meta Embedded Signup.

2

Enter your number and copy the code

Enter your number. WhatsApp shows a verification code, which you copy to your clipboard.

3

Open your WhatsApp Business app

Open your WhatsApp Business app. You’ll receive a message from the official Facebook Business Account. Tap Connect, then Connect to the Business Platform.

4

Choose whether to share chat history

Choose whether to share chat history. Tap Confirm in the app to give CampaigningTool the option to import your chat history.

5

Paste the code and finish signup

Paste the code and finish the signup on the CampaigningTool onboarding screen.

6

Wait for the sync

Wait for the sync. The partner has 24 hours to synchronize history, and it can take several minutes. Keep the WhatsApp Business app open while it runs.

Visual Walkthrough: What You See on Screen

Meta Embedded Signup: Connect your existing WhatsApp Business App
Step 1 & 2: Select Setup

Choose "Connect your existing WhatsApp Business App" in Meta Embedded Signup.

WhatsApp mobile app chat prompt from Facebook Business
Step 3: In-App Notification

Receive prompt from Facebook Business in WhatsApp and tap "Connect".

Share chat history prompt in WhatsApp Business app
Step 4: Chat History Permission

Confirm permission to mirror your past 6 months of 1-to-1 chats.

Powered by Meta Embedded Signup Version 4

Meta deprecated Embedded Signup v2 on October 15, 2026. CampaigningTool’s coexistence onboarding operates natively on Meta’s official Version 4 framework, guaranteeing continuous uptime, official compliance, and seamless chat synchronization.

Prerequisites Checklist

What You Need Before You Start

Ensure your phone, account, and business portfolio meet Meta’s coexistence requirements.

  • A number that is on the WhatsApp Business app, not the regular WhatsApp app. The Business app must be version 2.24.17 or higher.
  • Admin access to your Meta business portfolio, and a verified business for higher sending limits. See API requirements.
  • A phone with the Business app that stays active (see “Staying connected” below).
Feature Compatibility Matrix

What Works After You Connect

Detailed breakdown of features supported on the phone app versus the Cloud API under coexistence.

Feature After onboarding
One-to-one chats Supported on both sides, chats mirrored, message edit and delete supported
Contacts Contacts with a WhatsApp number can be synchronized
Chat history The most recent six months of chats can be synchronized, if you allow it
Group chats Not supported, and not synchronized
Disappearing messages, view-once messages, live location Turned off in one-to-one chats
Broadcast lists Disabled in the app. You can’t create new ones, and existing ones become read-only. Use CampaigningTool campaigns instead.
Voice and video calls, catalog, labels, quick replies and greeting messages Keep working in the app, but they aren’t supported through the Cloud API
FEATURE / CAPABILITY BEHAVIOR AFTER ONBOARDING COEXISTENCE STATUS 💬 One-to-one chats Supported on both sides, chats mirrored in real time Message edit and delete fully synchronized between app & CampaigningTool ✓ Mirrored 👥 Contacts list Contacts with a registered WhatsApp number can be synced Imported directly into CampaigningTool audience directory ✓ Synced 🕒 Chat history (1-on-1) Most recent 6 months of chats can be synchronized Requires optional history sharing permission during onboarding flow 6-Mo Opt-in 👥 Group chats Remain on phone app only; not supported on Cloud API Groups are completely excluded from API import & sync pipelines ✕ App Only ⏳ Disappearing & View-Once, Live Location Turned off in one-to-one chats Disabled by Meta to ensure compliance and reliable mirroring to API ✕ Turned Off 📢 Phone Broadcast lists Disabled in app (existing become read-only, cannot create new) Use CampaigningTool for unlimited bulk broadcasts to opted-in users Read-Only 📞 Calls, catalog, labels, quick replies & greetings Keep working normally on phone app; not available via Cloud API Answer calls and manage labels directly inside the mobile WhatsApp Business app ✓ Active in App ⚡ Sending speed throughput Fixed at 20 messages per second on coexistence numbers Adequate for broadcasts (10,000 msgs take under 10 minutes) while maintaining app sync 20 msgs/sec

Linked Devices

You can link up to four companion devices to the Business app, except WhatsApp for Windows and WatchOS-type wearables. When you connect to the API, all linked devices are unlinked, and you can then link the supported ones again.

Staying Connected

Keep your primary phone active. Meta disconnects the API link in some cases, for example if the primary device is inactive for about 14 days, a linked device for about 30 days, the number is registered on the regular WhatsApp app, or you re-register on a new device.

If you want to disconnect yourself, open the WhatsApp Business app, go to Settings → Account → Business Platform, and tap Disconnect Account.

Business Platform disconnect settings screen in WhatsApp Business app
Billing & 24-Hour Windows

Costs and Message Rules

How conversation windows and Meta API pricing function alongside free mobile app chats.

  • App messages stay free. Messages you send from the Business app remain free, while messages sent through the Cloud API follow Cloud API pricing.
  • The 24-hour window applies to the API side only. Messages sent from the Business app aren’t subject to the customer service window, and don’t create, extend or affect Cloud API windows or pricing.
  • A customer who messages just before you connect: You can only answer with a template, because no API service window was opened.

See pricing for your CampaigningTool plan details and conversation credits.

Throughput Constraints

Speed Limit for Coexistence Numbers

Understanding throughput rates for numbers paired between the mobile app and Cloud API.

Numbers used on both the Business app and the Cloud API have a fixed throughput of 20 messages per second, to stay compatible with the app. That is plenty for most campaigns (10,000 messages take under 10 minutes), but it’s lower than the default for API-only numbers. Meta’s daily messaging limits still apply on top of it.

Decision Guide

Coexistence or a Regular API Number?

Choose the setup that matches your team’s messaging volume and operational workflow.

Use Coexistence If:

Use coexistence if you already use the Business app, want to keep the number and the app, and are happy with the limits above.

Use an API-Only Number If:

Use an API-only number if you want the highest throughput, don’t need the app, or your number is on the regular WhatsApp app (switch to the Business app first, or move the number as explained in our existing number guide).

Industry Applications

Who Uses Coexistence

Businesses that bridge everyday customer conversations with automated broadcasts.

Small and growing shops, clinics, coaching institutes and agencies that already answer customers in the Business app use coexistence to power marketing without losing personal touch.

E-Commerce & Retail

Take customer enquiries in the app while sending automated abandoned cart recoveries and festive sale broadcasts via API.

WhatsApp for E-Commerce

Clinics & Healthcare

Doctors reply to patient queries from their phone app while receptionist software broadcasts appointment and clinic alerts.

WhatsApp for Healthcare

Colleges & Institutes

Counselors answer student questions on the phone while sending automated admission notices and fee reminders via API.

WhatsApp for Colleges
Get Started in 10 Minutes

Add the API to Your WhatsApp Business App

Connect your existing number, keep your app and start sending campaigns. Try CampaigningTool free for 7 days.

Frequently Asked Questions

Frequently Asked Questions About WhatsApp Coexistence

Direct, transparent answers regarding Meta coexistence setup, phone app usage, and API rules.

It’s Meta’s option that lets a number on the WhatsApp Business app also connect to the Cloud API, so you can use the app and a platform like CampaigningTool on the same number.

No. Your app stays active. It must be the WhatsApp Business app, not the regular WhatsApp app.

Chats stay in your app. You can also let CampaigningTool import up to six months of one-to-one history, which doesn’t include group chats.

WhatsApp Business app version 2.24.17 or higher.

No. Broadcast lists are disabled in the app after you connect. Run campaigns from CampaigningTool instead.

No. Messages sent from the Business app stay free. Messages sent through the API follow Meta’s API pricing.

Numbers used on both the app and the API are limited to 20 messages per second, and Meta’s daily messaging limits also apply.

Meta can disconnect the API link if the primary phone is inactive for about 14 days, so keep the Business app in use.

Yes, from the Business app: Settings, Account, Business Platform, then Disconnect Account.

They’re unlinked when you connect, and you can link supported ones again. WhatsApp for Windows isn’t supported.

Still have questions? Contact our support team to discuss your requirements.