Documentação
Tudo sobre ligar o seu número, manter a ligação saudável e utilizá-lo a partir da sua IA ou do seu próprio sistema.
O que é a EasyCoexistence?
A EasyCoexistence coloca o número empresarial que já utiliza na WhatsApp Business Platform (Cloud API) através da funcionalidade oficial Coexistence da Meta e monitoriza a ligação permanentemente, para que nunca deixe de funcionar sem aviso.
- A aplicação no seu telemóvel continua a funcionar exactamente como antes. A Coexistência acrescenta a API ao lado dela, sem substituir nada.
- Sem migração nem conversas perdidas: o seu histórico permanece no telemóvel.
- Ligue quantos números quiser numa única conta.
- As suas conversas nunca passam pelos nossos servidores. As mensagens recebidas podem ser encaminhadas pela Meta directamente para o seu próprio sistema.
Ligar um número
- Crie a sua conta e abra o painel.
- Clique em “Ligar um número”. Abre-se a janela da Meta; inicie sessão com a conta do Facebook que gere a sua empresa.
- Introduza o seu número empresarial e leia o código QR com a aplicação WhatsApp Business no seu telemóvel.
- Concluído, normalmente em menos de 2 minutos. O número aparece no seu painel com o estado em tempo real.
O seu número é elegível? Leia primeiro
A Meta aplica algumas regras antes de permitir a Coexistência. A maioria das ligações falhadas deve-se a uma destas situações:
- O número tem de estar na aplicação WhatsApp Business, versão 2.24.17 ou posterior. As contas pessoais do WhatsApp não podem ligar-se.
- O número precisa de actividade real e recente de conversas nos dois sentidos. Números acabados de criar ou inactivos são recusados.
- O número não pode estar associado a outra plataforma ou fornecedor de API (remetentes de mensagens em massa, CRMs, ferramentas de automatização). Desligue-o primeiro dessa plataforma e tente novamente.
- A verificação em dois passos ou um emparelhamento de dispositivo pendente na aplicação também podem bloquear a configuração.
Se a Meta indicar que o número está “registado numa conta WhatsApp existente”, NÃO elimine a conta WhatsApp do seu telemóvel; o número tem de continuar activo na aplicação. Liberte-o da outra plataforma.
O que muda na aplicação (as contrapartidas)
Activar a Coexistência desactiva algumas funcionalidades da aplicação, todas em conversas individuais (1:1). Conheça-as antes de ligar o número:
- As mensagens temporárias são desactivadas nas conversas 1:1.
- As mensagens de visualização única são desactivadas nas conversas 1:1.
- A partilha de localização em tempo real é desactivada nas conversas 1:1.
- Listas de transmissão: não pode criar novas listas e as existentes passam a ser apenas de leitura.
- Durante a configuração, todos os dispositivos ligados são desligados e precisam de voltar a ser ligados. O WhatsApp para Windows e o WearOS deixam de ser suportados.
- Os grupos, as chamadas, o catálogo e o estado continuam a funcionar na aplicação, mas não aparecem no lado da API.
- O número fica sujeito a um limite combinado de processamento da API de 20 mensagens por segundo. A utilização diária para conversas não é afectada.
Utilize-a a partir da sua IA (um conector por conta)
Toda a sua conta recebe um único URL de conector. Funciona para todos os números que ligar, actuais e futuros: a sua IA vê todos os seus números e escolhe o correcto para cada tarefa.
- Claude (web ou computador): Definições → Conectores → Adicionar conector personalizado e cole o URL.
- ChatGPT: Definições → Conectores → Avançadas, active o modo de programador e adicione o URL.
- Claude Code (terminal): claude mcp add --transport http easycoexistence https://easycoexistence.com/api/mcp
- Quando lhe for pedido, inicie sessão com o seu email e palavra-passe da EasyCoexistence e autorize o acesso.
Depois, basta pedir: “envia uma mensagem a partir do meu número”, “cria um template promocional”, “o meu número está saudável?”, “encaminha as mensagens recebidas para o meu sistema”.
O que a sua IA pode fazer (ferramentas)
- list_numbers: todos os seus números com estado, qualidade e nível.
- get_number_health: um instantâneo em tempo real da Meta, além da cronologia recente de eventos.
- send_message: resposta livre dentro da janela de serviço de 24 horas.
- create_template, get_template_status, list_templates: criar e acompanhar templates de mensagens.
- send_template: iniciar conversas com um template aprovado.
- get_api_credentials: IDs, endpoints e token para ligar o seu próprio sistema.
- set_webhook_destination: encaminhar as mensagens recebidas directamente da Meta para o seu webhook.
- get_connect_link: como integrar outro número.
- get_docs: esta documentação, para que a sua IA possa responder a perguntas sobre o produto.
Regras de envio (definidas pela Meta, não por nós)
- Responder é livre: pode responder directamente a qualquer pessoa que lhe tenha enviado uma mensagem nas últimas 24 horas.
- Para iniciar uma conversa é necessário um template pré-aprovado.
- Na Coexistência, os templates só podem ser enviados através da API; a aplicação do telemóvel não os pode enviar.
- As mensagens de marketing são facturadas pela Meta através do método de pagamento da sua própria WhatsApp Business Account. Nunca aplicamos uma margem sobre as mensagens.
- A Meta limita o processamento da API dos números com Coexistência; o envio diário de mensagens pelo telemóvel não é afectado.
Ligue o seu próprio sistema
A página de cada número no painel mostra o URL base da API, os IDs da conta e do número de telefone e o token de acesso: tudo o que o n8n, um CRM ou código personalizado precisa para enviar através da Cloud API oficial. Para receber, peça à sua IA que encaminhe as mensagens recebidas para o seu webhook (set_webhook_destination): a Meta entrega-as directamente ao seu endpoint, sem nunca tocar nos nossos servidores.
Monitorização e a regra dos 14 dias
Monitorizamos permanentemente todos os números ligados (estado da ligação, classificação de qualidade e nível de mensagens) através de webhooks da Meta e verificações periódicas. Se a aplicação empresarial no telemóvel passar cerca de 14 dias sem ser aberta, a Meta pode remover silenciosamente a ligação de Coexistência. Assim que algo falha, o seu painel mostra o problema e o respectivo motivo. Regra prática: continue a utilizar a aplicação normalmente.
O que a EasyCoexistence não é
- Não é uma caixa de entrada nem um chatbot. As conversas continuam a acontecer na sua aplicação, na sua IA ou no seu próprio sistema; não acrescentamos outro painel para utilizar.
- Não é uma ferramenta de mensagens em massa. As regras da Meta continuam a aplicar-se: respostas dentro da janela de 24 horas e templates para iniciar conversas.
- Não é um produto da Meta. Somos um Tech Provider independente que utiliza a Coexistência, a funcionalidade oficial da plataforma.
- Não somos intermediários das suas mensagens. Nunca lemos nem armazenamos o conteúdo das suas conversas.
E se a EasyCoexistence desaparecer amanhã? Nada acontece ao seu número: a aplicação continua a funcionar, o seu histórico permanece no telemóvel e a ligação à API pode ser desfeita a qualquer momento. Uma ponte, não uma prisão.
Perguntas frequentes
Quanto custa?
Depende de quantos números liga, porque o preço por número diminui à medida que a quantidade aumenta: US$ 9 por cada um até três números, US$ 7 de quatro a dez e até US$ 2 por cada um a partir de cem. Cinco números custam US$ 35 por mês. Os primeiros 7 dias são gratuitos, remover um número interrompe a cobrança no final do ciclo e os custos das mensagens da Meta são separados e sempre facturados directamente pela Meta à sua própria conta.
O meu número aparece como desligado. E agora?
Abra primeiro a aplicação no seu telemóvel (a causa mais comum é a regra dos 14 dias). Depois, volte a executar o processo de ligação com o mesmo número: a Meta reconhece-o, mostra uma opção previamente seleccionada para restaurar os produtos anteriores e conclui a ligação novamente por si só em poucos minutos.
Como desligo o meu número?
Na página do número no painel, em Remover este número. Revogamos o nosso próprio acesso na Meta, a monitorização pára imediatamente e a cobrança desse número termina com o ciclo actual. Desligar o número nunca afecta a aplicação: as conversas e o histórico permanecem no telemóvel e pode voltar a ligá-lo mais tarde executando novamente o processo de ligação.
O meu template não é enviado. Porquê?
A causa mais comum é a sua conta Meta ainda não ter um método de pagamento. Os envios de templates, sobretudo de marketing, são facturados pela Meta à sua própria conta; adicione um cartão no WhatsApp Manager, em facturação, e tente novamente. Verifique também se o template foi aprovado (peça à sua IA o respectivo estado).
As minhas conversas antigas vão aparecer no meu sistema ou na minha IA?
Só se quiser. Durante o processo de ligação, a Meta pergunta se pretende sincronizar o histórico das conversas com o lado da API, e pode recusar. Em qualquer dos casos, a EasyCoexistence nunca lê nem armazena o conteúdo: o histórico permanece no telemóvel e as mensagens novas só chegam ao seu próprio sistema se configurar o encaminhamento.
Funciona com um número de telefone fixo?
Sim. Se o número fixo estiver activo na aplicação WhatsApp Business, liga-se normalmente (temos clientes com números fixos ligados).
Como revogo o acesso?
Para remover o acesso de um agente de IA, elimine o conector nas definições do próprio agente. Para remover o nosso acesso, desligue o número (consulte a pergunta acima). Os tokens de acesso são armazenados de forma encriptada e nunca são expostos a terceiros.
Guias
As explicações mais longas para as quais tudo o resto remete.
- 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.
- What WhatsApp Coexistence costs, provider by providerWhat each provider charges to hold WhatsApp numbers, at one, ten and fifty numbers. Figures from their own pricing pages, September 2026.
- WhatsApp Coexistence glossaryPlain definitions for the vocabulary around WhatsApp Coexistence: WABA, Business Portfolio, phone number id, templates, quality rating, Tech Provider and MCP.
- Can you use the WhatsApp Business app and the API on the same number?Yes. Coexistence is Meta's official feature for running the WhatsApp Business app and the Cloud API on one number at once. How it works and what changes.
- How to connect WhatsApp to an API without losing your chatsConnecting a WhatsApp Business number to the Cloud API without losing conversations. Why chats stay on the phone and what actually syncs.
- The cheapest way to get the WhatsApp Business APIWhat the WhatsApp Business API actually costs: Meta's conversation fees versus provider fees, and how to pay the least.
Integrações
Aceder a um número ligado a partir da ferramenta que já utiliza.
- 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 ponderam 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 WhatsApp inbox priced per seat with contact limits. EasyCoexistence charges per connected number and routes messages to your own system.
- EasyCoexistence vs respond.ioRespond.io is a multichannel inbox priced per seat and contact. EasyCoexistence charges per connected number, with no seats and nothing per message.
- EasyCoexistence vs DualhookBoth route WhatsApp webhooks directly from Meta and neither stores messages. Where they differ on price, tooling and what survives a reconnection.
- EasyCoexistence vs AiSensyAiSensy is a WhatsApp campaign platform sold on monthly plans. EasyCoexistence charges per connected number and delivers messages to your own system.
- EasyCoexistence vs InteraktInterakt is a WhatsApp commerce platform with per-agent plans. EasyCoexistence charges per connected number, with no seats and nothing per message.
- EasyCoexistence vs DoubleTickDoubleTick is a WhatsApp sales inbox priced per user. EasyCoexistence charges per connected number and routes messages into the CRM you already use.
- EasyCoexistence vs ZokoZoko is a WhatsApp commerce platform built for Shopify. EasyCoexistence is the layer underneath, charging per connected number with no seats.
- EasyCoexistence vs TrengoTrengo is a multichannel team inbox priced per user. EasyCoexistence charges per connected number and delivers WhatsApp to your existing helpdesk.
- EasyCoexistence vs RasayelRasayel is a WhatsApp sales inbox priced per user. EasyCoexistence delivers the conversation straight into your CRM, charging per connected number.
- EasyCoexistence vs CallbellCallbell is a small-team WhatsApp inbox priced per user. EasyCoexistence charges per connected number, so headcount never enters the bill.
- EasyCoexistence vs BaileysBaileys is an open-source linked-device library, which breaches WhatsApp's terms. EasyCoexistence connects the same number through Meta's own API.
- EasyCoexistence vs WPPConnectWPPConnect automates WhatsApp Web in a browser session, against WhatsApp's terms. EasyCoexistence uses Meta's official Cloud API through Coexistence.
- EasyCoexistence vs Evolution APIEvolution API wraps unofficial WhatsApp libraries behind a REST interface. EasyCoexistence uses Meta's official Cloud API, so the number cannot be banned.
- EasyCoexistence vs WhapiWhapi is a hosted unofficial gateway, so the number is reached outside Meta's API. EasyCoexistence connects it officially through Coexistence.
- The best WhatsApp Coexistence providersEvery provider that supports WhatsApp Coexistence, what each charges and who each suits. Prices from their own published pages, September 2026.
- The best WhatsApp Cloud API providersWhatsApp Cloud API providers compared by how they charge: per message, per seat, or per number. Prices from their own published pages.
- The best WhatsApp MCP serversWhatsApp MCP servers compared. Most open-source ones drive an unofficial bridge that risks a ban. EasyCoexistence runs on Meta's official Cloud API.
- EasyCoexistence vs TwilioTwilio adds a published per-message fee on top of Meta's. EasyCoexistence charges a flat monthly fee per number and never touches the message bill.
- EasyCoexistence vs GupshupGupshup publishes a per-message fee on top of Meta's. EasyCoexistence charges per number, so the cost stops moving once the number is connected.
- EasyCoexistence vs InfobipInfobip is enterprise CPaaS priced per country through sales. EasyCoexistence publishes one price list and connects a number in minutes.
- EasyCoexistence vs YCloudBoth support Coexistence with no per-message markup. YCloud sells a platform in seat-based tiers; EasyCoexistence sells infrastructure per number.
- EasyCoexistence vs SleekFlowSleekFlow is a seat-priced messaging platform with a minimum seat count. EasyCoexistence charges per connected number with no seats at all.
- EasyCoexistence vs BirdBird quotes one blended per-message rate with Meta's fee inside it. EasyCoexistence charges per number and leaves the Meta invoice untouched.
- EasyCoexistence vs ZenviaZenvia sells monthly software plans plus channel packages. EasyCoexistence charges one published fee per connected number, in reais or dollars.
- EasyCoexistence vs 8x88x8 is enterprise CPaaS with good Coexistence documentation. EasyCoexistence is the self-serve product that does what those docs describe.
Primeiros passos
Ligar um número e o que acontece a seguir.
- 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.
- Which WhatsApp features stop working after CoexistenceDisappearing messages, view once, live location and broadcast lists are switched off on a connected number. What each one means in practice.
- Which numbers are eligible for CoexistenceThe app version, the account type, the portfolio access, and what actually makes Meta refuse a number during Coexistence onboarding.
- Rate limits and messaging throughputThe four separate WhatsApp Cloud API limits: messaging tier, throughput, per-recipient pairing and management calls.
- 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.
- What syncs to the API, and what does notContacts and one-to-one history cross over. Groups, catalog, labels, quick replies and away messages do not. The complete list, in one place.
A plataforma Meta
As contas, identificadores e etapas de verificação subjacentes a cada 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.
Enviar mensagens
O que pode ser enviado, quando e o que a Meta verifica primeiro.
- 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.
- Message reactions: sending and receiving emojiSending and receiving WhatsApp message reactions through the Cloud API, including how a removed reaction arrives.
- 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.
- Sending a template with variablesHow to fill WhatsApp template variables correctly: positional parameters, component lists, and the errors each mistake produces.
- Sending interactive messages: buttons and listsWhatsApp interactive messages: reply buttons, list messages, their exact limits and how replies come back on your webhook.
- Sending location and contact messagesSending location pins and contact cards through the WhatsApp Cloud API, and why live location is unavailable on a Coexistence number.
- Sending media: images, video, audio and documentsSending images, video, audio and documents on the WhatsApp Cloud API: size limits, supported formats, and why uploading beats linking.
- 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.
- Template components: header, body, footer and buttonsThe four parts of a WhatsApp message template, what each one allows, and which of them accept variables.
- The template status lifecycleEvery state a WhatsApp template passes through, from submission to permanent disabling, and which webhook reports each one.
Webhooks
Como os eventos chegam aos seus sistemas e o que contêm.
- 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 history webhookThe one time chat history transfer on a Coexistence number is delivered on this field. What arrives, when, and why it happens only once.
- The message_template_quality_update webhookMeta reports a template's quality moving here, before it results in a pause. What the signal means and why it is worth acting on early.
- The message_template_status_update webhookMeta reports template approvals, rejections and disabling here. What each status means and why it removes the need to poll.
- The messages webhookEverything a customer sends arrives on this field. What the payload carries, how to acknowledge it, and why it never reaches a provider on a routed number.
- The phone_number_name_update webhookMeta reports display name approvals and rejections here. It is the only place the decision appears, and nothing shows it in the app.
- 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_app_state_sync webhookContact synchronisation from the WhatsApp Business app arrives on this field. What it carries and why it is separate from message history.
- 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.
- The template_category_update webhookMeta can move a template between utility, marketing and authentication after approval. This reports it, and it changes what each send costs.
- 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
Aceder a 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
Todos os erros que os nossos utilizadores encontram, a partir da referência publicada pela Meta.
100invalid parameter190access token expired368account restricted by policy80007rate limit on the WhatsApp Business Account130429throughput limit reached130497recipient country not allowed131000something went wrong131008required parameter missing131009invalid parameter value131016service unavailable131021sender and recipient are the same131026message undeliverable131031account restricted or data mismatch131042business account payment issue131045phone number not registered131047re-engagement message131048spam rate limit hit131049message blocked for ecosystem health131050the user has opted out131051unsupported message type131052media download failed131053media upload failed131056too many messages to one recipient132000parameter count mismatch132001template does not exist132007template policy violation132012template parameter format mismatch132015template paused for quality132016template is permanently disabled133005incorrect two-step verification PIN133006phone number not verified133008too many PIN guesses133010phone number not registered2593107synchronization limit exceeded2593108sync outside the 24 hour windowcodesWhatsApp Cloud API error codes
Apoio
Tem uma pergunta que não é respondida aqui? Escreva para matheus@tonelotto.com.