Triggers automáticos
triggers automáticos são os eventos do sistema que disparam pontos sem você precisar agir — entendê-los todos é o que diferencia gamificação básica de gamificação inteligente.
O que são
Trigger = evento que dispara uma regra de gamificação. Quando o aluno faz uma ação no AVA, o sistema detecta automaticamente e credita pontos (se houver regra ativa).💡 Você não precisa fazer nada. Configurou a regra, o sistema cuida.
Catálogo completo de triggers
📚 Aprendizado
| Trigger | Quando dispara | Antifraude embutido | |---|---|---| | `lesson_completed` | Aluno marca aula como concluída | Aulas <30s não contam | | `lesson_watched` | Aluno assistiu >X% do vídeo | X configurável (50-95%) | | `module_completed` | Aluno terminou módulo | Sem fraude conhecida | | `course_completed` | Aluno terminou curso | Não conta se fez em <24h (suspeito) | | `quiz_passed` | Aluno passou no quiz com nota X | Não conta se fez em <30s | | `quiz_first_try` | Acertou na primeira tentativa (configurável) | Sem fraude | | `certificate_issued` | Certificado emitido | Sem fraude | | `course_review_5_stars` | Aluno avaliou curso com 5 estrelas | Limite 1 por curso |
💬 Engajamento
| Trigger | Quando dispara | Antifraude | |---|---|---| | `nps_answered` | Aluno respondeu NPS | 1 por pesquisa | | `nps_with_comment` | NPS com comentário >10 caracteres | Spam detectado | | `comment_posted` | Comentou em aula | Mín. 10 caracteres; 1ª por aula | | `qa_question_posted` | Pergunta no Q&A | Mín. 20 caracteres | | `qa_answer_posted` | Respondeu no Q&A | Mín. 20 caracteres | | `qa_answer_marked_best` | Resposta marcada como melhor | Sem fraude |
🔄 Hábito
| Trigger | Quando dispara | Antifraude | |---|---|---| | `daily_login` | Aluno fez login (1x por dia) | Geo + IP | | `daily_streak_3` | 3 dias seguidos de login | Sem fraude | | `daily_streak_7` | 7 dias seguidos | Sem fraude | | `daily_streak_30` | 30 dias seguidos | Sem fraude | | `weekly_active` | Acessou a plataforma na semana | 1 por semana | | `monthly_milestone` | Completou meta do mês | Configurável |
🛒 Comerciais
| Trigger | Quando dispara | Pontos | |---|---|---| | `purchase_made` | Aluno comprou outro curso | % do valor (R$ 100 = 100 pts) | | `referral_signup` | Indicação cadastrou-se | 100 pts | | `referral_converted` | Indicação comprou | 500 pts | | `affiliate_sale` | Venda como afiliado | % da comissão | | `cart_completed` | Aluno finalizou compra (recuperação de carrinho) | 50 pts |
👤 Perfil
| Trigger | Quando dispara | Limite | |---|---|---| | `profile_completed` | Perfil 100% preenchido | 1x na vida | | `avatar_uploaded` | Aluno colocou foto | 1x na vida | | `bio_filled` | Aluno escreveu bio | 1x na vida | | `phone_verified` | Telefone validado | 1x na vida | | `email_verified` | Email validado | 1x na vida |
🌟 Sociais
| Trigger | Quando dispara | Limite | |---|---|---| | `share_course` | Aluno compartilhou curso (Instagram, WhatsApp) | 3 por curso | | `invite_sent` | Aluno convidou amigo | 5/mês | | `discord_joined` | Aluno entrou no Discord (integração) | 1x na vida | | `whatsapp_optin` | Aluno aceitou WhatsApp | 1x na vida |
🎯 Eventos especiais
| Trigger | Quando dispara | |---|---| | `birthday` | Dia do aniversário do aluno | | `anniversary_1y` | 1 ano de plataforma | | `anniversary_2y` | 2 anos | | `course_anniversary` | 1 ano desde matrícula no curso | | `special_event` | Evento que você cria (Black Friday, lançamento) |
Como funcionam
```
- Aluno faz ação (ex: marca aula como concluída)
- Sistema detecta automaticamente
- Verifica se há regra ativa para o trigger
- Verifica anti-fraude
- Verifica limite (cap diário, etc.)
- Verifica whitelist de cursos
- Credita pontos no aluno
- Notifica o aluno (banner + email se configurado)
💡 Tudo em menos de 1 segundo. Aluno vê os pontos creditados na hora.
Configurar trigger especial (custom)
Para eventos que não estão no catálogo, use Webhooks:
- Crie webhook em Plataforma > Integrações > Webhooks
- Quando seu sistema externo dispara, chame o webhook
- Webhook credita pontos via API
Exemplo
```json POST /api/v1/gamification/credit { "student_id": 123, "trigger": "external_event", "points": 100, "reason": "Participou do webinar de 22/04" } ```
📖 Saiba mais: Webhooks
Eventos visíveis ao aluno
Quando trigger dispara, aluno vê:
``` ┌──────────────────────────────────┐ │ 🎉 +10 pontos! │ │ Aula "Funil de vendas" concluída │ └──────────────────────────────────┘ ```
Notificação toast no AVA (some em 5s) + entrada no histórico.
💡 Pode desativar notificações em Plataforma > Gamificação > Configurações. Padrão: ativo (mais engajamento).
Streak (sequência diária)
Trigger especial: `daily_streak`. Funciona como Duolingo:
``` Dia 1 (segunda): aluno acessa → +5 pts (streak: 1) Dia 2 (terça): aluno acessa → +5 pts (streak: 2) Dia 3 (quarta): aluno acessa → +5 pts (streak: 3) Dia 4 (quinta): aluno NÃO acessa → streak quebra Dia 5 (sexta): aluno acessa → +5 pts (streak: 1, recomeço) ```
Bônus por marco
- 🔥 3 dias seguidos: +20 pts bônus
- 🔥🔥 7 dias: +50 pts bônus
- 🔥🔥🔥 30 dias: +200 pts bônus + badge "Mestre da Constância"
💡 Streak vicia. Aluno acessa "só pra não quebrar". A métrica de retenção sobe muito.
Antifraude por trigger
Aulas
- ✅ Menos de 30s assistido → não conta
- ✅ Marcar/desmarcar aula → conta só 1x
- ✅ Fast-forward >5x → não conta
Comentários
- ✅ Mín. 10 caracteres
- ✅ Texto repetido não conta
- ✅ Limite diário (no máximo 10 comentários)
Login
- ✅ IP e geo verificados (mesmo aluno em 2 países = suspeito)
- ✅ Conta 1x por dia (não 100x se o aluno reabrir o browser)
Quiz
- ✅ Mín. 30s no quiz
- ✅ Padrão de respostas suspeito → não conta
💡 Antifraude é automático. Você não precisa configurar — o sistema detecta.
Boas práticas
✅ Faça
- Comece com 5-7 triggers (lesson, module, course, nps, comment, login, streak)
- Adicione comerciais depois de 2 meses (purchase, referral)
- Streak tem alta prioridade (engajamento)
- Evento especial para Black Friday e lançamentos
❌ Não faça
- ❌ Ativar 20 triggers logo no início — exagero
- ❌ Pontos altos em share_course (vira spam)
- ❌ Trigger custom sem rate limit (atacante drena pontos)
- ❌ Ignorar antifraude — investigue padrões suspeitos
Erros comuns
"Aluno disse que ganhou pontos sem fazer nada"
Provavelmente trigger automático (login, weekly_active, anniversary). Veja o histórico — sempre tem motivo.
"Trigger não está disparando"
Verifique:
- Regra está ativa?
- Trigger correto? (use o nome exato do catálogo)
- Whitelist exclui o curso?
- Limite atingido?
- Bug: abra chamado.
"Quero criar trigger novo (não está no catálogo)"
Use webhook custom. Veja seção "Configurar trigger especial".
"Sistema detectou fraude. Pontos foram revertidos."
Aluno pode ter automatizado (script). Veja logs em Aluno > Histórico > Antifraude. Se for engano, restaure manualmente.
"Trigger conta em duplicidade"
Bug — abra chamado. Não deveria acontecer. Cada trigger tem ID único por evento.
Próximos passos
Foi útil este artigo? 👍 👎 Falar com CS (em produção) · Pergunte ao Vob 🤖 (em produção) Última atualização: 2026-05-01