WhatsApp Coexistence Setup Guide

Meta WhatsApp Coexistence combines the power and scalability of the WhatsApp Business API with the convenience and familiarity of the WhatsApp Business App, on the same number. This guide walks you through what the feature is, its benefits, the risks involved, how to set it up, and how to troubleshoot common issues.

WhatsApp Coexistence Setup Guide

The Problem: The Old Way of Using the WhatsApp API

• The 24-hour reply window: you were forced to use pre-approved templates if you wanted to reply to a customer after 24 hours.
• Loss of the Business App: switching to API-only meant giving up the convenience of replying on your phone with the WhatsApp Business App.
• No voice calling: with an API-only setup, you couldn't make voice calls to customers, which made it harder to have the important conversations that close deals faster.

The Solution: WhatsApp Coexistence

Coexistence connects your number to the powerful ABC Salesbot API while keeping your mobile Business App active. No more choosing between convenience and power:

• Automate and scale with the API: use AI chatbots and integrations in ABC Salesbot to handle conversations efficiently, qualify leads, and send media files, all automatically.
• Keep your contacts and history: your existing phone contacts and up to 6 months of chat history get imported automatically, so you don't lose important customer information.
• Bypass the 24-hour window for manual replies: jump into conversations anytime from your phone for a personal touch. No templates needed after 24 hours when you reply from the app.
• Make voice calls again: unlike API-only setups, you can make and receive voice calls directly from your Business App.

Which WhatsApp Option Fits You?

Before you begin, it helps to understand the different types of WhatsApp and where Coexistence fits in.

Standard WhatsApp

• Primary use: personal conversations
• AI agents and automation: no
• Pricing: free
• Best for: individuals and groups, personal and non-commercial communication

WhatsApp Business App

• Primary use: small business manual chat
• AI agents and automation: no, only basic quick replies
• Pricing: free
• Chat history: stored on your device only
• Best for: small business owners who manage customer chats manually from their phone

Full WhatsApp Cloud API (ABC only)

• Primary use: scaled business messaging, automation, and bots
• AI agents and automation: yes, through the ABC platform
• Pricing: template messages sent from ABC are billed by Meta per message, at rates that depend on the template category (see Meta's current rate card)
• Chat history: starts with a clean slate
• Throughput: high, scales with usage tiers
• Best for: businesses sending high volumes of notifications, OTPs, or transactional messages such as webinar broadcasts

WhatsApp Coexistence (ABC + WhatsApp Business App) - Recommended

• Primary use: both mobile app chat and AI agent automation
• AI agents and automation: yes, through the ABC platform
• Pricing: messages sent from the WhatsApp Business App are free, ideal for follow-ups
• Chat history: imports up to 6 months of history
• Throughput: capped at about 5 messages per second
• Best for: SMBs already using the Business App who want simple automation and a shared inbox

Note: Coexistence does not extend the API 24-hour messaging window and has regional restrictions.

Key Considerations and Limitations

Please review these trade-offs before connecting your account:

• Not for large broadcasts: this feature is NOT suitable for large, time-sensitive broadcasts (e.g., a webinar with over 500 registrants). Messaging speed is limited, which can cause significant delays for large audiences.
• Messaging speed cap: all messages sent via Coexistence are limited to approximately 5 messages per second.
• Some app features are disabled: after connecting, some features in your WhatsApp Business App will be disabled, including message editing, disappearing messages, and view-once messages.
• No group or broadcast sync: group chats and broadcast lists from your phone will not sync with the ABC platform.

Your Pre-Flight Checklist

Follow this safety-first approach before connecting:

1. Start with a NEW phone number. Get a fresh SIM card and number specifically for testing this feature. This isolates any potential issues from your main business line.
2. "Warm up" the new number. Install the WhatsApp Business App on a phone with the new number and use it for regular chats for at least 7 days to build a history of legitimate activity. Actively chat back and forth with 5 to 10 different people daily. (Some users report success after just 1 hour, so you can try your luck.)
3. Use a healthy Meta Business Portfolio. Connect your new number to a Meta Business Portfolio that is already in good standing, ideally one with a previously approved WhatsApp number. New portfolios are often scrutinised more heavily by Meta.

How to Connect Your WhatsApp Coexistence Account

Part 1: Starting from the ABC Platform

1. Navigate to Channels: log in to your ABC account, click your profile icon in the top-right corner, and select Messaging Channel from the dropdown menu.
2. Add a new channel: on the Channels page, click the Add Messaging Channel button.
3. Select Meta WhatsApp: a pop-up will appear. From the list of messaging channels, select Meta WhatsApp.
4. Start the connection: you'll see an informational screen about the WhatsApp Business App Coexistence feature. Read the details and click Start.
5. Connect with Meta: click the blue Connect with Meta WhatsApp button. This opens a new pop-up window to begin the Facebook/Meta setup flow.

Part 2: The Meta Setup Flow

1. Grant permissions: log in to your Facebook account if prompted. Click Get started to allow ABC to connect to your WhatsApp Business account.
2. Select a Business Portfolio: choose the correct Meta Business Portfolio from the dropdown list. The Business Name and Website should populate automatically. Click Next.
3. Choose your setup: when asked how you would like to onboard, select the first option, Connect your existing WhatsApp Business App. Click Next.
4. Enter your phone number: select your country code from the dropdown and enter the phone number associated with your WhatsApp Business App. Click Next.
5. Scan the QR code on your phone: a QR code will appear on your screen. Open your WhatsApp Business App. You should see a message from the official "Facebook Business" account. Tap this message and then tap Connect. If you don't see the message, go to Menu, then Settings, then Account, select Business Platform, and follow the prompts. You may be asked to confirm that you want to share your chat history. Then scan the QR code displayed on your computer screen.

Part 3: Finalizing the Connection

1. Confirm your details: after you scan the code, the page on your computer updates. Confirm your WhatsApp Business Account name and select your timezone (e.g., (GMT+08:00) Kuala Lumpur). Click Next.
2. Review and confirm: review the access permissions one last time and click Confirm.
3. Finish: the system takes a moment to connect. Once complete, click Finish.
4. Connection successful: you'll be redirected back to the ABC platform, where a pop-up confirms "Connected successfully!". Click OK. Your new WhatsApp number now appears in your list of channels.

How to Sync Your Contacts and Chat History

1. From the ABC website, navigate to your profile icon.
2. Click Messaging Channel from the dropdown menu.
3. Find the WhatsApp Coexistence channel you want to sync.
4. Click the Edit button next to that channel.
5. In the pop-up window, locate the "Sync WhatsApp Data" section.
6. Click the Start Sync Now button to begin the process.

Coexistence Dos and Don'ts

Do This

• Open the WhatsApp Business App at least once every 13 days to keep the API live.
• Use the mobile app for quick 1-to-1 replies, since those are free.
• Re-link WhatsApp Web/Desktop after onboarding, because previous sessions are logged out.
• Monitor the ABC dashboard for device offline alerts.
• Test the full flow with a sandbox number first.

Don't Do This

• Don't uninstall the app. Doing so breaks Coexistence until you re-onboard.
• Don't assume app replies extend the 24-hour service window for API messages. They don't.
• Don't share the phone number's SMS OTP outside trusted staff. Losing it lets anyone hijack the API link.
• Don't send template or bulk messages from the phone. Those must be sent via the CRM/API.
• Don't onboard numbers from restricted regions: AU, EU/EEA, UK, IN, JP, NG, PH, RU, KR, ZA, TR.

Following these best practices is key to a stable and successful connection.

Potential Errors and Troubleshooting

Frequently Asked Questions