EntrarComeçar teste grátis
Meta Tech Provider

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.

--scope user

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.

codex mcp login

Comando do Codex que armazena o login OAuth de um servidor; sem credencial, o Codex pode se conectar sem autenticação.

HTTPS

O que um destino de webhook direto precisa usar; ele também precisa devolver o hub.challenge no handshake GET da Meta.

20 seconds

Quanto tempo a etapa Call my webhook espera pelo {"reply"} do seu endpoint antes de falhar.

24 hours

Janela de atendimento após a última mensagem do usuário; fora dela, a Meta aceita apenas templates de mensagem.

20 msg/s

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.

Add the server, then sign in
# 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 list

Qual 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.

Call my webhook stepAn automation POSTs the message and the chat's last 10 messages, signed; return {"reply": "..."} within 20 seconds
Forward URL (Automations on)A signed copy of each Meta event goes to your code; automations keep running; you send through the Graph API
Direct destinationMeta posts straight to your endpoint; easyCoexistence never sees the messages; automations stop for that number

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:

A request for Claude Code or Codex
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

  1. Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
  2. 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.
  3. 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.
  4. Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
  5. Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
  6. 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.
Fazendo isso com o EasyCoexistence

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átis

Verificado em