WACrew

Guia

Chatbot de WhatsApp em Python: quatro jeitos de fazer em 2026

Como fazer um chatbot de WhatsApp em Python em 2026. API oficial, neonize, automação de navegador e uma API HTTP auto-hospedada, com código em requests e o custo de cada caminho.

Atualizado em 4 min de leitura
Nesta página
  1. Os quatro caminhos
  2. Python falando com um gateway auto-hospedado
  3. Quando você nem precisa de chatbot
  4. Limites que vale saber
  5. Perguntas frequentes

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

caminhoo que éserve parao porém
WhatsApp Cloud APIAPI oficial da Meta, chamada com requests e um webhook em Flask ou FastAPIempresa que fala com cliente em volumeverificação do negócio, template pago fora da janela de 24 h, número separado
neonizeSDK Python em cima do whatsmeow (Go), Apache 2.0script no seu próprio númerosessão, reconexão e armazenamento ficam com você
Automação de navegadorSelenium ou pywhatkit controlando o WhatsApp Webenvio pontualquebra quando a página muda e precisa de navegador aberto
Gateway HTTPum servidor que segura a sessão (WACrew, WAHA, Evolution API) e expõe RESTbot que convive com outro código Pythonmais 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 write no 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.