WhatsApp dentro do Claude Code

⚡ Se você chegou aqui pelo Claude, cole isto no seu terminal

Você não precisa entender nada do que vem abaixo. Abra o Claude Code na sua máquina e mande esta frase:

Leia https://danieltoledo.com.br/whatsapp-no-claude/ e execute
o passo a passo até o fim. Pare no passo 4 e me avise, porque
esse eu preciso fazer com o celular na mão.

Ele lê esta página, instala tudo e para no ponto onde precisa de você.

O que você vai conseguir fazer depois

Você pede	O que acontece
"lista minhas últimas 10 conversas"	Ele lista, com nome e última mensagem
"o que eu combinei com o João sobre o orçamento?"	Ele varre o histórico e te responde com data e hora
"quem me mandou mensagem e eu não respondi?"	Ele acha quem ficou esperando
"manda pro Pedro que a reunião ficou pra quinta"	Ele escreve e envia
"transcreve o áudio que a Ana mandou"	Ele baixa e transcreve

Leia isto antes de começar, são 3 coisas.

1. Ocupa um dos 4 aparelhos conectados do seu WhatsApp. Se você já usa WhatsApp Web e alguma automação, conte quantos você tem ligados.

2. Só captura com o computador ligado. Se ele dormir, reconecta ao acordar e busca o que perdeu, mas tem limite. Para capturar 24 horas, tem que rodar num servidor.

3. As suas mensagens ficam num banco na sua máquina. Ninguém acessa de fora. Mas se o computador for roubado, o banco vai junto. Vale senha forte e FileVault ligado.

Antes de começar

Cole isto no terminal para ver o que já tem:

brew --version; go version; python3 --version; uv --version; ffmpeg -version | head -1

O que responder command not found, instale:

brew install go ffmpeg uv

Se faltar o Homebrew, o comando de instalação está em brew.sh.

Passo 1 · Criar a pasta e baixar o projeto

mkdir -p ~/Projetos/meu-whatsapp/{docs,scripts,dados}
cd ~/Projetos/meu-whatsapp
git clone https://github.com/verygoodplugins/whatsapp-mcp.git app

Passo 2 · Compilar a ponte

cd ~/Projetos/meu-whatsapp/app/whatsapp-bridge
go build -o whatsapp-bridge .

Demora uns 2 minutos na primeira vez. No fim aparece um arquivo de uns 28 MB.

Passo 3 · Instalar o lado Python

cd ~/Projetos/meu-whatsapp/app/whatsapp-mcp-server
uv sync

Passo 4 · Conectar o seu WhatsApp ⚠️ este é com você

Deixe o celular já aberto em Configurações → Aparelhos conectados → Conectar um aparelho antes de rodar o comando. O QR troca a cada 60 segundos.

cd ~/Projetos/meu-whatsapp/app/whatsapp-bridge
./whatsapp-bridge --full-history-pair

Aponte a câmera para o QR que aparecer no terminal.

Deu certo quando o log parar de mostrar QR e começar a listar as suas conversas.

O que é --full-history-pair: pede ao celular para mandar o histórico antigo junto. Sem ele vêm só uns 3 meses. Quem decide quanto vai é o seu celular, não dá para forçar. E só funciona na primeira conexão, então não pule.

Passo 5 · Ligar no Claude Code

claude mcp add whatsapp -- uv --directory ~/Projetos/meu-whatsapp/app/whatsapp-mcp-server run main.py

Agora feche e abra o Claude Code. Sem isso ele não enxerga. Confira com:

claude mcp list

Passo 6 · Testar

Peça ao Claude, com estas palavras:

lista as minhas últimas 10 conversas do WhatsApp

Se ele listar, acabou. Está funcionando.

Se der errado

O que aparece	O que fazer
`command not found: go`	`brew install go` e abra um terminal novo
O QR não aparece	A ponte não subiu. Veja o log em `dados/bridge.log`
O QR expira antes de você ler	Deixe o celular já na tela de conectar ANTES de rodar o comando
O Claude não vê a ferramenta	Você não reiniciou. Feche e abra o Claude Code, depois `claude mcp list`
Parou de receber mensagem	A ponte caiu. `pkill -f whatsapp-bridge` e suba de novo
`StreamReplaced` no log	Normal. Você abriu o WhatsApp Web em outro lugar, ele reconecta sozinho
Diz que o aparelho foi removido	Alguém desconectou nos aparelhos conectados. Refaça o passo 4

Se você usa WhatsApp Business

Funciona igual, o Business também aceita aparelhos conectados.

Mas atenção à ordem. Se você migrar o número de WhatsApp normal para Business depois de conectar, os aparelhos caem e você refaz o passo 4. As mensagens salvas continuam no banco, você não perde nada, mas dá trabalho.

Se você pretende virar Business, faça isso primeiro e conecte depois.

⛔ Não confunda com a API oficial do WhatsApp Business, a Meta Cloud API. Aquela é outra coisa, serve para empresa disparar mensagem em massa e não funciona com aparelho conectado. Isto aqui é para o seu WhatsApp de verdade, o que você usa no celular.

Depois que estiver rodando

Duas coisas que valem a pena, quando você já estiver usando no dia a dia:

Deixar rodando sozinho

Enquanto está na sua máquina, ele só captura com o computador ligado. Dá para mover a ponte para um servidor e aí ele roda 24 horas, religa sozinho e não depende de você deixar o computador aberto.

Transcrever áudio

Instale o whisper e o Claude passa a transcrever os áudios que você recebe:

pip3 install -U openai-whisper

Uma regra que vale mais que o resto.

Não deixe nada mandar mensagem sozinho no começo. Peça sempre para ele te mostrar o texto antes de enviar. Mensagem errada para cliente não tem desfazer, e leva bem menos tempo conferir do que consertar depois.