Como criar agente de WhatsApp para loja em 10 min

mkdir agente-loja && cd agente-loja
python -m venv .venv
source .venv/bin/activate   # no Windows: .venv\Scripts\activate
pip install flask anthropic requests

export ANTHROPIC_API_KEY="sua-chave-da-anthropic"
export WHATSAPP_TOKEN="token-do-painel-da-meta"
export WHATSAPP_PHONE_ID="id-do-numero-no-painel"
export VERIFY_TOKEN="uma-frase-que-so-voce-sabe"

import os
import requests
import anthropic
from flask import Flask, request

app = Flask(__name__)
claude = anthropic.Anthropic()  # lê ANTHROPIC_API_KEY do ambiente

GRAPH = "https://graph.facebook.com/v21.0"  # use a versão que o painel da Meta mostrar
TOKEN = os.environ["WHATSAPP_TOKEN"]
PHONE_ID = os.environ["WHATSAPP_PHONE_ID"]
VERIFY_TOKEN = os.environ["VERIFY_TOKEN"]

# Tudo o que o agente pode dizer sobre a loja. Troque pelos seus dados.
LOJA = """
Loja: Etiqueta Certa, Ipatinga (MG).
Horário: segunda a sexta, 8h às 18h; sábado, 8h às 12h.
Entrega: Ipatinga, Coronel Fabriciano e Timóteo em até 2 dias úteis.
Produtos: etiquetas adesivas para produto, para envio e de preço.
Pedido mínimo: 100 unidades.
Pagamento: Pix ou cartão.
"""

INSTRUCOES = f"""Você atende clientes da loja abaixo pelo WhatsApp.
Responda em português, curto (até 3 frases), com educação.
Use só as informações da loja. Se não souber, diga que vai chamar
um atendente e termine a resposta com a palavra ATENDENTE.
Nunca invente preço, prazo ou estoque.

{LOJA}"""

# Memória curta por cliente (some quando o servidor reinicia).
conversas: dict[str, list[dict]] = {}


def responder(cliente: str, texto: str) -> str:
    historico = conversas.setdefault(cliente, [])
    historico.append({"role": "user", "content": texto})

    resposta = claude.beta.messages.create(
        model="claude-opus-5-5",
        max_tokens=1024,
        system=INSTRUCOES,
        messages=historico[-10:],  # as 10 últimas mensagens bastam
        output_config={"effort": "low"},  # conversa simples: esforço baixo
        betas=["server-side-fallback-2026-07-01"],
        fallbacks="default",
    )

    if resposta.stop_reason == "refusal":
        texto_resposta = "Vou chamar um atendente para te ajudar. ATENDENTE"
    else:
        texto_resposta = "".join(
            bloco.text for bloco in resposta.content if bloco.type == "text"
        ).strip()

    historico.append({"role": "assistant", "content": texto_resposta})
    return texto_resposta


def enviar_whatsapp(para: str, texto: str) -> None:
    requests.post(
        f"{GRAPH}/{PHONE_ID}/messages",
        headers={"Authorization": f"Bearer {TOKEN}"},
        json={
            "messaging_product": "whatsapp",
            "to": para,
            "type": "text",
            "text": {"body": texto},
        },
        timeout=15,
    )


@app.get("/webhook")
def verificar():
    # A Meta chama isto uma vez para confirmar o webhook.
    if (
        request.args.get("hub.mode") == "subscribe"
        and request.args.get("hub.verify_token") == VERIFY_TOKEN
    ):
        return request.args.get("hub.challenge", ""), 200
    return "proibido", 403


@app.post("/webhook")
def receber():
    dados = request.get_json(silent=True) or {}
    for entrada in dados.get("entry", []):
        for mudanca in entrada.get("changes", []):
            for msg in mudanca.get("value", {}).get("messages", []):
                if msg.get("type") != "text":
                    continue  # áudio, foto etc. ficam para outro tutorial
                cliente = msg["from"]
                texto = msg["text"]["body"]
                resposta = responder(cliente, texto)
                enviar_whatsapp(cliente, resposta)
                if resposta.endswith("ATENDENTE"):
                    print(f"Chamar humano para {cliente}")  # troque por um aviso real
    return "ok", 200


if __name__ == "__main__":
    app.run(port=5000)

python app.py
# em outro terminal, abra o túnel:
ngrok http 5000