WhatsApp Coexistence Limitations in Envoy
Coexistence mode lets you use WhatsApp Business App on your phone and Envoy's Cloud API at the same time. It's convenient, but it comes with limitations you need to know.
If the primary mobile device doesn't open WhatsApp at least once every 14 days, Meta disconnects all linked devices and API connections, including Envoy.
This is the #1 cause of unexpected disconnections across Envoy customers. When this happens:
- Your Envoy channel shows "Disconnected"
- Messages stop appearing in your inbox
- Chatbot and auto-replies stop working
- The phone still works normally
Fix: Open WhatsApp on the primary phone at least once every 2 weeks. Set a calendar reminder if needed.
If you've already been disconnected, see our reconnection guide.
| Limitation | Details |
|---|---|
| Some contacts can't read API messages | Contacts on very old WhatsApp versions won't see messages sent through Envoy or WhatsApp Web. They need to update their app. |
| Error 131060 on companion device messages | Messages sent from the phone in coexistence mode show as "unavailable" in Envoy's API logs. These are visible to the recipient but not through the API. |
| Session conflicts with multiple accounts | Running personal WhatsApp and WhatsApp Business on the same phone causes session conflicts that trigger disconnections. Use separate devices. |
| History sync gaps | Not all historical messages sync perfectly. Some conversations may be incomplete after initial setup. |
Was this article helpful?
Related Articles
Adding a New WhatsApp Number Disconnects Existing Numbers in Envoy
You added a new WhatsApp Business number to Envoy, and your previously connected numbers stopped working. The new number works fine, but the old ones show as disconnected or have lost functionality.
Setup & ConnectionWhatsApp Disconnected - How to Reconnect in Envoy
Your WhatsApp channel shows as "Disconnected" in Envoy. Your phone can still receive messages, but they're not appearing in your Envoy inbox. Chatbot auto-replies and team inbox access have stopped working.
Setup & ConnectionWhatsApp QR Code Not Working During Envoy Setup
You're setting up your WhatsApp Business channel in Envoy by scanning a QR code, but the scan fails or the connection doesn't complete.