Esta página apresenta as APIs principais do pacote. Consulte também os guias de roteamento, interações e instalação.
Comandos
Seção intitulada “Comandos”Crie comandos de aplicação com Command, UserCommand e MessageCommand. Comandos de barra aceitam builders tipados, como StringOption, IntegerOption, BooleanOption, UserOption e ChannelOption. Use SubCommand e SubCommandGroup para criar subcomandos e grupos.
Build retorna um *discordgo.ApplicationCommand e um erro; MustBuild causa panic em declarações inválidas; BuildCommands monta várias declarações. As validações cobrem nomes, descrições, quantidade e duplicidade de opções, hierarquia e a ordem de opções obrigatórias antes das opcionais. O registro no Discord continua sob controle da aplicação.
ping, err := discordkit.Command("ping", "Verifica se o bot está respondendo").Build()if err != nil { return err}Roteador e middleware
Seção intitulada “Roteador e middleware”Um Router despacha comandos, componentes, envios de modais e autocomplete. Registre handlers com Command, Component, Modal e Autocomplete, e conecte router.Handle à sessão discordgo com Session.AddHandler. Handlers usam a assinatura func(*discordkit.Context) error.
Group compartilha prefixo e middleware. Use adiciona middleware global e cada rota pode receber middleware próprio. Recovery recupera panics e os transforma em erros. OnError permite observar erros de despacho; sem um hook, os erros são registrados em log. A página de roteamento detalha parâmetros nomeados e precedência de rotas.
Contexto e ciclo de resposta
Seção intitulada “Contexto e ciclo de resposta”O Context oferece a sessão e interação do discordgo, acesso tipado às opções, parâmetros de rota e métodos de resposta. Use ReplyText ou Reply para a resposta inicial. Use Defer para confirmar uma interação cujo processamento levará mais tempo e depois conclua com EditReply ou Followup. Handlers de componentes podem usar Update ou DeferUpdate; Ephemeral controla a visibilidade quando permitido.
O contexto acompanha as confirmações e rejeita operações incompatíveis com o estado atual. Defer não move a execução para segundo plano. A aplicação é responsável por prazos e trabalhos externos.
Mensagens e Components V2
Seção intitulada “Mensagens e Components V2”MessageSpec descreve conteúdo, embeds, flags, arquivos e componentes. A DSL Components inclui linhas, botões interativos/de link/premium, selects de string/entidade/canal, seções, containers, displays de texto, galerias, separadores, miniaturas e componentes de arquivo. Raw permite usar diretamente um componente discordgo sem builder dedicado.
Antes do envio, a validação verifica posicionamento, action rows, custom IDs, tamanho de galerias e limite recursivo. Quando há componentes V2, a flag necessária é aplicada automaticamente. Mensagens V2 seguem as restrições do Discord e não devem combinar conteúdo ou embeds legados com esse layout.
Modais e formulários
Seção intitulada “Modais e formulários”O pacote oferece inputs de texto, selects de string e uploads de arquivo em modais, conforme a API do Discord e a versão usada do discordgo. Os valores enviados podem ser lidos pelos helpers de modal do contexto. A árvore precisa ter pelo menos um componente e cada label precisa conter um input compatível. A aplicação decide como armazenar ou processar anexos enviados.
Custom IDs
Seção intitulada “Custom IDs”CustomID monta e interpreta IDs com segmentos separados por barras e parâmetros nomeados. Use-os nas rotas Router.Component e Router.Modal. IDs são visíveis para clientes, portanto não coloque segredos ou dados sensíveis neles e respeite o limite de tamanho do Discord.
Sincronização de comandos
Seção intitulada “Sincronização de comandos”DiffCommands compara comandos desejados com os remotos sem fazer chamadas de rede e retorna um SyncPlan. SyncCommands consulta o Discord e aplica criações e atualizações. Comandos obsoletos só são excluídos quando SyncOptions.Delete está habilitado. GuildID vazio indica comandos globais; preenchido, comandos de servidor. Confira a política de exclusão antes de usá-la em produção.
Erros e discordgo
Seção intitulada “Erros e discordgo”Erros de builders e validadores podem ser verificados com errors.Is e sentinelas como ErrInvalidCommand, ErrInvalidComponent, ErrInvalidModal, ErrAlreadyAcknowledged e ErrRouteNotFound. Acesso à sessão e aos tipos originais do discordgo permanece disponível para recursos ainda não cobertos pela DSL.