🤖 WhatsApp Sarcastic Bot

Um bot sarcástico e cínico que lê mensagens WhatsApp e responde com comentários noir e inteligentes.

📋 Estrutura do Projeto

whatsapp-sarcastic-bot/
├── Whatsapp_bot.ipynb          # Notebook principal com todo o código
├── bot_whatsapp.py             # Versão standalone (script)
├── .env                        # Configurações (API keys)
├── .env.example                # Template de configurações
├── requirements.txt            # Dependências Python
├── README.md                   # Este arquivo
├── logs/
│   └── bot_whatsapp.log       # Log de atividades
└── data/
    ├── conversas.json         # Histórico de conversas
    └── respostas.json         # Respostas geradas

🚀 Quick Start

1. Clonar/Baixar o Projeto

cd whatsapp-sarcastic-bot

2. Configurar Ambiente

# Criar venv
python3 -m venv venv
source venv/bin/activate  # macOS/Linux
# ou: venv\Scripts\activate  # Windows

# Instalar dependências
pip install -r requirements.txt

3. Configurar .env

# Copiar template
cp .env.example .env

# Editar com suas chaves API
nano .env

4. Executar

# Opção A: Notebook (interativo)
jupyter notebook Whatsapp_bot.ipynb

# Opção B: Script (produção)
python bot_whatsapp.py

🔑 Variáveis de Ambiente

# Google Gemini API
VITE_GEMINI_API_KEY="sua_chave_gemini"

# Anthropic Claude API
ANTHROPIC_API_KEY="sua_chave_anthropic"

# OpenAI API
OPENAI_API_KEY="sua_chave_openai"

# WhatsApp Configuration
WHATSAPP_MODE="pywhatkit"  # ou "twilio"
WHATSAPP_GROUP_NAME="Seu Grupo"
BOT_AUTO_REPLY=true
BOT_SARCASM_LEVEL="dark"

📚 Features

Core Functionality

• ✅ Detecção automática de gatilhos (@mentions, keywords, emojis)
• ✅ Respostas sarcásticas em português
• ✅ Suporte para 3 modelos IA (Claude, Gemini, GPT-4)
• ✅ Monitoramento em tempo real do WhatsApp
• ✅ Fila de mensagens com threading
• ✅ Logging completo de atividades
• ✅ Estatísticas em tempo real
• ✅ Histórico de conversas

Gatilhos (Triggers)

O bot responde automaticamente quando:

• Menção direta: @bot, @sarcasmo
• Palavras-chave: amor, trabalho, pior, melhor, incrível, odio, amo
• Emojis: 😍 🥰 😘 💕 ❤️ 😭 😢

Categorias de Resposta

• 💔 Amor/Relacionamento - Sarcasmo sobre romance
• 💼 Trabalho - Crítica cínica sobre vida profissional
• 📈/📉 Comparações - Pessimismo sobre melhor/pior
• 🌍 Geral - Observações absurdas sobre existência

🔧 Configuração Avançada

Usar Claude (Anthropic)

bot = BotSarcasticoWhatsApp(
    bot_sarcasmo=bot_sa,
    modelo_ia='Claude'
)

Usar Gemini (Google)

bot = BotSarcasticoWhatsApp(
    bot_sarcasmo=bot_sa,
    modelo_ia='Gemini'
)

Usar GPT-4 (OpenAI)

bot = BotSarcasticoWhatsApp(
    bot_sarcasmo=bot_sa,
    modelo_ia='GPT-4'
)

📊 Monitorar Atividade

# Iniciar bot
bot.iniciar_monitoramento()

# Ver estatísticas
stats = bot.obter_estatisticas()
print(stats)

# Ver relatório
bot.gerar_relatorio()

# Ver log
bot.ler_log(ultimas_linhas=30)

# Parar bot
bot.parar_monitoramento()

🛠️ Troubleshooting

.env não encontrado

# Certificar-se de executar a célula de Setup primeiro
# A célula 2 (Setup) carrega o .env automaticamente

WhatsApp Web não conecta

1. Abra https://web.whatsapp.com no navegador
2. Faça login com QR code
3. Mantenha aberto durante execução do bot

Dependências faltando

pip install --upgrade -r requirements.txt

Chaves API inválidas

# Verificar .env
cat .env

# Atualizar chaves
nano .env

📝 Logs

Todos os eventos são registrados em logs/bot_whatsapp.log:

[2024-11-08 18:23:45] 🤖 Bot Sarcástico WhatsApp Inicializado
[2024-11-08 18:23:46] 🔗 Iniciando conexão com WhatsApp Web...
[2024-11-08 18:23:47] ✅ Conectado ao WhatsApp com sucesso!
[2024-11-08 18:23:50] 📨 [João]: Que dia lindo!...
[2024-11-08 18:23:51] 📤 Resposta para [João]: Ah, a existência humana em toda a sua glória.

🔐 Segurança

• ✅ .env não é commitado ao git
• ✅ Chaves mascaradas nos logs
• ✅ Sem armazenamento de mensagens brutas
• ✅ Validação de entrada de usuário
• ✅ Sem execução de código arbitrário

📦 Dependências Principais

• pywhatkit - WhatsApp Web automation
• anthropic - Claude API
• google-genai - Gemini API
• openai - GPT API
• python-dotenv - Environment variables
• Pillow - Image processing

🚀 Deployment

Local (Desenvolvimento)

python bot_whatsapp.py

Produção (Heroku/VPS)

# Ver guia de deployment na wiki
# Requires: Python 3.8+, 512MB RAM, conexão internet

Docker

docker build -t whatsapp-bot .
docker run -e OPENAI_API_KEY=$OPENAI_API_KEY whatsapp-bot

📞 Suporte

• Issues: Abrir uma issue no GitHub
• Docs: Ver Whatsapp_bot.ipynb para exemplos
• Community: Discussões no Discord

📄 Licença

MIT License - Livre para usar e modificar

🎉 Contribuições

Contribuições são bem-vindas! Faça um fork, crie uma branch e envie um PR.

---

Desenvolvido com ❤️ e muito sarcasmo