01 · Prepare e conecte o bot
Do Developer Portal ao primeiro checkpoint executável.
Objetivo: executar /ping em um servidor de teste. Ainda não vamos publicar um painel ou gravar chamados.
1. Prepare a aplicação Discord
Seção intitulada “1. Prepare a aplicação Discord”Abra o Developer Portal, crie uma aplicação e obtenha o token na seção Bot. Guarde-o fora do Git. Em Installation, escolha instalação em servidor e os escopos bot e applications.commands. Para este exemplo, dê ao bot View Channels, Send Messages, Embed Links e Attach Files no canal de teste. Não conceda Administrador.
Instale a aplicação no servidor. Ative o modo de desenvolvedor no cliente Discord e copie o ID do servidor. Os nomes e a localização das telas do portal podem variar; os valores que precisamos são o token do bot e o ID do servidor.
Deixe Interactions Endpoint URL vazio: receberemos eventos pelo Gateway, usando uma conexão persistente do discordgo. Só usamos IntentsGuilds. Não precisamos de Message Content, Server Members ou Presence Intent para slash commands e componentes. Publicar um painel exige que o usuário tenha Gerenciar Mensagens; isso é diferente das permissões concedidas ao bot.
2. Obtenha o projeto
Seção intitulada “2. Obtenha o projeto”Instale Go 1.26 ou superior, Git e um editor. O módulo do repositório declara o mínimo necessário; use go version para conferir.
git clone https://github.com/freitaseric/discordkit.gitcd discordkit/examples/community-botgo versiongo test ./...Não execute go mod init nesta pasta: ela já pertence ao módulo na raiz do repositório. Go encontra o go.mod subindo pelos diretórios. Os imports .../examples/community-bot/internal/... são os pacotes locais deste exemplo.
3. Configure o ambiente
Seção intitulada “3. Configure o ambiente”No Bash/Zsh, leia o token sem mostrá-lo na tela nem colocá-lo literalmente no histórico:
read -rs -p 'Token do bot: ' DISCORD_TOKEN; echoexport DISCORD_TOKENexport DISCORD_GUILD_ID='ID_DO_SEU_SERVIDOR'export BOT_DATA_FILE='data/community.json'export COOKBOOK_STAGE=1go run ./cmd/botNo PowerShell 7:
$env:DISCORD_TOKEN = Read-Host 'Token do bot' -MaskInput$env:DISCORD_GUILD_ID = 'ID_DO_SEU_SERVIDOR'$env:BOT_DATA_FILE = 'data/community.json'$env:COOKBOOK_STAGE = '1'go run ./cmd/bot.env.example documenta as variáveis; o programa não carrega .env automaticamente. Um arquivo não vira variável de ambiente sem um carregador. O caminho relativo de dados é resolvido a partir do diretório em que você iniciou o processo. Use um caminho absoluto na hospedagem.
4. Confira o checkpoint
Seção intitulada “4. Confira o checkpoint”O terminal deve mostrar ready com stage=1. No servidor configurado, execute /ping: a resposta Pong! DiscordKit está conectado. deve aparecer somente para você. Encerre com Ctrl+C. O arquivo JSON só é criado quando houver a primeira gravação de chamado.
Se não houver comando, confirme o ID do servidor, os escopos de instalação e o erro de sincronização no terminal. Se aparecer “application did not respond”, confira se o processo ainda está rodando. Não inicie duas cópias para tentar resolver: elas disputam eventos e o arquivo local.
Exercício: mude a resposta do handler ping em internal/bot/bot.go, reinicie e confirme a alteração. Não precisa mudar o builder: o texto da resposta não faz parte da definição registrada no Discord.
Próximo: como o processo e os pacotes se conectam.
← Anterior: O projeto: uma central de atendimento · Próximo →: 02 · Organize a aplicação Go