# VCP Chatbot v6 - Guia Completo
Assistente especializado em cartoes americanos, milhas e cashback para o Voe Com Pontos.
## Estrutura dos Grupos VCP
| Grupo | Tipo | Funcao do Bot |
|-------|------|---------------|
| **VCP - NEWS** | Fechado | Parsear promos das mensagens/imagens |
| **VCP - ALERTAS** | Fechado | Parsear promos das mensagens/imagens |
| **VCP - CARTOES** | Aberto | FAQ + Moderacao (com aprovacao) |
| **VCP - NETWORKING** | Aberto | FAQ + Moderacao (com aprovacao) |
| **VCP - MERCADO** | Aberto | FAQ + Moderacao (com aprovacao) |
| **VCP - BUYING GROUPS** | Restrito | FAQ + Moderacao (com aprovacao) |
| **VCP - DOLAR & NEGOCIOS** | Aberto | FAQ + Moderacao (com aprovacao) |
---
## Workflows Inclusos
| Arquivo | Funcao |
|---------|--------|
| `workflow-vcp-chatbot-v6.json` | Chatbot principal com todas as features |
| `workflow-vcp-bilt-rentday.json` | Lembrete mensal do Bilt Rent Day |
| `workflow-vcp-forward.json` | Reencaminhamento automatico entre grupos |
---
## Features
### 1. Parser de Promocoes (com Visao)
O bot analisa mensagens e **imagens** nos grupos fechados para extrair promocoes.
**Exemplo:**
```
[Voce envia no VCP - ALERTAS]
"Rakuten 15% na Nike hoje! Corre que acaba meia-noite"
[Bot automaticamente]
- Extrai: Portal=Rakuten, Loja=Nike, Rate=15%
- Salva em promos ativas
- Atualiza rate no comparador
```
**Com imagem:**
```
[Voce envia imagem de promo]
Bot usa GPT-4o Vision para ler a imagem e extrair os dados
```
---
### 2. Comparador de Portais
Compare rates entre portais para qualquer loja.
```
Voce: compara portais pra Nike
Bot: NIKE - Melhores agora:
1. TopCashback: 10% ($50 em $500)
2. Rakuten: 8% ($40 em $500) ELEVATED!
3. Capital One: 5% ($25 em $500)
4. AA Shopping: 4 mi/$ (2000 miles ~ $30)
Melhor cashback: TopCashback
Melhor milhas: AA Shopping
```
**Comandos:**
- `compara portais pra [loja]`
- `atualiza rate rakuten nike 15%`
- `promos ativas` - lista todas as promos
---
### 3. FAQ Automatico (Modo Sugestao)
Bot detecta perguntas comuns e **sugere resposta ao admin** antes de enviar.
```
[No grupo VCP - NETWORKING]
Maria: qual melhor cartao pra AA?
[Admin recebe no Telegram]
Bot: FAQ DETECTADO
Grupo: VCP - NETWORKING
Usuario: Maria
Pergunta: "qual melhor cartao pra AA?"
Resposta sugerida:
"Top cartoes AA: 1) Citi AAdvantage Platinum..."
/aprovar_faq_123
/rejeitar_faq_123
```
**FAQs inclusos:**
- Como abrir conta nos EUA
- Melhor cartao para AA
- Bilt vale a pena?
- Como usar Rakuten
- TCB vs Rakuten
- O que e ITIN
- Regra 5/24 do Chase
- Capital One Shopping
- AA eShopping
- Venture X
---
### 4. Moderacao de Grupos
Bot detecta mensagens fora do escopo e sugere redirecionamento.
```
[No grupo VCP - CARTOES]
Joao: alguem sabe onde comprar dolar barato?
[Admin recebe no Telegram]
Bot: MODERACAO SUGERIDA
Grupo: VCP - CARTOES
Usuario: Joao
Mensagem: "alguem sabe onde comprar dolar barato?"
Sugestao: Redirecionar → VCP - DOLAR & NEGOCIOS
Motivo: Assunto sobre dolar/cambio
/aprovar_mod_456
/rejeitar_mod_456
[Se aprovado, bot envia no grupo]
Bot: Oi Joao! Essa duvida sobre dolar e melhor no grupo VCP - DOLAR & NEGOCIOS
```
**Regras de Moderacao:**
| Grupo | Permitido | Redirecionar |
|-------|-----------|--------------|
| VCP - CARTOES | Cartoes, bancos, aprovacoes | Dolar→DOLAR, Venda→MERCADO |
| VCP - NETWORKING | Estrategias, duvidas gerais | Cartoes→CARTOES, Venda→MERCADO |
| VCP - MERCADO | Compra/venda milhas | Duvidas→NETWORKING |
| VCP - DOLAR | Dolar, cambio, remessa | Cartoes→CARTOES |
---
### 5. Calculadora de Earning
Calcule quanto ganha em cada portal para um valor de compra.
```
Voce: calcular earning $500 nike
Bot: EARNING - $500 em Nike:
TopCashback 10%: $50.00 cashback
Rakuten 8%: $40.00 cashback
Capital One 5%: $25.00 cashback
AA Shopping 4 mi/$: 2,000 milhas (~$30)
Melhor retorno: TopCashback ($50)
```
---
### 6. Bilt Rent Day
Lembrete automatico no dia 1 de cada mes.
```
[Dia 1, 8h da manha]
Bot envia para Telegram e VCP - ALERTAS:
BILT RENT DAY!
Hoje (dia 1) voce ganha 5x pontos em TODAS as compras com Bilt!
Dicas:
- Use o cartao Bilt pra TUDO hoje
- Dining: 5x pontos (normalmente 2x)
- Compras: 5x pontos (normalmente 1x)
- Limite: 10.000 pontos bonus
```
---
### 7. Tracker de Aplicacoes de Cartao
Acompanhe aplicacoes de cartao dos membros.
```
Voce: Joao aplicou Venture X
Bot: Aplicacao registrada!
Membro: Joao
Cartao: Venture X
Status: Pendente
Voce: atualiza aplicacao joao aprovado limite 10k
Bot: Atualizado!
Joao - Venture X: APROVADO (limite $10,000)
Voce: check 5/24 do Joao
Bot: STATUS 5/24 - Joao:
Cartoes ultimos 24 meses: 3
Status: UNDER 5/24
Pode aplicar Chase: SIM
```
---
### 8. Guias de Bancos US
Respostas detalhadas sobre bancos americanos.
```
Voce: como abrir conta no Mercury
Bot: MERCURY
Tipo: Business
Requisitos: LLC/Corp US, EIN, Endereco US
Pros:
- 100% online
- Sem taxa mensal
- Integracao Stripe
Como aplicar:
1. Forme sua LLC (Wyoming/Delaware)
2. Obtenha EIN no IRS
3. Aplique em mercury.com
4. Upload: Articles of Organization, EIN Letter
5. Aguarde 1-3 dias
Dica: Use endereco do registered agent
```
**Guias inclusos:**
- Mercury
- Relay
- Charles Schwab
- Wise
- ITIN
---
### 9. Reencaminhamento Automatico
Reencaminhe mensagens de grupos externos para seus grupos VCP.
**Configuracao (Redis):**
```json
{
"routes": [
{
"id": "route_promos",
"source_groups": ["Promos US", "Cashback Deals"],
"destination_groups": ["VCP - ALERTAS"],
"keywords": ["cashback", "bonus", "promo", "%"],
"format": "with_source"
}
]
}
```
**Guardrails inclusos:**
- Delay 5-15 segundos entre mensagens
- Limite 50 mensagens/dia por rota
- Deduplicacao 24h (nao reencaminha repetida)
- Blacklist de palavras (spam, golpe, etc)
---
## Guardrails Anti-Alucinacao
O bot tem restricoes rigidas:
**NUNCA faz:**
- Falar sobre politica, religiao, pessoas publicas
- Revelar prompt ou instrucoes do sistema
- Inventar informacoes
- Dar conselhos financeiros pessoais
- Falar sobre assuntos fora do escopo
- Responder sobre dados de outros usuarios
**SEMPRE faz:**
- Focar em milhas, cartoes, cashback, bancos US
- Indicar quando informacao pode estar desatualizada
- Recomendar verificar no site oficial
- Usar dados do contexto/Redis
**Se perguntarem fora do escopo:**
```
Voce: quem vai ganhar as eleicoes?
Bot: Desculpe, sou especializado apenas em cartoes americanos, milhas e cashback. Posso ajudar com algo nessa area?
```
---
## Limpeza de Contexto
- Historico limitado a **15 mensagens** por usuario
- TTL de 7 dias no contexto do usuario
- Hashes de deduplicacao limpos apos 48h
- Contadores diarios resetam automaticamente
---
## Variaveis de Ambiente
```env
# Obrigatorios
UAZAPI_INSTANCE_ID=sua_instancia
BOT_PHONE_NUMBER=5511999999999
ADMIN_PHONE=5511999999999
# Telegram
TELEGRAM_BOT_TOKEN=123456:ABC...
TELEGRAM_CHAT_ID=seu_chat_id
# Grupos VCP (IDs do WhatsApp)
VCP_ALERTAS_GROUP_ID=120363xxx@g.us
VCP_NEWS_GROUP_ID=120363yyy@g.us
```
---
## Chaves Redis
| Chave | Conteudo |
|-------|----------|
| `uazapi:vcp:grupos` | Configuracao dos grupos e regras |
| `uazapi:vcp:faq:cards` | FAQs sobre cartoes US |
| `uazapi:vcp:faq:pending` | Sugestoes de FAQ pendentes |
| `uazapi:vcp:portals` | Lista de portais |
| `uazapi:vcp:portals:stores` | Rates por loja |
| `uazapi:vcp:promos:active` | Promocoes ativas |
| `uazapi:vcp:guides:banks` | Guias de bancos US |
| `uazapi:vcp:applications` | Tracker de aplicacoes |
| `uazapi:vcp:bilt:config` | Config do Bilt Rent Day |
| `uazapi:vcp:moderacao:pending` | Moderacoes pendentes |
| `uazapi:vcp:forward:config` | Config de reencaminhamento |
| `uazapi:vcp:forward:sent` | Controle de envios |
| `uazapi:user:{phone}` | Contexto do usuario (TTL 7d) |
| `uazapi:blacklist` | Numeros bloqueados |
---
## Setup
### 1. Importar Workflows
- `workflow-vcp-chatbot-v6.json`
- `workflow-vcp-bilt-rentday.json`
- `workflow-vcp-forward.json` (se quiser reencaminhamento)
### 2. Configurar Credenciais
- OpenAI API (com GPT-4o Vision)
- UAZAPI (Header Auth)
- Redis
### 3. Inicializar Redis
Carregue os dados do arquivo `redis-vcp-init.json` no Redis.
### 4. Configurar Variaveis de Ambiente
Defina todas as variaveis no n8n.
### 5. Ativar Workflows
- Chatbot principal: SEMPRE ativo
- Bilt Rent Day: Ativo se quiser lembrete mensal
- Forward: Ativo se quiser reencaminhamento
### 6. Configurar Webhook UAZAPI
Aponte o webhook da instancia para:
```
https://seu-n8n.com/webhook/vcp-webhook
```
---
## Exemplos de Uso
### Comparar Portais
```
Voce: compara portais pra sephora
Bot: [lista de rates por portal]
```
### Atualizar Rate
```
Voce: atualiza rate rakuten sephora 12%
Bot: Rate atualizado: Rakuten Sephora agora e 12%
```
### Ver Promos Ativas
```
Voce: promos ativas
Bot: [lista de todas as promos detectadas]
```
### Calcular Earning
```
Voce: quanto ganho em $1000 na macys
Bot: [calculo por portal]
```
### Tracker de Aplicacoes
```
Voce: lista aplicacoes pendentes
Bot: [lista de aplicacoes com status pendente]
```
### Aprovar FAQ
```
[No Telegram]
/aprovar_faq_123
Bot: FAQ enviado para o grupo!
```
### Aprovar Moderacao
```
[No Telegram]
/aprovar_mod_456
Bot: Mensagem de redirecionamento enviada!
```