Plataformas11 min de leituraAtualizado em

AstralBot: uma base open source para comunidades de vendas

Como organizei comunidade, catálogo, tickets privados, pagamentos e entrega digital em um bot Discord extensível.

Navegue neste artigo

AstralBot nasceu da necessidade de oferecer uma base aberta para quem quer criar uma comunidade de vendas no Discord sem começar pela infraestrutura. A instalação reúne criação idempotente do servidor, operação de produtos, compra assistida e entrega no privado em um fluxo que pode ser adaptado por cada comunidade.

A intenção do projeto

A intenção é que o bot funcione como uma fundação compreensível: módulos independentes, persistência simples em SQLite, Componentes V2 para as interfaces e pontos claros para trocar regras, provedores e formatos de entrega.

AstralBot é minha base open source, sob licença MIT, para criar e administrar comunidades de vendas no Discord. O projeto reúne a fundação da comunidade, painéis, tickets privados de compra, pagamentos configuráveis e entrega digital em um único bot, com foco em código legível, operação auditável e adaptação por servidor.

O QUE A BASE ORGANIZA

Estes são os principais elementos organizados nesta frente de trabalho.

  • Criador idempotente de categorias, canais de texto, salas de voz e cargos
  • Boas-vindas, regras versionadas, autorole, cargos por select, logs e limpeza de chat
  • Cadastro de produtos com título, descrição, preço, imagens, links, requisitos, termos e idiomas
  • Pix/manual e checkout externo, com Mercado Pago por webhook assinado quando configurado
  • Ticket privado por compra, confirmação administrativa, entrega no DM e pedido de avaliação
  • Recuperação de entrega, tarefas persistidas, links temporários e backups consistentes
  • Dados sensíveis cifrados e SQLite para uma instalação simples, local e extensível

PARA QUEM

Criadores, comunidades e desenvolvedores que querem uma base aberta para vender produtos digitais, organizar atendimento e adaptar a operação ao próprio servidor.

Como essa experiência pode ser aplicada

A base pode apoiar lojas de produtos digitais, cursos, softwares, assinaturas e serviços. O vendedor configura Pix ou checkout externo, o comprador acompanha tudo em um ticket privado e a entrega só é encerrada depois da confirmação administrativa, mantendo histórico para suporte e avaliação.

O que avaliar antes de aplicar uma solução parecida

Estes critérios ajudam a transformar a referência do projeto em uma decisão adequada ao contexto da empresa ou comunidade.

  • Quais partes da comunidade devem ser criadas idempotentemente e quem pode administrá-las.
  • Como pagamentos, confirmação administrativa, entrega privada e recuperação serão auditados.
  • Quais dados podem ficar no SQLite e quais precisam de retenção, cifragem ou armazenamento externo.
  • Como produtos multilíngues, arquivos, URLs e códigos de resgate serão versionados.
  • Como o servidor poderá adaptar módulos sem quebrar regras de segurança.

INFRAESTRUTURA & LICENÇA

Node.js 24+, TypeScript, discord.js 14, Components V2, SQLite, Fastify, Zod, Vitest e licença MIT.

Fontes e leituras relacionadas

Este material apresenta minha forma de trabalhar e tem caráter educativo. A solução adequada depende do contexto, dos riscos e das responsabilidades de cada projeto.

Compartilhar

Voltar para todos os materiais