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

  1. Crie sua conta e abra o dashboard.
  2. Clique em “Conectar um número”. A janela da Meta abre; entre com a conta do Facebook que administra o seu negócio.
  3. Informe o número comercial e escaneie o QR code com o app WhatsApp Business no celular.
  4. 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.

https://easycoexistence.com/api/mcp
  • 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.

Integrações

Alcançar um número conectado a partir da ferramenta que você já usa.

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.

A plataforma da Meta

As contas, identificadores e verificações que existem debaixo de todo número.

Enviando mensagens

O que pode ser enviado, quando, e o que a Meta revisa antes.

Webhooks

Como os eventos chegam nos seus sistemas, e o que vem neles.

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.

Suporte

Ficou com uma dúvida que não está aqui? Escreva para matheus@tonelotto.com.

Documentação · EasyCoexistence