🤖 WhatsApp AI Agent

Atendimento automático no WhatsApp com IA — responde clientes em segundos, 24/7, sem custo de equipe.

---

O Problema

Pequenas empresas perdem clientes por demora no atendimento. Responder cada mensagem do WhatsApp manualmente é caro, lento e impossível fora do horário comercial.

A Solução

Um agente de IA que atende seus clientes no WhatsApp automaticamente — com contexto de conversa, personalidade da sua marca e deploy em minutos.

Cliente: "Olá, vocês têm entrega para São Paulo?"
Bot:     "Oi! Sim, entregamos para todo o Brasil 🚚
          O prazo para São Paulo é de 2 a 4 dias úteis.
          Quer ver nosso catálogo?"

---

✨ Funcionalidades

• 💬 Conversa natural com memória de contexto (lembra do que foi dito antes)
• 🧠 Dual AI — funciona com OpenAI (GPT-4o) ou Anthropic (Claude)
• ⚡ Resposta rápida — processa mensagens em background, sem travar
• 🔄 Reset de conversa — cliente digita "resetar" para novo atendimento
• 🐳 Deploy com 1 comando via Docker Compose
• 🔧 Personalização fácil — edite um arquivo .txt para configurar a personalidade do bot
• 📦 Redis opcional — para escalar horizontalmente em múltiplos servidores

---

🏗️ Arquitetura

Cliente WhatsApp
      │
      ▼
Evolution API  ──── webhook ────►  FastAPI (porta 3000)
(Gateway WA)                            │
                                        ├─► Memory (Redis / RAM)
                                        │
                                        └─► AI Provider
                                              ├─ OpenAI GPT-4o
                                              └─ Anthropic Claude

---

🚀 Como Rodar

Pré-requisitos

• Docker e Docker Compose instalados
• Chave de API da OpenAI ou Anthropic
• Número de WhatsApp para o bot (chip separado recomendado)

1. Clone o repositório

git clone https://github.com/juliooidella/whatsapp-ai-agent.git
cd whatsapp-ai-agent

2. Configure o ambiente

cp .env.example .env
# Edite o .env com suas chaves de API

3. Personalize o bot

Edite prompts/system_prompt.txt com as informações da sua empresa:

• Nome e ramo de atuação
• Produtos/serviços
• Políticas de atendimento
• Tom de voz (formal, descontraído etc.)

4. Suba os containers

docker compose up -d

5. Conecte o WhatsApp

# Abra no navegador e escaneie o QR Code
http://localhost:8080

Pronto. O bot está respondendo. ✅

---

⚙️ Configuração

Todas as configurações ficam no arquivo .env:

Variável	Descrição	Padrão
AI_PROVIDER	Provedor de IA (openai ou anthropic)	openai
AI_MODEL	Modelo a usar	gpt-4o-mini
BOT_NAME	Nome do assistente	Assistente
EVOLUTION_API_KEY	Chave da Evolution API	—
EVOLUTION_INSTANCE	Nome da instância WhatsApp	minha-empresa
REDIS_URL	URL do Redis (opcional)	vazio

---

💰 Custo Estimado

Uso	Custo mensal (GPT-4o-mini)
500 mensagens/mês	~R$ 3,00
5.000 mensagens/mês	~R$ 25,00
50.000 mensagens/mês	~R$ 250,00

Valores aproximados. Preços OpenAI/Anthropic podem variar.

---

📁 Estrutura do Projeto

whatsapp-ai-agent/
├── src/
│   ├── main.py          # Webhook FastAPI
│   ├── ai_agent.py      # Lógica de IA (OpenAI / Claude)
│   ├── memory.py        # Memória de conversas
│   ├── whatsapp.py      # Cliente Evolution API
│   └── config.py        # Configurações via .env
├── prompts/
│   └── system_prompt.txt  # Personalidade do bot ✏️
├── docker-compose.yml
├── Dockerfile
├── requirements.txt
└── .env.example

---

🛠️ Desenvolvimento Local (sem Docker)

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # configure suas chaves
uvicorn src.main:app --reload --port 3000

---

🤝 Quer este bot para o seu negócio?

Este projeto é a base. Para cada cliente, adaptamos:

• Personalidade e tom de voz da marca
• Integração com sistemas existentes (CRM, ERP, estoque)
• Fluxos de atendimento específicos (agendamento, pedidos, suporte)
• Deploy em servidor dedicado ou nuvem

Entre em contato: LinkedIn · GitHub

---

📄 Licença

MIT — use, modifique e distribua à vontade.