Skip to main content
    Back to Documentation
    Troubleshooting

    WhatsApp Coexistence Limitations: What You Need to Know

    Using WhatsApp Business App and Envoy together on the same number? Understand the key limitations of WhatsApp Coexistence mode, including the critical 14-day disconnection rule if you don't open the WhatsApp Business App regularly.

    4 min read
    Updated Jan 16, 2026
    coexistencelimitationswhatsapp business appcloud apidisconnection14 days
    Using Envoy? See the Envoy-specific guide with step-by-step instructions for your dashboard.

    What is WhatsApp Coexistence?

    WhatsApp Coexistence lets you use your existing WhatsApp Business App and Envoy together on the same number — without disconnecting or migrating your number.

    When you connect your WhatsApp Business App number to Envoy via Coexistence, Envoy accesses it through the WhatsApp Cloud API. This allows you to:

  1. Continue chatting with customers directly on the WhatsApp Business App
  2. Reply to the same customers via Envoy, using Cloud API features such as automation, analytics, and multi-user collaboration
  3. Test API-level features while keeping your existing chats and contacts

  4. ⚠️ Critical Warning: 14-Day Disconnection Rule

    If you fail to open the WhatsApp Business App for more than 14 days, the connection may expire and require reconnection.

    This is the most important limitation to understand. To maintain your Coexistence connection:

    Open your WhatsApp Business App at least once every 14 days

    If the connection expires:

  5. You'll need to go through the reconnection process again
  6. There may be temporary disruption to your messaging capabilities
  7. Previously synced conversations may need to re-sync
  8. Set a recurring reminder to open your WhatsApp Business App weekly to avoid any issues.


    Key Limitations

    1. Country Availability

    Coexistence is currently available only in selected countries. Not all regions support this feature. Check with Envoy support to confirm availability in your location.

    2. Chat History Limitations

  9. Only one-to-one chats from the last 6 months can be imported to Envoy
  10. Group chats will not be included — group chat history cannot be synced
  11. This choice cannot be changed later unless you reconnect the account
  12. 3. Feature Compatibility

  13. Not compatible with WhatsApp Marketing Message Lite API
  14. Some capabilities (chat sync, media support, business profile updates) may differ from a full Cloud API setup
  15. 4. Advanced Features Unavailable

    Some advanced WhatsApp Business App features may be unavailable after connecting through Coexistence. These include certain app-specific automations and settings that don't translate to the Cloud API.

    5. Offboarding Process

    Removing or offboarding must be done directly in the WhatsApp Business App, not from Envoy. If you need to disconnect:

    1. Open the WhatsApp Business App on your phone

    2. Go to Settings > Account > Business Platform

    3. Tap the connected platform (e.g., Envoy)

    4. Tap Disconnect to confirm

    6. Feature Availability Varies

    Feature availability for WhatsApp Coexistence may vary by:

  16. Country
  17. WhatsApp Business App version
  18. Meta's ongoing updates and changes

  19. Best Practices for Coexistence

    To make the most of WhatsApp Coexistence and avoid issues:

    ✅ Keep Your App Active

    Open your WhatsApp Business App at least once every 14 days. Set a weekly reminder to be safe.

    ✅ Assign Contacts Properly

    When importing contacts to Envoy, always assign them to a user or team to ensure smooth follow-up and no missed conversations.

    ✅ Set Up Auto Top-up

    Configure auto top-up for WhatsApp messaging fees during setup to avoid message delivery interruptions.

    ✅ Test Automations Safely

    Start with small-scale automation flows before applying rules to all contacts. Coexistence can behave differently than full API migration.

    ✅ Monitor Sync Status

    Regularly check that contact and chat syncing is working correctly. Only contact sync progress is visible — chat history sync progress is not displayed.


    Important Notes

  20. Feature availability may vary by country and WhatsApp Business App version
  21. Some capabilities may differ from a full Cloud API setup
  22. Always confirm availability and restrictions with Envoy support before proceeding
  23. For detailed feature comparisons, refer to Meta's official Coexistence documentation

  24. When Coexistence is Right for You

    Coexistence is ideal when:

  25. You want to test Envoy's automation features without fully migrating
  26. Multiple team members need to reply via Envoy while others stay in the app
  27. You need business continuity — keeping existing chats intact while expanding capabilities
  28. You're planning a gradual transition from the app to full Cloud API

  29. Need Help?

    If you have questions about Coexistence limitations or need help maintaining your connection:

    Tell us what you need — Our team can walk you through the setup and best practices for your specific use case.