Documentation

What is EasyCoexistence?

EasyCoexistence puts the business number you already use on the WhatsApp Business Platform (Cloud API) through Meta's official Coexistence feature, then monitors the connection around the clock so it never silently dies.

• The app on your phone keeps working exactly as before. Coexistence adds the API alongside it, replacing nothing.
• No migration, no lost chats: your history stays on your phone.
• Connect as many numbers as you want on a single account.
• Your conversations never pass through our servers. Incoming messages can be routed by Meta directly to your own system.

Connecting a number

1. Create your account and open the dashboard.
2. Click “Connect a number”. Meta's window opens; log in with the Facebook account that manages your business.
3. Enter your business number and scan the QR code with the WhatsApp Business app on your phone.
4. Done, usually in under 2 minutes. The number appears on your dashboard with live health.

Is your number eligible? Read this first

Meta enforces a few rules before allowing Coexistence. Most failed connections hit one of these:

• The number must be on the WhatsApp Business app, version 2.24.17 or newer. Personal WhatsApp accounts can't connect.
• The number needs real, recent two-way conversation activity. Brand-new or dormant numbers are refused.
• The number can't be attached to another API platform or provider (bulk senders, CRMs, automation tools). Disconnect it there first, then try again.
• Two-step verification or a pending device pairing in the app can also block onboarding.

If Meta says the number is “registered to an existing WhatsApp account”, do NOT delete the WhatsApp account on your phone; the number must stay active in the app. Free it from the other platform instead.

What changes in the app (the trade-offs)

Turning on Coexistence disables a few features of the app, all of them in individual (1:1) chats. Know them before connecting:

• Disappearing messages are turned off in 1:1 chats.
• View-once messages are disabled in 1:1 chats.
• Live location sharing is disabled in 1:1 chats.
• Broadcast lists: you can't create new ones, and existing ones become read-only.
• At onboarding, all linked devices are disconnected and need to be re-linked. WhatsApp for Windows and WearOS stop being supported.
• Groups, calls, catalog and status keep working in the app, but they don't appear on the API side.
• The number gets a combined API throughput cap of 20 messages per second. Day-to-day chatting is unaffected.

Use it from your AI (one connector per account)

Your whole account gets a single connector URL. It works for every number you connect, present and future: your AI sees all your numbers and picks the right one for each task.

• Claude (web or desktop): Settings → Connectors → Add custom connector, then paste the URL.
• ChatGPT: Settings → Connectors → Advanced, enable Developer mode, then add the URL.
• Claude Code (terminal): claude mcp add --transport http easycoexistence https://easycoexistence.com/api/mcp
• When prompted, log in with your EasyCoexistence email and password and authorize access.

Then just ask: “send a message from my number”, “create a promo template”, “is my number healthy?”, “route incoming messages to my system”.

What your AI can do (tools)

• list_numbers: all your numbers with status, quality and tier.
• get_number_health: a live snapshot from Meta plus the recent event timeline.
• send_message: free-form reply within the 24-hour service window.
• create_template, get_template_status, list_templates: create and track message templates.
• send_template: start conversations with an approved template.
• get_api_credentials: IDs, endpoints and token for wiring up your own system.
• set_webhook_destination: route incoming messages straight from Meta to your webhook.
• get_connect_link: how to onboard another number.
• get_docs: this documentation, so your AI can answer questions about the product.

Sending rules (set by Meta, not by us)

• Replying is free-form: anyone who messaged you in the last 24 hours can be answered directly.
• Starting a conversation requires a pre-approved template.
• In Coexistence, templates can only be sent via the API; the phone app can't send them.
• Marketing messages are billed by Meta to your own WhatsApp Business Account payment method. We never mark up messaging.
• Meta caps API throughput for Coexistence numbers; day-to-day messaging on the phone is unaffected.

Plug in your own system

Every number's page in the dashboard shows its API base URL, account and phone IDs, and access token: everything n8n, a CRM or custom code needs to send via the official Cloud API. To receive, ask your AI to route incoming messages to your webhook (set_webhook_destination): Meta then delivers them directly to your endpoint, never touching our servers.

Monitoring & the 14-day rule

We watch every connected number around the clock (connection state, quality rating and messaging tier) via Meta webhooks and periodic checks. If the business app on the phone goes about 14 days without being opened, Meta can silently drop the Coexistence link. The moment anything breaks, your dashboard shows it with the reason. Rule of thumb: keep using the app normally.

What EasyCoexistence is not

• Not an inbox or a chatbot. Conversations keep happening in your app, in your AI or in your own system; we don't add another panel to live in.
• Not a mass-messaging tool. Meta's rules still apply: replies within the 24-hour window, templates to start conversations.
• Not a Meta product. We are an independent Tech Provider using Coexistence, the platform's official feature.
• Not a middleman for your messages. We never read or store the content of your conversations.

And if EasyCoexistence disappears tomorrow? Nothing happens to your number: the app keeps working, your history stays on your phone, and the API connection can be undone at any time. A bridge, not a cage.

Common questions

Support

Have a question that isn't covered here? Write to matheus@tonelotto.com.