Agente de Vendas no WhatsApp 24h com IA
Seu lead entrou às 23h. Você viu de manhã. E aí já era. Um agente de IA atende, qualifica e aquece o lead em segundos, a qualquer hora.
Como a WhatsApp Business API funciona
A Meta tem uma API oficial para enviar e receber mensagens programaticamente. Você cadastra seu número, recebe um webhook com cada mensagem nova, processa com IA e devolve a resposta em menos de 1 segundo. Um exemplo real: o agente do Gramado Plazza responde perguntas sobre o cardápio, disponibilidade de mesas e preços — 24h por dia, sem depender do gerente no celular. A Meta permite responder livremente dentro de 24h após o cliente iniciar a conversa. Fora dessa janela só funcionam templates aprovados.
Stack técnico
- WhatsApp Cloud API (Meta) — recebe e envia mensagens via webhook
- FastAPI (Python) — processa as mensagens e orquestra as chamadas
- Claude API (Anthropic) — cérebro da conversa com histórico
- Supabase — armazena histórico por número de telefone
- Railway — hospeda o servidor (grátis no plano Trial)
Prompt para Claude Code
Crie um agente de WhatsApp em Python com FastAPI.
Endpoints:
- POST /webhook: recebe mensagens da WhatsApp Cloud API
- GET /webhook: verificação do token (retorna hub.challenge)
Para cada mensagem:
1. Busca histórico no Supabase (tabela conversations, últimas 20)
2. Envia para Claude API com o system prompt do negócio
3. Salva a resposta no histórico
4. Envia resposta pelo WhatsApp
Envio de mensagem (Meta API):
POST https://graph.facebook.com/v19.0/[PHONE_ID]/messages
Headers: Authorization: Bearer [WHATSAPP_TOKEN]
Body: { "messaging_product": "whatsapp", "to": "[número]",
"type": "text", "text": { "body": "[resposta]" } }
System prompt base (adapte):
"Você é [NOME], atendente de [EMPRESA].
[Informações do negócio: produtos, preços, FAQ, o que NÃO resolve]
Seja direto. Respostas curtas. Quando o lead estiver pronto,
diga que vai conectar com o especialista humano."
Variáveis .env:
WHATSAPP_TOKEN, WHATSAPP_PHONE_ID, VERIFY_TOKEN,
CLAUDE_API_KEY, SUPABASE_URL, SUPABASE_KEY
Deploy: Railway com Dockerfile Python 3.12Custo mensal estimado
- WhatsApp Business API: grátis até 1.000 conversas iniciadas pelo negócio/mês
- Claude API (Sonnet): ~R$ 0,50 a R$ 2,00 por 100 conversas
- Railway: grátis no Trial, ~R$ 25/mês no plano pago
- Supabase: grátis até 500MB
Perguntas frequentes
Qual a diferença entre WhatsApp Business API e WhatsApp Business App?
O App é para uso manual por uma pessoa. A API é programática: permite receber e enviar mensagens via código, integrar com sistemas e automatizar respostas. A API exige cadastro no Meta Business e aprovação do número.
O agente pode responder fora das 24h da janela de atendimento?
Fora da janela de 24h após o cliente iniciar, só é possível enviar mensagens usando templates aprovados pela Meta. Para campanhas de reengajamento e follow-up, você precisa criar templates na plataforma Meta e usá-los via API.
Por que usar FastAPI e não n8n para o agente?
FastAPI dá controle total sobre o código, histórico de conversa, lógica de qualificação e integrações customizadas. O n8n é mais fácil para começar mas tem limitações de performance e custo em volume alto. Para agentes com lógica complexa, FastAPI + Python é a escolha certa.
O agente consegue enviar imagens e documentos?
Sim. A WhatsApp Cloud API suporta text, image, document, audio e interactive messages (botões e listas). O prompt pode ser adaptado para enviar PDFs, catálogos ou imagens de produto automaticamente.
Quanto tempo leva para colocar o agente no ar?
Com o prompt completo e as variáveis de ambiente configuradas, o agente fica no ar no Railway em menos de 2 horas. O processo mais demorado é a aprovação do número na WhatsApp Cloud API, que pode levar de algumas horas a 1 dia.
Quer implementar isso?
Me chama no WhatsApp. Ajudo você a configurar ou implemento pra você.
Quero ajuda no WhatsAppGastão Matos
@gastaomatos