1. What is WhatsApp Coexistence and why did Meta remove the previous restriction?
For years, Meta enforced a strict technical rule: a phone number had to be registered either on the mobile app or on the WhatsApp Business API. Switching to the API immediately revoked mobile access, leaving teams without a phone interface.
This constraint caused friction for growing businesses. Field sales reps, founders, and support managers wanted API automation (order updates, payment alerts, AI chatbots) while keeping their smartphones to answer customers directly and make voice calls.
With WhatsApp Coexistence, Meta updated its routing architecture. Businesses can now connect their phone number to the WhatsApp Business app on iOS/Android while linking the exact same number to the Cloud API via EnvoiSMS.
2. How does message synchronization work between your smartphone and the API?
Coexistence relies on bidirectional mirroring managed by Meta's infrastructure:
- Inbound Messages: When a customer texts your WhatsApp number, Meta routes the message simultaneously to your mobile app and sends a JSON webhook (
messages.upsert) to EnvoiSMS. - Outbound App Messages: When an agent replies from the phone app, the message is delivered to the customer and an echo webhook (
message_echoes) is sent to the API to keep CRM records up to date. - Outbound API Messages: Automated notifications sent through EnvoiSMS appear in real time inside the smartphone chat history.
{
"object": "whatsapp_business_account",
"entry": [{
"id": "1512565260555147",
"changes": [{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "+212708789095",
"phone_number_id": "1260921063776677"
},
"contacts": [{"profile": {"name": "Karim Bennani"}, "wa_id": "212612345678"}],
"messages": [{
"from": "212612345678",
"id": "wamid.HBgLMjEyNjEyMzQ1Njc4FQIAEhgg...",
"timestamp": "1732104800",
"text": {"body": "Hello, has my order shipped?"},
"type": "text"
}]
},
"field": "messages"
}]
}]
}3. What are the prerequisites and steps to activate coexistence on your number?
Enabling coexistence does not require specialized hardware. Follow these steps:
- App Update: Update WhatsApp Business on your smartphone to the latest version.
- Embedded Signup v4: Open your EnvoiSMS dashboard and launch the WhatsApp onboarding flow, selecting the option to keep the mobile number active.
- OTP Verification: Receive an SMS or voice OTP code on your phone to confirm API delegation.
- Permission Grant: Grant EnvoiSMS access to manage messages. The number status updates to Coexistence Enabled in WhatsApp Manager.
- Webhook Routing: Set your webhook endpoint to receive inbound messages and dispatch automated workflows.
4. What are the technical limits and operational rules in Coexistence mode?
Coexistence provides flexibility while adhering to defined operating boundaries:
| Parameter | Specification | Operational Impact |
|---|---|---|
| Max Throughput | Capped at 20 mps | Suitable for customer support and transactional updates; high-volume marketing should use dedicated API numbers |
| 14-Day Inactivity Rule | Automatic disconnection if the phone is offline for 14 days | The mobile phone must connect to the network at least once every two weeks to maintain sync |
| Static WebP Support | Fully supported natively | Reduces mobile data usage for field reps sharing product images |
| WhatsApp Status (Stories) | Mobile app only | Continue posting status updates directly from your smartphone |
| Voice Calls | Supported on smartphone and Calling API | The phone rings normally on incoming voice calls |
Collision Prevention: When a human agent types a reply on the smartphone, configure your automation to pause bot replies for 30 minutes on that thread.
5. How is Coexistence priced and how can you optimize operational costs?
Meta charges no additional subscription fee for activating coexistence. Pricing follows standard Meta conversation billing:
- Service Conversations: User-initiated inbound messages fall under the 1,000 free service conversation monthly allowance per WABA account.
- Utility Notifications: Transactional templates (shipping updates, receipts) billed at standard rates.
- Marketing Messages: Billed per delivered template.
This setup eliminates the need for expensive multi-agent desktop software for small teams who already carry smartphones.
Frequently asked questions
Can I still receive WhatsApp voice calls on my smartphone?
Yes. Coexistence keeps the WhatsApp Business mobile app fully active, allowing you to answer regular inbound voice calls on your phone.
What happens if the smartphone is turned off or offline?
The Cloud API operates continuously 24/7 in the cloud. Webhooks, bots, and automated notifications continue delivering without interruption. Once the smartphone reconnects, local chat history syncs automatically.
Can I link multiple phones to the same number?
Yes. You can use WhatsApp Multi-Device to link up to 4 companion devices (desktops or secondary phones) to your primary WhatsApp Business smartphone.
What happens if the smartphone is inactive for 14 days?
Under Meta security policies, if a linked mobile device remains offline for 14 consecutive days, its mobile session expires. Re-authenticating on the phone restores the connection while API traffic continues uninterrupted.