Pular para o conteúdo
Documentação DiscordKit

O projeto: uma central de atendimento

O que vamos construir, como estudar e como executar cada etapa.

Abrir texto

Vamos construir um bot que resolve um fluxo completo: um membro abre um chamado, acompanha o atendimento, a equipe assume o trabalho e o solicitante avalia a solução. Os registros continuam disponíveis depois de reiniciar o processo.

O resultado é um registro de chamados dentro do Discord, com interfaces privadas. Ele não cria canais privados, não encaminha uma conversa em tempo real e não promete notificar automaticamente o solicitante. A equipe consulta a fila, vê quem abriu o chamado e combina o atendimento no servidor. Essas distinções importam para você saber o que está entregando.

Você precisa saber criar arquivos, executar comandos no terminal e reconhecer funções, structs e erros em Go. Explicaremos as decisões de organização e as APIs usadas. Se nunca conectou um bot, comece pelo capítulo de preparação.

Há dois modos de estudar:

  • Acompanhado: clone o projeto, comece na etapa 1 e ative uma funcionalidade por vez. Leia e altere os arquivos indicados em cada capítulo. O esqueleto completo já existe para que cada parada compile.
  • Reconstrução: depois da primeira leitura, crie seu próprio módulo e reescreva os arquivos por responsabilidade. As páginas mostram o código completo de cada arquivo; o capítulo de operação explica como trocar o caminho do módulo.

COOKBOOK_STAGE é uma ferramenta didática. Não é feature flag da DiscordKit nem sistema de migração. Ele decide quais comandos e rotas são registrados. O padrão é 6, o bot completo. Aumente a etapa ao terminar o exercício; pare com Ctrl+C antes de iniciar novamente. Voltar a uma etapa anterior não apaga comandos antigos do Discord, porque a sincronização é propositalmente não destrutiva.

Capítulo Etapa executável O que você entrega
01 · Preparação 1 Aplicação instalada e /ping funcionando
02 · Arquitetura 1 Configuração, ciclo de vida e módulos compreendidos
03 · Comandos 2 Opções tipadas, respostas públicas e privadas
04 · Painel 3 Central pública, FAQ privado e permissões
05 · JSON-db 3 + testes Repositório persistente com regras de acesso
06 · Chamados 4 Modal, custom IDs, atribuição e encerramento
07 · Fila 5 Filtro, paginação e autocomplete autorizado
08 · Operação 6 Avaliação, exportação, testes e hospedagem
09 · Laboratório 6 Opções resolvidas, menus de contexto e mídia
Mapa da API Consulta Onde cada família da API aparece e seus limites

Go fornece módulos, pacotes, structs, interfaces, goroutines, mutex, JSON e arquivos. discordgo conecta o Gateway e expõe os tipos e endpoints do Discord. DiscordKit organiza o fluxo de interações: builders, roteamento, contexto, middleware e respostas.

O JSON-db é código deste aplicativo. Não estamos adicionando uma abstração de banco à biblioteca. Também não há uma camada mágica de injeção de dependências: main constrói o store e o entrega ao bot.

Ao terminar, você deve conseguir abrir e consultar um chamado, impedir outro membro de acessá-lo, assumir como atendente, encerrar como autor ou equipe, avaliar como autor, reiniciar sem perder os dados e exportar apenas os registros autorizados. Além disso, deve conseguir explicar por que ShowModal não vem depois de Defer e por que um custom ID não substitui uma autorização.

Código executável completo. Os blocos deste guia são sincronizados com os arquivos do exemplo e conferidos no CI.


Próximo →: 01 · Prepare e conecte o bot