O Hermes no Discord

O Hermes entra no Discord como o bot de uma aplicação criada no Discord Developer Portal. O gateway se autentica com o token do bot, guardado na variável DISCORD_BOT_TOKEN no .env do profile. A aplicação precisa do Message Content Intent ativado. Sem ele, o Discord recusa a conexão do gateway.

Nas mensagens diretas, o Hermes responde a tudo. Nos canais de um servidor, ele só responde às mensagens que mencionam o bot com @, e cada menção abre um tópico novo para a conversa. DISCORD_AUTO_THREAD=false faz o bot responder no próprio canal. A liberação de acesso funciona como no Telegram: o gateway recusa usuários fora da lista DISCORD_ALLOWED_USERS, que guarda os IDs numéricos do Discord.

Crie a aplicação e o bot

No Discord Developer Portal, clique em New Application, dê um nome e abra a página Bot. O Discord cria o usuário do bot junto com a aplicação. Na mesma página, em Privileged Gateway Intents, ative o Server Members Intent e o Message Content Intent.

Ainda na página Bot, clique em Reset Token e copie o valor na hora, porque o Discord mostra o token uma única vez. Guarde o valor só até colar no assistente de configuração do Hermes.

Convide o bot para o servidor

Na aba Installation da aplicação, marque os escopos bot e applications.commands e use o link gerado para adicionar o bot ao servidor. A documentação recomenda o número de permissões 309237763136, que inclui ver canais, enviar mensagens, anexar arquivos, ler o histórico e usar tópicos. O mínimo para funcionar é 117760.

Copie o seu ID do Discord

Nas configurações do Discord, em Avançado, ative o Modo Desenvolvedor. Em seguida, clique com o botão direito no seu nome e escolha Copiar ID do usuário. Cada pessoa que vai conversar com o bot precisa informar o próprio ID.

Ligue o bot ao gateway

Na VPS, com o usuário hermes, rode o assistente do gateway e escolha Discord:

1
hermes gateway setup

O assistente confere o token, avisa quando o Message Content Intent está desligado e mostra um link de convite. Ele também oferece incluir o seu ID na lista DISCORD_ALLOWED_USERS. Depois, reinicie o serviço com hermes gateway restart e mande uma mensagem direta para o bot.

Para o bot responder num canal sem precisar de menção, liste o ID do canal na variável DISCORD_FREE_RESPONSE_CHANNELS. Depois que o bot participa de um tópico, ele responde a todas as mensagens seguintes ali, sem nova menção. DISCORD_THREAD_REQUIRE_MENTION=true volta a exigir a menção, o que ajuda quando vários bots dividem o mesmo tópico.