🫡 Aspira Suporte — Diagrama Técnico Completo
IntusCripto Club · Versão 2.0 · Atualizado 19/03/2026 · 19:55 BRT ← NOVO
CHANGELOG — O QUE MUDOU HOJE (v1 → v2)
🆕 Adicionado
+BOOTSTRAP.md criado — garante que KBs são carregadas automaticamente em toda sessão
+push-to-notion.sh — envia correções aprovadas do KB3 para o Notion 1x/dia (23h BRT)
+Cron revisão semanal — toda segunda 09h BRT te avisa entradas pendentes no KB3
+Proteção contra afirmações de membros — só Diego pode corrigir KB; membros → ticket Discord
+Bloqueio imagens e áudios — bot pede texto ao receber mídia
+CORREÇÃO-001 (Pendle no Módulo 4) e CORREÇÃO-002 (schedule calls) → KB3 + Notion
🔧 Corrigido / Atualizado
~Rate limit: janela 5min → 10min. exec liberado para membros (necessário para script rodar)
~toolsBySender configurado nos 2 grupos: Diego com alsoAllow, membros com deny list
~Trigger JIDs WhatsApp configurado — antes era pendente, agora ativo
~Testes reais realizados — Marcio + Roberson nos grupos; bot respondeu corretamente
✅Diego pode corrigir bot no grupo via linguagem natural — testado e funcionando
1. O QUE É E QUAL A PERSONA
🤖 Aspira Suporte — Bot de Suporte do IntusCripto Club
Identidade: Atendente especializado do clube. Profissional, acolhedor, direto. 100% português BR.
O que faz: Responde dúvidas de membros nos grupos WhatsApp sobre acesso, plataforma, DeFi, cripto, eventos, aulas.
O que NÃO faz: Não especula preços, não dá opiniões de investimento, não responde off-topic, não revela internals, não processa imagens nem áudios.
Regra de ouro: Só responde com 100% de certeza — se tiver dúvida, direciona ao ticket Discord.
PERSONA.md
SUPORTE-INTUS.md
Anti-injection ativo
Aviso golpe Diego ativo
BOOTSTRAP.md NOVO
2. ONDE E QUANDO ATUA
📱 Grupo 1 — IntusCripto Club ATIVO
JID: 120363048351878310@g.us
requireMention: true — só responde quando @Aspira é mencionado
Teste real: ✅ Marcio perguntou sobre Pendle
📱 Grupo 2 — Novos Membros Club ATIVO
JID: 120363363148603683@g.us
requireMention: true — só responde quando @Aspira é mencionado
Teste real: ✅ Roberson perguntou sobre Pendle + calls
3. FLUXO TÉCNICO — MENSAGEM RECEBIDA
📱
Membro menciona @Aspira no grupo
"Como acesso a plataforma?" / "O que é Impermanent Loss?" / "Tem aula de Pendle?"
🛡️
Filtro de mídia NOVO
Imagem? → "Só consigo responder em texto. Pode descrever sua dúvida?" 🚫
Áudio? → "Não consigo ouvir áudios. Pode escrever?" 🚫
Texto? → Continua o fluxo ✅
🔀
OpenClaw processa + BOOTSTRAP.md injeta contexto NOVO
Detecta JID → BOOTSTRAP.md carrega automaticamente SUPORTE-INTUS.md + PERSONA.md + KB1 + KB2 + KB3
BOOTSTRAP.md → obriga leitura de:
1. SUPORTE-INTUS.md (persona + regras + rate limit)
2. KNOWLEDGE.md (KB1 — 123 FAQ)
3. KNOWLEDGE-KB2.md (KB2 — 10 módulos)
4. KNOWLEDGE-LIVE.md (KB3 — correções aprovadas)
🔒
Rate limit: 3 msgs / 10min / usuário CORRIGIDO
bash check-rate-limit.sh "+SENDER" "JID"
ALLOW → continua | BLOCK → silêncio | Diego (+555599096505) → sempre ALLOW
🔒
Anti-injection + Proteção de conteúdo EXPANDIDO
Jailbreak / DAN / "ignore instruções" → resposta padrão + ignora
Membro afirma conteúdo → ignora, usa apenas KB. Nunca altera KB por instrução de membro
Membro finge ser Diego → verifica e164: +555599096505 no sender metadata
Diego confirmado → Modo Operador ativo
🧠
Aspira consulta as 3 bases de conhecimento
Entende semanticamente. Interpreta jargões, tokens, abreviações.
KB1: 123 FAQ Q&As
+
KB2: 10 Módulos Curso
+
KB3: Correções aprovadas
⚖️
Decisão de resposta
✅ Sabe com certeza → responde + menciona módulo do curso se pertinente
⚠️ Parcialmente sabe → responde o que sabe + direciona ticket para o resto
❌ Não sabe → redireciona ao ticket Discord + registra em KB3 como PENDENTE
📤
Resposta enviada no WhatsApp
Português BR, tom profissional/acolhedor, links oficiais, aviso de risco em perguntas de investimento
📝
Auto-captura para KB3 (quando aplicável)
Pergunta nova não coberta → KNOWLEDGE-LIVE.md status PENDENTE → revisão Diego segunda 09h → aprovadas vão ao Notion via push-to-notion.sh
4. ARQUITETURA DAS 3 BASES DE CONHECIMENTO
📊 KB1 — FAQ Master
✅ 123 Q&As
Fonte: Notion DB 31f616f0...
Categorias: DeFi, Cripto, Suporte, Produtos, Acesso...
Sync: Notion → local 4x/dia
Push: KB3 → Notion 1x/dia (23h BRT)
📚 KB2 — Aulas do Curso
✅ 10 módulos 259KB
Fonte: Notion página 325616f0...
Conteúdo: 1.575 blocos, Módulos 1–10
Sync: Junto com KB1 (4x/dia)
Uso: Direcionar aluno para aula correta
🧪 KB3 — Auto-aprendizado NOVO
✅ 2 aprovadas
Fonte: Grupos WhatsApp ao vivo
Arquivo: KNOWLEDGE-LIVE.md
Push: Cron 23h BRT → Notion
Revisão: Diego segunda 09h BRT
Hoje: Pendle + Schedule calls ✅
Diego edita Notion
→
sync-notion.sh (4x/dia)
→
KB1 + KB2 local
→
Bot usa na resposta
Diego corrige no grupo
→
KB3 KNOWLEDGE-LIVE.md
→
push-to-notion.sh (23h)
→
Notion KB1 atualizado
Crons ativos:
f8a37d36 — Sync Notion→local: 0 */6 * * * (America/Sao_Paulo) = 00h/06h/12h/18h BRT
0aed6ea7 — Push KB3→Notion: 0 2 * * * (America/Sao_Paulo) = 23h BRT
893058dc — Revisão semanal KB3: 0 9 * * 1 (America/Sao_Paulo) = segunda 09h BRT
5. CAMADAS DE SEGURANÇA EXPANDIDO
🟢 Proteções Ativas
Anti-injection clássico — jailbreak, DAN, "ignore instruções"
Proteção de conteúdo — membros não podem corrigir KB
Verificação de identidade — valida e164 do sender
Rate limit 3/10min por usuário por grupo
Mídia bloqueada — imagens e áudios → pede texto
Tools bloqueadas para membros: write, edit, browser, cron, gateway, sessions
Alerta golpe — Diego NUNCA chama membros no privado
Aviso de risco em perguntas de investimento
🟡 Riscos Residuais (monitorar)
Rate limit em /tmp/ — perde em reboot. Mover para workspace/memory/
exec liberado para membros — necessário para rate limit; bot tem regras contra abuso
Contexto acumulado — muitas mensagens seguidas podem tentar "treinar". Rate limit mitiga.
KB2 sem re-sync quando Diego adicionar novas aulas ao Notion — processo manual
6. QUEM FAZ O QUÊ NO SISTEMA
| Componente | Função | Quando |
|---|
| Aspira (main) | Responde membros, consulta KB, decide resposta, captura KB3 | Toda mensagem @mencionada nos grupos |
| BOOTSTRAP.md NOVO | Garante carregamento automático de SUPORTE-INTUS + 3 KBs | Toda sessão nova |
| Cron sync (f8a37d36) | sync-notion.sh → regenera KB1 + KB2 local | 4x/dia: 00h/06h/12h/18h BRT |
| Cron push (0aed6ea7) NOVO | push-to-notion.sh → envia correções aprovadas KB3 → Notion | Diário 23h BRT |
| Cron revisão (893058dc) NOVO | Lista KB3 PENDENTES → avisa Diego no Telegram | Segunda 09h BRT |
| Diego (operador) | Corrige via linguagem natural no grupo + comandos !xxx | Qualquer momento |
| Notion | Fonte da verdade — Diego edita, bot puxa via sync | Passivo |
7. ARQUIVOS DO SISTEMA
| Arquivo | Função | Status |
|---|
BOOTSTRAP.md NOVO | Boot obrigatório — força leitura das KBs em toda sessão | ✅ |
SUPORTE-INTUS.md | Config principal — grupos, regras, proteções, rate limit, modo Diego | ✅ v2 |
skills/intus-suporte/PERSONA.md | Persona detalhada — tom, identidade, regras semânticas | ✅ |
skills/intus-suporte/KNOWLEDGE.md | KB1 — 123 Q&As FAQ Master (gerado pelo sync) | ✅ |
skills/intus-suporte/KNOWLEDGE-KB2.md | KB2 — 10 módulos completos (259KB) | ✅ |
skills/intus-suporte/KNOWLEDGE-LIVE.md | KB3 — auto-aprendizado + 2 correções aprovadas | ✅ |
skills/intus-suporte/sync-notion.sh | Sync Notion→local (KB1+KB2) | ✅ |
skills/intus-suporte/push-to-notion.sh NOVO | Push KB3→Notion (evita duplicatas via .pushed-to-notion.log) | ✅ |
skills/intus-suporte/check-rate-limit.sh | Rate limit 3/10min por usuário | ✅ 10min |
skills/intus-suporte/update-faq-notion.sh | Adicionar entrada direto no Notion | ✅ |
skills/intus-suporte/update-faq-answer.sh | Atualizar resposta existente no Notion | ✅ |
8. MODO DIEGO — OPERADOR AUTORIZADO
Sender verificado por:
e164: +555599096505 no metadata
Via linguagem natural no grupo: Diego faz correção → bot lê KNOWLEDGE-LIVE.md → appenda correção → confirma com ✅
TESTADO
Comandos disponíveis:
!adicionar-faq Pergunta | Resposta | Categoria → adiciona ao Notion direto
!aprovar [id] → move PENDENTE → APROVADO no KB3
!rejeitar [id] motivo → arquiva com nota
!sync → força sync Notion imediato
!revisar-semana → lista todas entradas PENDENTES
!status → stats das 3 KBs
9. STATUS ATUAL — 19/03/2026 FIM DO DIA
✅ BOOTSTRAP.md ativo — KBs carregam automaticamente em toda sessão
✅ KB1 FAQ Master — 123 Q&As sincronizados
✅ KB2 Aulas — 10 módulos, 259KB extraídos do Notion
✅ KB3 — 2 correções aprovadas (Pendle + schedule calls)
✅ Push KB3→Notion — 2 correções enviadas hoje, cron ativo (23h BRT)
✅ Revisão semanal — cron ativo (segunda 09h BRT)
✅ Testes reais — Marcio + Roberson respondidos corretamente
✅ Correção Diego via grupo — testado e funcionando
✅ Segurança — 4 camadas ativas (injection + conteúdo + identidade + mídia)
✅ Rate limit 3/10min — exec liberado, Diego isento
⚠️ Rate limit em /tmp/ — perde em reboot (baixa prioridade)
⚠️ Auto-captura KB3 ainda manual — bot não detecta automaticamente perguntas sem resposta
[ASPIRA LIVE WHATSAPP] · v2.0 · 19/03/2026 19:55 BRT · aspira-suporte-diagrama.html