Documentação
Tudo sobre conectar seu número, manter a conexão saudável e usá-lo a partir da sua IA ou do seu próprio sistema.
O que é a EasyCoexistence?
A EasyCoexistence coloca o número comercial que você já usa na WhatsApp Business Platform (Cloud API) por meio da Coexistência, recurso oficial da Meta, e depois monitora a conexão em tempo integral para que ela nunca morra em silêncio.
- O aplicativo no seu celular continua funcionando exatamente como antes. A Coexistência adiciona a API ao lado dele, sem substituir nada.
- Sem migração e sem perder conversas: seu histórico fica no celular.
- Conecte quantos números quiser em uma única conta.
- Suas conversas nunca passam pelos nossos servidores. As mensagens recebidas podem ser roteadas pela Meta direto para o seu próprio sistema.
Conectando um número
- Crie sua conta e abra o dashboard.
- Clique em “Conectar um número”. A janela da Meta abre; entre com a conta do Facebook que administra o seu negócio.
- Informe o número comercial e escaneie o QR code com o app WhatsApp Business no celular.
- Pronto, normalmente em menos de 2 minutos. O número aparece no dashboard com a saúde ao vivo.
Seu número é elegível? Leia antes de conectar
A Meta impõe algumas regras antes de liberar a Coexistência. A maioria das conexões que falham esbarra em uma destas:
- O número precisa estar no app WhatsApp Business, versão 2.24.17 ou mais nova. Contas de WhatsApp pessoal não conectam.
- O número precisa de atividade real e recente de conversa nos dois sentidos. Números novos ou parados são recusados.
- O número não pode estar preso a outra plataforma ou provedor de API (disparadores, CRMs, ferramentas de automação). Desconecte-o lá primeiro e tente de novo.
- Verificação em duas etapas ou um pareamento de aparelho pendente no app também podem bloquear.
Se a Meta disser que o número está “registrado em uma conta de WhatsApp existente”, NÃO apague a conta do WhatsApp no celular; o número precisa continuar ativo no app. Libere-o da outra plataforma.
O que muda no app (as contrapartidas)
Ativar a Coexistência desliga alguns recursos do aplicativo, todos em conversas individuais (1:1). Saiba antes de conectar:
- Mensagens temporárias são desativadas nas conversas 1:1.
- Mensagens de visualização única são desativadas nas conversas 1:1.
- Localização em tempo real é desativada nas conversas 1:1.
- Listas de transmissão: não dá para criar novas, e as existentes ficam somente leitura.
- Na conexão, todos os aparelhos vinculados são desconectados e precisam ser vinculados de novo. WhatsApp para Windows e WearOS deixam de ser suportados.
- Grupos, chamadas, catálogo e status continuam funcionando no app, mas não aparecem do lado da API.
- O número passa a ter um teto combinado de 20 mensagens por segundo na API. O uso do dia a dia não é afetado.
Use a partir da sua IA (um conector por conta)
Sua conta inteira usa uma única URL de conector. Ela vale para todos os números que você conectar, agora e no futuro: sua IA enxerga todos os números e escolhe o certo para cada tarefa.
- Claude (web ou desktop): Configurações → Conectores → Adicionar conector personalizado, depois cole a URL.
- ChatGPT: Configurações → Conectores → Avançado, ative o modo Desenvolvedor e adicione a URL.
- Claude Code (terminal): claude mcp add --transport http easycoexistence https://easycoexistence.com/api/mcp
- Quando solicitado, entre com seu email e senha da EasyCoexistence e autorize o acesso.
Depois é só pedir: “envie uma mensagem do meu número”, “crie um template de promoção”, “meu número está saudável?”, “roteie as mensagens recebidas para o meu sistema”.
O que a sua IA consegue fazer (tools)
- list_numbers: todos os seus números com status, qualidade e tier.
- get_number_health: retrato ao vivo direto da Meta mais a linha do tempo de eventos recentes.
- send_message: resposta livre dentro da janela de atendimento de 24 horas.
- create_template, get_template_status, list_templates: criar e acompanhar templates de mensagem.
- send_template: iniciar conversas com um template aprovado.
- get_api_credentials: IDs, endpoints e token para integrar o seu próprio sistema.
- set_webhook_destination: rotear mensagens recebidas direto da Meta para o seu webhook.
- get_connect_link: como conectar mais um número.
- get_docs: esta documentação, para a sua IA responder dúvidas sobre o produto.
Regras de envio (da Meta, não nossas)
- Responder é livre: quem mandou mensagem para você nas últimas 24 horas pode ser respondido diretamente.
- Iniciar uma conversa exige um template pré-aprovado.
- Na Coexistência, templates só podem ser enviados pela API; o app do celular não os envia.
- Mensagens de marketing são cobradas pela Meta no meio de pagamento da sua própria conta WhatsApp Business. Nunca cobramos por mensagem.
- A Meta limita a vazão da API em números com Coexistência; o uso do dia a dia no app não é afetado.
Conecte o seu próprio sistema
A página de cada número no dashboard mostra a URL base da API, os IDs de conta e de telefone e o token de acesso: tudo o que n8n, um CRM ou código próprio precisam para enviar pela Cloud API oficial. Para receber, peça à sua IA para rotear as mensagens recebidas para o seu webhook (set_webhook_destination): a Meta passa a entregá-las direto no seu endpoint, sem nunca tocar nossos servidores.
Monitoramento e a regra dos 7 dias
Vigiamos cada número conectado em tempo integral (estado da conexão, qualidade e tier de mensagens) via webhooks da Meta e checagens periódicas. Se o app comercial no celular ficar cerca de 7 dias sem ser aberto, a Meta pode derrubar a Coexistência em silêncio. No momento em que algo quebra, o dashboard mostra o ocorrido com o motivo. Regra de ouro: continue usando o app normalmente.
O que a EasyCoexistence não é
- Não é um inbox nem um chatbot. As conversas continuam no seu app, na sua IA ou no seu sistema; não criamos mais um painel para você viver dentro.
- Não é ferramenta de disparo em massa. As regras da Meta continuam valendo: respostas na janela de 24 horas, templates para iniciar conversas.
- Não é um produto da Meta. Somos um Tech Provider independente usando a Coexistência, recurso oficial da plataforma.
- Não é intermediária das suas mensagens. Nunca lemos nem armazenamos o conteúdo das suas conversas.
E se a EasyCoexistence deixar de existir amanhã? Nada acontece com o seu número: o app continua funcionando, o histórico permanece no celular e a conexão com a API pode ser desfeita a qualquer momento. Uma ponte, não uma gaiola.
Dúvidas comuns
Quanto custa?
R$ 29,90 por número conectado, por mês, com os primeiros 7 dias grátis. Uma conta pode ter quantos números você quiser e cada um custa o mesmo, ou seja cinco números ficam R$ 149,50. Remover um número encerra a cobrança dele no fim do ciclo atual. Os custos de mensagem da Meta (templates de marketing, por exemplo) são independentes e sempre cobrados pela Meta diretamente na sua conta.
Meu número aparece como desconectado. E agora?
Primeiro abra o app no celular (a causa mais comum é a regra dos 7 dias). Depois refaça o fluxo de conexão com o mesmo número: a Meta o reconhece, mostra uma opção pré-marcada de restaurar os produtos anteriores e completa a reconexão sozinha em poucos minutos.
Como desconecto meu número?
Na página do número, no dashboard, em Remover este número. Nós revogamos o nosso acesso na Meta, o monitoramento para na hora e a cobrança daquele número encerra no fim do ciclo atual. Desconectar nunca afeta o app: conversas e histórico continuam no celular, e dá para reconectar depois refazendo o fluxo de conexão.
Meu template não envia. Por quê?
A causa mais comum: sua conta na Meta ainda não tem meio de pagamento cadastrado. Envios de template (principalmente marketing) são cobrados pela Meta na sua própria conta; cadastre um cartão no WhatsApp Manager, em faturamento, e tente de novo. Verifique também se o template foi aprovado (peça o status à sua IA).
Minhas conversas antigas vão aparecer no sistema ou na IA?
Só se você quiser. Durante a conexão, a Meta pergunta se você quer sincronizar o histórico com o lado da API, e dá para recusar. Em qualquer caso, a EasyCoexistence nunca lê nem armazena o conteúdo: o histórico permanece no seu celular, e as mensagens novas só chegam ao seu próprio sistema se você configurar o roteamento.
Funciona com número fixo?
Sim. Se o número fixo está ativo no app WhatsApp Business, ele conecta normalmente (temos clientes com número fixo conectado).
Como revogo acessos?
Para tirar o acesso de um agente de IA, remova o conector nas configurações do próprio agente. Para tirar o nosso acesso, desconecte o número (pergunta acima). Os tokens de acesso ficam criptografados e nunca são expostos a terceiros.
Guias
As explicações longas para onde todo o resto aponta.
- WhatsApp MCP server for Claude, ChatGPT and CursorConnect Claude, ChatGPT or Cursor to a real WhatsApp number over MCP. Official Cloud API, eleven tools, no linked-device workaround and no ban risk.
- WhatsApp Coexistence: the app and the API on one numberCoexistence runs the WhatsApp Business app and the Cloud API on the same number at once. What it changes, what it does not, and how a number gets connected.
- Unofficial WhatsApp APIs: what actually gets numbers bannedUnofficial WhatsApp gateways sign in as a linked device, which breaks Meta's terms. What that costs, and what the official route looks like instead.
- WhatsApp Cloud API or Coexistence: which one a number needsBoth are Meta's. One takes the number onto the API alone, the other runs the API beside the WhatsApp Business app. Which to pick, and what each costs you.
- WhatsApp webhooks: routing messages straight to your serverHow WhatsApp webhooks work, what Meta sends, and how to route incoming messages directly to your own endpoint instead of through a provider's platform.
- WhatsApp Coexistence for agencies and consultanciesConnect client WhatsApp numbers without migrating them or retraining their staff. One account, many numbers, each in the client's own Business Portfolio.
- What being a Meta Tech Provider means, and why it mattersA Tech Provider connects other businesses' WhatsApp numbers through its own Meta app. What the status requires, and what it changes for the client.
- WhatsApp Coexistence glossaryPlain definitions for the vocabulary around WhatsApp Coexistence: WABA, Business Portfolio, phone number id, templates, quality rating, Tech Provider and MCP.
Integrações
Alcançar um número conectado a partir da ferramenta que você já usa.
- Connect WhatsApp to n8n on the official Cloud APIRoute WhatsApp messages into an n8n workflow over Meta's official Cloud API, on a number the business still answers from the phone. No linked device.
- Connect WhatsApp to Claude with a custom connectorAdd EasyCoexistence as a custom connector and Claude can read, send and wire a real WhatsApp number over Meta's official Cloud API. One OAuth sign in.
- Connect WhatsApp to Make on the official Cloud APIRoute WhatsApp messages into a Make scenario over Meta's official Cloud API. Why Make uses the webhook path rather than our MCP server.
- Connect WhatsApp to Zapier on the official Cloud APITrigger a Zap from an incoming WhatsApp message over Meta's official Cloud API, and send replies back with a webhook action.
- Connect WhatsApp to ChatGPT with a custom connectorAdd EasyCoexistence as a connector in ChatGPT and it can read, send and wire a real WhatsApp number over Meta's official Cloud API.
- Connect WhatsApp to Cursor over MCPAdd EasyCoexistence to Cursor's MCP settings and send WhatsApp messages, manage templates and wire webhooks without leaving the editor.
- Connect WhatsApp to Claude Code over MCPOne command adds EasyCoexistence to Claude Code, so an agent can send WhatsApp messages, manage templates and wire webhooks from the terminal.
- Send and receive WhatsApp from PythonReceive WhatsApp messages in a Python web handler and send replies through Meta's official Cloud API, on a number a team still answers from the phone.
- Send and receive WhatsApp from Node.jsReceive WhatsApp messages in a Node handler and send replies through Meta's official Cloud API, on a number a team still answers from the phone.
Comparações
As decisões que as pessoas pesam antes de escolher.
- EasyCoexistence vs a BSP inboxA BSP gives you a shared inbox and sits in the message path. Coexistence keeps the phone and routes messages to your own systems. When each one is right.
- EasyCoexistence vs building it yourselfEverything here is Meta's documented API, so you can build it. What that actually takes, and the part that is not the building.
- EasyCoexistence vs 360dialogBoth charge per number and neither marks up Meta's fees. The difference is the price and what the fee is for. Prices as published in September 2026.
- EasyCoexistence vs WATIWATI is a shared team inbox priced per user. EasyCoexistence is a connection priced per number. Which one you need depends on whether you have a team or a system.
- EasyCoexistence vs respond.iorespond.io is a multichannel inbox with workflows and AI agents, priced per month with user and contact limits. EasyCoexistence is a connection priced per number.
- EasyCoexistence vs DualhookBoth route WhatsApp webhooks directly from Meta and neither stores messages. Where the two differ, and where Dualhook is ahead. Verified September 2026.
Primeiros passos
Conectar um número e o que acontece depois.
- Coexistence referenceWhat Coexistence is, how messages flow, what it costs, what it cannot do, eligibility, and how to roll it back. The short reference version.
- Connecting a number, step by stepWhat happens when you connect a number through Coexistence, what the business owner has to do, and what is decided once and cannot be changed.
- A number stopped working: how to find out whyA checklist in the order these failures actually happen: token, webhook override, inactivity disconnection, quality, and account restriction.
- What changes in the WhatsApp Business app after connectingEverything that stays the same on the phone after a number is connected through Coexistence, and the three things that genuinely change.
A plataforma da Meta
As contas, identificadores e verificações que existem debaixo de todo número.
- Display names on a WhatsApp business numberThe name customers see above a conversation. How approval works, what gets rejected, and which webhook reports the decision.
- Meta Business Portfolio, and what sits inside itThe company level container in Meta Business Manager. What it holds, why it matters for a client's number, and how it differs from a WABA.
- Two step verification on a WhatsApp numberThe six digit PIN set on a WhatsApp Business number, which operations require it, and what to do when nobody remembers it.
- The WhatsApp Business Account, and why overrides live on itWhat a WABA holds, why webhook overrides are applied at this level rather than per number, and what that means when a connection is removed.
Enviando mensagens
O que pode ser enviado, quando, e o que a Meta revisa antes.
- The 24 hour customer service windowWhat the customer service window is, when it opens and closes, what may be sent inside and outside it, and why replies inside it are free.
- Which WhatsApp conversations Meta charges forReplies inside the customer service window are free. What Meta charges for, who it bills, and why a provider cannot mark it up.
- WhatsApp message templatesWhat templates are, the three categories, how variables work, how review goes, and why on Coexistence they can only be sent through the API.
- Template categories: utility, marketing and authenticationThe three template categories, what belongs in each, how they differ on billing and review, and why the wrong category is a reliable rejection.
Webhooks
Como os eventos chegam nos seus sistemas, e o que vem neles.
- The account_alerts webhookMeta's general alerting channel for a business account. What arrives here, and why it is a prompt to look rather than a state change.
- The account_review_update webhookMeta reports the outcome of an account review here. What the decision field carries, and why a rejection is worth treating as a degraded connection.
- The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.
- The business_capability_update webhookHow messaging limit changes arrive. What the tier means, why it moves in both directions, and how it differs from throughput.
- WhatsApp webhook fields, and which ones go whereThe eight webhook fields a Coexistence connection uses, what each carries, and which are routed to your endpoint versus kept for monitoring.
- The phone_number_quality_update webhookWhat this webhook actually carries as of 2026, why the colour quality rating is not in it, and where the rating has to be read from instead.
- The smb_message_echoes webhookHow software sees what a human sent from the WhatsApp Business app. Only exists on Coexistence numbers, and ignoring it causes double replies.
- Verifying a WhatsApp webhook endpointMeta calls your endpoint with a GET challenge before delivering anything. What it sends, what to return, and why a wrong answer fails silently.
O conector MCP
Alcançar um número a partir de um assistente de IA.
- MCP or a webhook: which one you actually needMCP acts when asked. A webhook reacts when something happens. Why an assistant cannot answer customers on its own, and why most systems need both.
- MCP tools referenceAll eleven tools the EasyCoexistence MCP connector exposes, what each takes, and which are gated when billing lapses.
Códigos de erro
Todo erro que nossos usuários realmente encontram, da referência publicada pela Meta.
190access token expired368account restricted by policy130429throughput limit reached131026message undeliverable131031account restricted or data mismatch131042business account payment issue131047re-engagement message131048spam rate limit hit131049message blocked for ecosystem health132000parameter count mismatch132001template does not exist132015template paused for quality133010phone number not registered2593107synchronization limit exceeded2593108sync outside the 24 hour window
Suporte
Ficou com uma dúvida que não está aqui? Escreva para matheus@tonelotto.com.