Fazer um chatbot de WhatsApp em Python parece coisa de instalar uma biblioteca, mas não existe em Python um equivalente ao Baileys em que a maioria confie em produção. Na prática você escolhe entre quatro caminhos, e essa escolha define quanta manutenção vem depois. São eles a API oficial da Meta, um binding Python sobre uma biblioteca em Go, um navegador controlado por Selenium ou um gateway de WhatsApp que roda em outro lugar e entrega HTTP simples.
Os quatro caminhos
| caminho | o que é | serve para | o porém |
|---|---|---|---|
| WhatsApp Cloud API | API oficial da Meta, chamada com requests e um webhook em Flask ou FastAPI | empresa que fala com cliente em volume | verificação do negócio, template pago fora da janela de 24 h, número separado |
| neonize | SDK Python em cima do whatsmeow (Go), Apache 2.0 | script no seu próprio número | sessão, reconexão e armazenamento ficam com você |
| Automação de navegador | Selenium ou pywhatkit controlando o WhatsApp Web | envio pontual | quebra quando a página muda e precisa de navegador aberto |
| Gateway HTTP | um servidor que segura a sessão (WACrew, WAHA, Evolution API) e expõe REST | bot que convive com outro código Python | mais um serviço para hospedar |
A API oficial é a única que a Meta suporta. Os outros três conectam como aparelho a mais de um número comum, do mesmo jeito que o WhatsApp Web. Funciona, mas disparo em massa e mensagem fria são o que derruba número, então use qualquer um deles com quem já fala com você.
Python falando com um gateway auto-hospedado
Se o bot vai atender cliente no seu próprio número, o caminho com menos código em Python é um gateway que já cuida da sessão, da reconexão e da mídia. O WACrew é um desses, de código aberto (Apache 2.0), com uma API REST versionada e token Bearer, documentada em docs/api-v1.md.
Crie um token no servidor onde o coletor roda:
docker compose exec wacrew node scripts/api-token.mjs criar meu-bot --escopos read,write
Depois, em Python:
import os, uuid, requests
BASE = "https://seu-painel.exemplo.com/api/v1"
H = {"authorization": f"Bearer {os.environ['WAC_API_TOKEN']}"}
chats = requests.get(f"{BASE}/chats", params={"limit": 50}, headers=H, timeout=30).json()["data"]
slug = chats[0]["slug"]
msgs = requests.get(f"{BASE}/chats/{slug}/messages", params={"limit": 20}, headers=H, timeout=30).json()["data"]
for m in msgs:
print("eu" if m["fromMe"] else m["senderName"], m.get("text") or f"[{m['type']}]")
requests.post(
f"{BASE}/chats/{slug}/messages",
headers={**H, "idempotency-key": str(uuid.uuid4())},
json={"text": "vi aqui, já olho"},
timeout=30,
)
O cabeçalho idempotency-key importa: se o seu código repetir a chamada depois de um timeout, a segunda volta com a resposta da primeira em vez de mandar a mensagem duas vezes.
Para reagir a mensagem nova, leia os eventos (SSE) do chat:
import json
with requests.get(f"{BASE}/chats/{slug}/events", headers=H, stream=True, timeout=None) as r:
for line in r.iter_lines(decode_unicode=True):
if line and line.startswith("data: "):
msg = json.loads(line[6:])
print("nova:", msg.get("text"))
Quando você nem precisa de chatbot
Muito projeto de "chatbot de WhatsApp em Python" é, na verdade, "quero uma IA que leia meus clientes e responda do meu jeito". Para isso, escrever o bot é a camada errada: um agente de código como o Claude Code ou o Codex faz isso por um servidor MCP, sem Python no meio. O WACrew tem um (npx -y wacrew-mcp, 37 ferramentas) em que a resposta passa por uma revisão que barra texto com cara de robô e sai no ritmo de uma pessoa. Veja o servidor MCP de WhatsApp se for isso que você quer.
A API REST acima envia como você, na hora, e não aplica essa revisão. Ela devolve o mode do chat (confirm ou auto) para o seu código respeitar, mas não bloqueia nada.
Limites que vale saber
- Todo caminho não oficial depende do protocolo do WhatsApp Web. Fixe versões e conte com uma atualização de vez em quando.
- Ação de admin de grupo, pagamento e chamada ficam fora da maioria dessas bibliotecas.
- Token fica no servidor. Token
writeno navegador é token que qualquer um lê.
Perguntas frequentes
Existe biblioteca oficial de WhatsApp para Python? Não. A Cloud API da Meta é HTTP, então você chama com requests ou qualquer cliente. As bibliotecas de código aberto são da comunidade.
Um bot em Python pode usar meu número pessoal? Pelo neonize, por automação de navegador ou por um gateway como o WACrew, sim, como aparelho conectado. A Cloud API precisa de um número registrado na API.
Meu número pode ser banido? Responder quem fala com você é risco baixo. Disparo em massa e mensagem fria são o que derruba conta em cliente não oficial.
Preciso de Node.js para usar o WACrew a partir do Python? Só no servidor que roda o coletor (o Docker já traz). O seu código Python só chama HTTP.


