Dê a um assistente de IAum número de WhatsApp de verdade.
Um servidor MCP deixa Claude, ChatGPT ou Cursor usarem o WhatsApp diretamente: listar os seus números, checar a saúde deles, enviar mensagens e templates, e apontar webhooks para os seus próprios sistemas. O nosso roda na Cloud API oficial da Meta, então o número com que os seus clientes já falam nunca fica em risco.
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}Ao que o conector realmente se conecta
Um único servidor remoto, acessado por OAuth, chamando a Cloud API documentada da Meta num número que continua ativo no app do WhatsApp Business. Não há sessão guardada em lugar nenhum e nada roda na sua máquina.
- 1O seu assistenteClaude, ChatGPT, Cursor ou Claude Code, via MCP
- 2easycoexistence.com/api/mcpRemoto, autorizado por OAuth. Nenhuma chave é colada em lugar nenhum
- 3Meta Cloud APIOs endpoints documentados da Graph, com o token da própria conta
- 4O número do negócioConectado pela Coexistência, com o app ainda funcionando no celular
A alternativa que a maior parte da automação de WhatsApp adota é entrar como dispositivo conectado e dirigir a sessão do WhatsApp Web. Isso é contra os termos do WhatsApp, e a Meta detecta pelo formato do tráfego, não pelo código que o envia, e é por isso que uma promessa de anti-ban descreve algo que o fornecedor não consegue controlar. Nada aqui usa esse mecanismo.
Como instalar
Um único endpoint remoto, o mesmo para todos os números da conta. Não há pacote para instalar nem chave para gerar: cada cliente faz login com OAuth na primeira vez que chama uma ferramenta.
- Abra Configurações e vá até Conectores.
- Escolha Adicionar conector personalizado e cole o endpoint abaixo.
- Salve e peça ao Claude para listar os seus números. Na primeira vez ele abre um login.
https://easycoexistence.com/api/mcp- Abra Configurações, vá até Conectores, depois Avançado, e ative o Modo desenvolvedor.
- Adicione um conector com o endpoint abaixo.
- Abra um chat e peça para listar os seus números para disparar o login.
https://easycoexistence.com/api/mcp- Rode o comando abaixo em qualquer terminal.
- Rode /mcp dentro do Claude Code e autentique.
- As ferramentas ficam disponíveis em todas as sessões a partir daí.
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp- Abra Configurações e encontre a seção MCP.
- Adicione um servidor usando a configuração abaixo.
- Recarregue e peça ao Cursor para listar os seus números.
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}Conectar um número é um passo separado, feito uma única vez e que precisa de um navegador, porque o onboarding da Meta usa um popup próprio e a leitura de um QR. get_connect_link devolve esse link se você preferir que o assistente o entregue para você.
Regras que as ferramentas impõem, para o assistente não aprender do jeito difícil
send_message funciona quando o destinatário mandou mensagem para o número nas últimas 24 horas. Essas respostas são grátis. Fora disso, send_template com um template aprovado é a única coisa que é entregue, e a descrição da ferramenta diz isso, então o assistente escolhe a certa sem ninguém precisar avisar.
O app do celular não consegue enviar um template num número em Coexistência. Tudo o que é agendado, transacional ou fora da janela tem que passar pela API, e isso é boa parte do motivo de um número ser conectado.
Os envios de marketing são cobrados pela Meta no método de pagamento da conta do WhatsApp Business, configurado no WhatsApp Manager. Isso nunca passa por nós e não conseguimos adicionar um cartão pela API.
HTTPS, e num GET com hub.mode=subscribe e o seu hub.verify_token o endpoint precisa devolver o hub.challenge. Nós validamos antes da chamada, então uma URL errada falha na hora em vez de parecer conectada.
As dezesseis ferramentas do WhatsApp, e para que cada uma serve de fato
Um único conector expõe todas elas, em todos os números da conta, junto com as ferramentas de outros canais. list_numbers vem primeiro porque todas as outras ferramentas do WhatsApp recebem dela um connection_id.
list_numbersNúmeros conectados com status, classificação de qualidade e nível de mensageria. O ponto de partida para todo o resto.get_number_healthUm retrato ao vivo da Meta mais a linha do tempo recente do monitoramento: eventos de webhook e checagens periódicas juntos.get_api_credentialsURL base da Graph API, WABA id, phone number id e o token de acesso da própria conta, quando houver um disponível.
send_messageTexto livre, e só dentro da janela de atendimento de 24 horas. As respostas dentro dessa janela são grátis.send_templateÉ assim que se inicia uma conversa com alguém que não escreveu primeiro.list_templatesOs templates da conta com o status de revisão de cada um.create_templateEnvia para a revisão da Meta. UTILITY, MARKETING ou AUTHENTICATION, com variáveis no estilo {{1}} que precisam de valores de exemplo.get_template_statusAPPROVED, PENDING ou REJECTED, pelo nome do template.
set_webhook_destinationRoteia as mensagens recebidas e os ecos do app do celular da Meta direto para o seu sistema. Passe null para redefinir.get_connect_linkDevolve o link do painel e os passos para conectar um número novo, já que o onboarding precisa de um navegador.get_docsA documentação completa do produto em markdown, para o assistente responder a partir da nossa documentação em vez de chutar.
get_partner_setupEm que ponto está a configuração da Partner API: cobrança, chave de API, URL de eventos e o próximo passo.create_api_keyGera a chave da Partner API e mostra uma única vez. Só substitui uma chave existente se você confirmar.revoke_api_keyRevoga a chave da Partner API depois da sua confirmação. A partir daí, toda requisição feita com ela falha.set_partner_events_urlDefine para onde vão os eventos de status da conexão e devolve o segredo de assinatura, mostrado uma única vez.create_connect_linkCria um link de conexão hospedado para um dos seus clientes, válido por 1 hora. O número é cobrado na sua conta.
O que continua funcionando quando o pagamento falha
São bloqueadas as ferramentas que agem no mundo externo e também a get_api_credentials, porque ela entrega o token que envia. A leitura de saúde e status continua aberta, de propósito.
list_numbersget_number_healthget_template_statuslist_templatesget_connect_linkget_docsget_partner_setupcreate_api_keyrevoke_api_keyset_partner_events_url
send_messagesend_templatecreate_templateset_webhook_destinationget_api_credentialscreate_connect_link
Uma conta que não consegue ver por que está bloqueada, ou não consegue checar se os seus números estão saudáveis, não tem outro caminho de volta além de um ticket de suporte. Essas duas leituras também são aquilo de que o próprio monitoramento de saúde depende.
O par que importa se você atende outros negócios
get_connect_link devolve o link que um cliente abre para conectar o próprio número, e set_webhook_destination aponta esse número para o seu sistema no momento em que ele conecta. Juntas, elas permitem que um agente faça o onboarding de um cliente de ponta a ponta sem ninguém abrir um painel.
Uma conta comporta quantos números você precisar, cada um cobrado separadamente, e list_numbers devolve todos eles com o connection_id que todas as outras ferramentas recebem.
Ferramentas de leitura, envio, template, ligação, documentação e Partner API, todas listadas logo abaixo.
Throughput fixo de envio para um número em Coexistência, definido pela Meta. Não dá para aumentar, nem por nós nem por você.
Por quanto tempo a resposta de um cliente mantém a sessão aberta. Fora dela, só um template aprovado pode ser enviado.
O servidor é remoto, então nada roda na sua máquina e nenhuma sessão fica guardada em lugar nenhum.
Perguntas frequentes
O número do meu cliente pode ser banido por causa disso?
Não. Esta é a Cloud API oficial da Meta, alcançada pelo recurso de Coexistência da própria Meta. O risco de ban de que as pessoas falam vem de gateways não oficiais que entram como dispositivo conectado, que é um mecanismo completamente diferente.
Com quais assistentes o conector funciona?
Qualquer um que fale MCP por HTTP com OAuth: Claude, ChatGPT, Cursor, Claude Code e Codex hoje. É um endpoint remoto só, então nada roda na sua máquina.
As minhas conversas passam pelos servidores de vocês?
Não por padrão. As mensagens recebidas são roteadas da Meta direto para o webhook que você indicar, e nós não guardamos conteúdo de conversa. Guardamos apenas a conta, o status do número e as credenciais necessárias para operar e monitorar a conexão.
Posso usar um conector só para vários clientes?
Pode. Uma conta comporta quantos números você precisar, cada um cobrado como a própria conexão dele, e o conector lista todos eles. Não há restrição nenhuma para usá-lo com negócios que você atende.
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátis3 dias grátis. Nada é cobrado até o fim do teste.