WACrew

Guia

Como integrar o WhatsApp com o Claude (Desktop e Claude Code)

Integre o WhatsApp com o Claude por um servidor MCP de código aberto. O Claude lê grupos e conversas, transcreve áudio e rascunha respostas que você aprova. Configuração no Claude Desktop e no Claude Code.

Atualizado em 3 min de leitura
Nesta página
  1. O que o Claude passa a fazer
  2. Em qual app do Claude
  3. Passo a passo
  4. O que pedir ao Claude
  5. Limites
  6. Perguntas frequentes

Pra integrar o WhatsApp com o Claude você precisa de duas peças: algo ligado ao seu número que guarde o histórico, e uma ponte que o Claude consiga chamar. O WACrew faz as duas. O coletor roda no seu servidor e guarda todos os grupos e conversas; o servidor MCP (wacrew-mcp, no npm) dá ao Claude 37 ferramentas sobre esses dados.

Dados conferidos em 16 de novembro de 2026.

O que o Claude passa a fazer

  • Responder "quem está esperando resposta?" em todos os chats, com quanto tempo cada um espera.
  • Ler o grupo de um cliente, inclusive os áudios (ele transcreve) e os prints (ele enxerga a imagem).
  • Buscar no histórico inteiro, dentro das transcrições também.
  • Rascunhar a resposta com o seu jeito de escrever e enviar só depois do seu OK, em ritmo de gente (visto, digitando, pausa).
  • Guardar notas, etiquetas e estado de contrato por cliente.

Em qual app do Claude

AppFunciona?Como
Claude CodeSimclaude mcp add, um comando
Claude DesktopSimclaude_desktop_config.json, servidor local
claude.ai no navegadorNão diretolá os conectores personalizados apontam pra servidor remoto; o MCP do WACrew roda local

Passo a passo

  1. Suba o painel do WACrew numa VPS ou na Railway (Docker) e leia o QR code pelo WhatsApp. Os comandos estão no README.
  2. No Claude Code:
claude mcp add wacrew \
  -e WAC_CLOUD_URL=https://seu-painel.exemplo.com \
  -e WAC_CLOUD_USER=admin \
  -e WAC_CLOUD_PASS=troque-esta-senha \
  -- npx -y wacrew-mcp
  1. No Claude Desktop, o mesmo servidor vai no claude_desktop_config.json:
{
  "mcpServers": {
    "wacrew": {
      "command": "npx",
      "args": ["-y", "wacrew-mcp"],
      "env": { "WAC_CLOUD_URL": "https://seu-painel.exemplo.com", "WAC_CLOUD_USER": "admin", "WAC_CLOUD_PASS": "troque-esta-senha" }
    }
  }
}
  1. Reinicie o app e comece por um pedido só de leitura.

O que pedir ao Claude

Quem está esperando resposta agora? Agrupa por cliente.
Resume o que o cliente pediu no grupo "App da Acme" nesta semana, incluindo os áudios.
Rascunha a resposta pra última mensagem desse grupo e me mostra antes de enviar.

Limites

  • O Claude só age com uma sessão aberta. Pra ser avisado de mensagem nova no Claude Code, o WACrew traz a skill plantao, que acorda o agente quando alguém escreve.
  • Todo chat começa no modo confirmar: o Claude mostra o texto e espera o seu OK. O automático é escolha por chat.
  • O WACrew conecta como aparelho vinculado, fora da API oficial do WhatsApp Business. Use nas suas próprias conversas, não pra disparo em massa.

Perguntas frequentes

Precisa da API oficial do WhatsApp Business? Não. O WACrew conecta no seu número como aparelho, igual ao WhatsApp Web, sem aprovação da Meta nem tarifa por mensagem.

O Claude manda mensagem sozinho? Só nos chats em que você ligar o automático. No padrão ele rascunha, você aprova, e aí ele envia.

Funciona com mais de um número? Funciona. Um servidor MCP fala com vários painéis, e toda ferramenta aceita o parâmetro conta.

Meus dados vão pra Anthropic? Só o que o Claude lê durante a sua sessão vai pro modelo, como em qualquer conversa com o Claude. O histórico fica no seu servidor.

O passo a passo completo no terminal está em WhatsApp MCP no Claude Code.