Automação inteligente de acessos para comunidades premium
O Discord Validation Bot é uma solução exclusiva desenvolvida para a comunidade GTM Pro o ecossistema de ensino e performance digital criado por Danilo Borguetti, referência em Tagueamento, GA4 e Meta Ads API de Conversões.
Projetado e implementado pela Forcoder Desenvolvimento de Soluções, o sistema oferece uma experiência totalmente automatizada e segura de validação de alunos dentro do Discord oficial da comunidade.
💡 Visão Geral
O bot conecta o ambiente de ensino da GTM Pro ao servidor Discord, garantindo que apenas compradores e assinantes ativos tenham acesso aos canais correspondentes aos seus produtos ou planos.
A validação ocorre por e-mail o mesmo usado na compra e é cruzada automaticamente com o banco de dados hospedado no Supabase, mantendo todos os cargos e permissões sempre atualizados.
O projeto combina automação, segurança e UX, resultando em um fluxo robusto e totalmente sem intervenção manual.
⚙️ Estrutura do Projeto
O sistema é composto por dois ambientes principais:
1. Bot Principal (Node.js + Discord.js)
Responsável por toda a interação com o Discord, o bot executa:
- Validação de acesso via modal (e-mail de compra).
- Atribuição e remoção automática de cargos conforme produtos e assinaturas.
- Registro detalhado de logs de atividade em canais internos.
- Presença rotativa personalizada (Watching / Listening / Playing).
- Execução periódica de cron jobs para manter o servidor sempre sincronizado.
2. Banco de Dados (Supabase)
O Supabase atua como backend seguro, centralizando os dados de:
- Vendas (
sales): e-mail, produto, tipo (curso, assinatura, etc.) e validade. - Produtos (
product): nome, tipo e identificador. - Vínculos Discord (
discord_users): relacionamento entrediscord_ide e-mail validado.
Toda a comunicação ocorre via Service Role Key protegida em variáveis de ambiente (.env).
🧱 Tecnologias Utilizadas
| Camada | Tecnologia |
|---|---|
| Backend | Node.js 20 |
| Framework | Discord.js v14 |
| Banco de Dados | Supabase (PostgreSQL + Storage) |
| Agendamentos | node-cron + cron-parser |
| Infraestrutura | Docker + Docker Compose |
| Versionamento | GitHub privado (cliente GTM Pro) |
| Ambiente | .env com isolamento e logs por canal |
🚀 Funcionalidades Principais
- Validação Automática: o usuário insere seu e-mail e o bot identifica os produtos adquiridos.
- Sincronização por Cron: o bot verifica periodicamente assinaturas e acessos expirados.
- Mensagens Interativas: catálogo dinâmico de produtos e botões de ação como “Verificar Acesso” e “Sincronizar Agora”.
- Logs e Transparência: toda ação é registrada em canal de logs para auditoria e suporte.
- Comandos Administrativos: painel interno no canal de comandos com prefixo
!, incluindo listagem, reset e verificações. - Presença Rotativa: frases configuráveis exibidas no status do bot para reforçar a identidade da comunidade GTM Pro.
🔐 Segurança e Boas Práticas
- Integração com Supabase via Service Role Key (sem exposição pública).
- Tokens, IDs e URLs totalmente encapsulados em
.env. - Permissões restritas no Discord (Manage Roles, Send Messages, Embed Links, etc.).
- Logs privados para administração e auditoria.
- Processos de “RESET” com confirmação dupla e logs de execução.
- Compatibilidade com servidores grandes (uso de REST paginado).
📅 Manutenção Automática (Cron Jobs)
Um agendamento interno revisa periodicamente todos os vínculos e atualiza o acesso conforme o status de compra e validade da assinatura:
- Adiciona cargos quando uma venda válida é detectada.
- Remove cargos de produtos expirados.
- Envia notificações via DM ao usuário (ou logs internos, quando a DM estiver fechada).
- Exibe resumo consolidado no canal de logs.
🛠️ Desenvolvimento e Deploy
- Ambiente Dockerizado com hot-reload para desenvolvimento local.
- Deploy simplificado via Docker Compose (produção).
- Suporte a timezone configurável (
TZ=America/Sao_Paulo). - Modularização em
src/index.jsesrc/util/supabase.js. - Atualizações contínuas com changelog controlado.
🧾 Status Atual
Fase inicial concluída ✅
Em operação ativa no servidor oficial GTM Pro, com logs estáveis, validações ativas e cron revisando automaticamente os acessos.
🧩 Um Projeto de Automação e Inteligência Operacional
O Discord Validation Bot representa o equilíbrio entre engenharia de software e experiência do usuário, elevando a gestão de comunidades premium a um novo nível de automação.
Com ele, a equipe GTM Pro mantém o foco no conteúdo e na performance dos alunos — enquanto o bot cuida de toda a lógica de acessos, permissões e expirações.
