Crie um bot de WhatsApp com Claude Code ou Codex, no número que você mantém no app
Adicione um servidor MCP do WhatsApp ao Claude Code ou ao Codex e deixe o agente de programação fazer a configuração: ele lê as credenciais da Cloud API do número, monta um receptor de webhook, direciona as mensagens recebidas para ele e envia uma resposta de teste a alguém que escreveu nas últimas 24 horas. No fim, você tem um agente próprio, que roda como código seu no seu servidor.
O easyCoexistence conecta à Cloud API da Meta, pela Coexistência, o número do WhatsApp Business que você mantém no app e oferece ao Claude Code e ao Codex mais de 30 ferramentas MCP para criar o seu agente: credenciais, roteamento, templates, envios de teste e automações.
Flag do Claude Code que carrega um servidor em todos os seus projetos; o escopo local padrão o carrega somente onde ele foi adicionado.
Comando do Codex que armazena o login OAuth de um servidor; sem credencial, o Codex pode se conectar sem autenticação.
O que um destino de webhook direto precisa usar; ele também precisa devolver o hub.challenge no handshake GET da Meta.
Quanto tempo a etapa Call my webhook espera pelo {"reply"} do seu endpoint antes de falhar.
Janela de atendimento após a última mensagem do usuário; fora dela, a Meta aceita apenas templates de mensagem.
Throughput fixo de um número usado ao mesmo tempo no app do WhatsApp Business e na Cloud API.
O que um agente de programação precisa para criar um agente de WhatsApp?
Quatro coisas. Um número do WhatsApp Business conectado à Cloud API da Meta pela Coexistência, para que o app continue no celular enquanto o código envia e recebe mensagens. Uma conexão MCP do Claude Code ou do Codex com esse número, que permite ao agente de programação ler credenciais, alterar o roteamento e enviar mensagens de teste sem que você precise abrir um painel. Um endereço HTTPS público para o receptor, na hospedagem onde você publica o código ou em um túnel enquanto desenvolve. E uma chave de modelo para o agente que você está criando.
Não confunda os dois agentes. O Claude Code ou o Codex é o construtor: ele só atua enquanto você trabalha com ele no terminal. O programa que ele escreve é o que responde aos clientes, e continua rodando depois que você fecha a sessão.
Como adicionar as ferramentas do WhatsApp ao Claude Code e ao Codex?
Nos dois, basta uma URL no terminal e o login é feito com OAuth, então nenhuma chave fica salva em arquivo. No Claude Code, adicione o servidor com --scope user para que ele seja carregado em todos os projetos, depois inicie o claude, execute /mcp, escolha easycoexistence e faça login no navegador. No Codex, adicione o servidor e execute codex mcp login, que armazena o login; codex mcp list mostra o que está configurado. O Codex guarda a entrada em ~/.codex/config.toml, arquivo que o app de desktop do ChatGPT e a extensão de IDE do Codex também leem.
Para conferir se funcionou, peça algo que só as ferramentas conseguem responder, como "liste meus números do WhatsApp". O agente chama list_numbers e obtém o connection_id de cada número, que todas as outras ferramentas recebem como parâmetro.
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp
# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp listQual rota o agente deve construir?
Três rotas levam a mensagem de um cliente até o seu código, e elas diferem em quanto o código precisa tratar. Para uma primeira versão, a etapa Call my webhook é a mais curta: o easyCoexistence ignora duplicatas, pausa quando você responde pelo celular e verifica a janela de 24 horas antes de chamar o seu endpoint, então o seu código só escreve a resposta. Passe para uma Forward URL ou para um destino direto quando o agente precisar de todos os eventos, e não só das mensagens que uma automação seleciona.
O que você deve pedir ao agente de programação?
Informe logo de início a rota, a linguagem e as regras, e peça um plano antes que ele escreva código. Diga quais chamadas de ferramenta ele pode fazer por conta própria: ler credenciais e documentação não traz risco, enquanto mudar para onde as mensagens vão afeta o número em uso. get_docs retorna a documentação do easyCoexistence, incluindo como um receptor autentica as entregas, para que o agente leia as regras em vez de adivinhá-las. Um prompt como este gera um receptor que você consegue revisar de uma só vez:
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
Skip message ids already handled.
On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.Como conectar o receptor e testá-lo?
Suba o servidor onde a Meta e o easyCoexistence consigam alcançá-lo por HTTPS e deixe o agente cuidar do roteamento. Na rota Forward URL, ele chama set_inbound_mode com a sua URL em um número no modo Automations on; o segredo de encaminhamento é retornado uma única vez, e o agente o grava no seu .env. Na rota direta, o endpoint precisa primeiro responder ao handshake GET da Meta; depois, o agente chama set_webhook_destination com a URL, um segredo aleatório longo no caminho dela e o seu verify token.
Para testar, mande uma mensagem para o número da empresa pelo seu próprio celular e acompanhe os logs: o receptor deve registrar o evento, o modelo deve responder e a resposta deve aparecer na conversa. Como você acabou de escrever, a janela de 24 horas está aberta, então o agente de programação também pode testar send_message para o seu próprio número.
O agente pronto ainda precisa do servidor MCP?
Não. O servidor MCP é a ferramenta do construtor, autenticada como você. O agente que você publica envia pela Graph API da Meta com o send_endpoint e o access_token retornados por get_api_credentials, que é o token da própria empresa, com escopo nos ativos de WhatsApp dela, e recebe pela rota que você configurou. Se o access_token voltou null, reconectar o número pelo painel emite um novo sem substituir um token que já funciona.
Mantenha a conexão MCP para o trabalho em torno do agente: criar templates com create_template, consultar get_number_health quando algo parecer errado e ler o log de execução de qualquer automação que repasse mensagens ao seu código.
Como configurar
- Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
- Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
- Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
- Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
- Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
- Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.
Erros comuns
- Salvar um túnel temporário como destino direto nas primeiras 24 horas. A importação única que a Meta faz dos contatos e de até 6 meses de conversas vai para essa URL e se perde quando o túnel fecha.
- Definir um destino direto em um número que executa automações. O número passa para o modo direto e as automações param; use uma Forward URL no modo Automations on para manter as duas coisas.
- Fazer commit do .env que o agente escreveu. Adicione-o antes ao .gitignore, porque quem tiver o access token pode enviar mensagens aos clientes em nome da empresa.
- Testar send_message com um contato que não escreveu nas últimas 24 horas. A Meta recusa texto livre fora da janela, então mande primeiro uma mensagem para o número pelo seu celular.
Depois, o agente roda no seu próprio servidor, e cada número é monitorado 24/7 com alertas. De R$ 29,90 até R$ 3,90 por número por mês, um valor que cai conforme você adiciona números, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Isso funciona no Cursor ou em outras ferramentas de programação?
Sim. Qualquer cliente MCP que se conecte a servidores remotos via Streamable HTTP com OAuth pode usar a mesma URL, incluindo Cursor, VS Code, Gemini CLI e Antigravity. Só o formato da configuração muda de um cliente para outro.
Em qual linguagem o agente deve ser escrito?
Em qualquer linguagem capaz de servir HTTPS e calcular um HMAC-SHA256. Node.js e Python são as escolhas mais comuns, e há exemplos testados para as duas, com verificação de assinatura, tratamento de duplicatas e a pausa quando você responde pelo celular, na página de agentes em Node.js e Python.
Preciso ter meu próprio app na Meta ou passar pelo App Review?
Não. O número entra na Cloud API pelo app da Meta do easyCoexistence e permanece no Portfólio de Negócios da própria empresa. O token que o seu código usa para enviar mensagens é o da própria empresa, então nenhum app seu na Meta é envolvido.
O agente de programação consegue criar os templates de que o agente precisa?
Sim, com create_template, e depois com get_template_status até a Meta responder, normalmente em minutos e no máximo em cerca de 24 horas. O seu agente precisa de um template aprovado para iniciar uma conversa ou para escrever depois que a janela de 24 horas se fecha.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em