Como conectar o Hermes Agent ao Telegram, Discord e WhatsApp

Como conectar o Hermes Agent ao Telegram?

1. Abra o Telegram e procure por @BotFather.
2. Envie o comando /newbot para criar um novo bot.
3. Escolha um nome de exibição para o bot e depois um nome de usuário único terminado em bot.
4. Copie o token enviado pelo BotFather. Esse token controla o bot e deve ficar em segredo.
5. Descubra seu ID numérico no Telegram falando com @userinfobot ou @get_id_bot.
6. Execute hermes gateway setup e selecione Telegram quando o assistente pedir a plataforma.
7. Informe o token do bot e os IDs de usuários autorizados quando o setup solicitar.
8. Inicie o gateway com hermes gateway e mande uma mensagem ao bot no Telegram para confirmar se ele ficou online.

Quem preferir configurar manualmente pode adicionar TELEGRAM_BOT_TOKEN e TELEGRAM_ALLOWED_USERS ao arquivo ~/.hermes/.env. O valor de usuários aceita mais de um ID, separado por vírgula. Depois, inicie o gateway e teste. O Telegram aceita texto, voz, imagem e anexo de arquivo, e o Hermes transcreve memorandos de voz automaticamente. Também dá para usar o agente em conversas em grupo, mas isso exige atenção com o modo de privacidade do bot.

Como usar o Hermes Agent em grupos do Telegram sem erro?

O Telegram ativa por padrão um modo de privacidade para bots, e isso costuma ser a principal fonte de confusão em grupos. Com a privacidade ligada, o bot só vê mensagens que começam com comando, respostas diretas às próprias mensagens e alguns avisos de serviço. Se você quer que o Hermes enxergue todas as mensagens de um grupo, abra o @BotFather, envie /mybots, selecione seu bot e siga em Bot Settings → Group Privacy → Turn off. Depois disso, remova o bot do grupo e adicione novamente, porque o Telegram mantém em cache o estado de privacidade no momento da entrada. Outra saída é promover o bot a administrador do grupo, já que bots administradores recebem todas as mensagens mesmo sem mexer nessa configuração global. Há ainda um modo em que o Hermes observa a conversa de grupos permitidos sem responder automaticamente, usando require_mention: true e observe_unmentioned_group_messages: true na configuração.

Como conectar o Hermes Agent ao Discord?

1. Abra discord.com/developers/applications e clique em New Application.
2. Dê um nome ao aplicativo.
3. Entre em Bot na barra lateral e clique em Add Bot.
4. Copie o token do bot e salve na hora, porque ele é exibido uma única vez.
5. Ative Message Content Intent em Privileged Gateway Intents para permitir leitura das mensagens.
6. Vá em OAuth2 → URL Generator, marque o escopo bot e as permissões Send Messages, Read Message History e Use Slash Commands.
7. Abra a URL gerada no navegador, escolha o servidor e autorize o bot.
8. Ative o Developer Mode no Discord, clique com o botão direito no ícone do servidor e copie o guild ID.
9. Copie também o seu próprio User ID no Discord.
10. Execute hermes gateway setup ou configure o token, o guild_id e a lista de allowed_users no Hermes.
11. Mencione o bot em um canal, como @seubot olá, para verificar a resposta.

No Discord, a lista de usuários permitidos segue como camada importante de segurança. Em instalações que usam configuração manual, o formato inclui o token do bot, o ID do servidor e os IDs dos usuários autorizados. Isso limita quem pode falar com o agente dentro do servidor e evita gasto indevido de créditos. Como o Discord é baseado em convite para entrar no servidor, o risco de descoberta pública fica menor do que no Telegram, mas continua presente para qualquer membro do guild se a allowlist ficar aberta.

Como conectar o Hermes Agent ao WhatsApp?

1. Abra o painel do Hermes Agent onde a opção de WhatsApp estiver disponível.
2. Escolha a conexão do WhatsApp no painel.
3. Escaneie o QR Code com o número que vai ser usado pelo assistente, como se estivesse conectando um WhatsApp Web.
4. Aguarde o pareamento e confirme se o Hermes aparece como um contato.
5. Envie uma mensagem de teste, um áudio ou um link para verificar a resposta.

O WhatsApp faz parte das plataformas suportadas pelo Hermes, e a conexão descrita para uso self-hosted acontece por QR Code. A recomendação é usar um número dedicado, com chip próprio ou número virtual, para não misturar o assistente com o WhatsApp pessoal. Depois do pareamento, o Hermes vira um contato no app e responde textos, processa links, transcreve e resume áudios e mantém a mesma memória usada em Telegram e Discord. Se você já usa outro agente e vai migrar para o Hermes, há cenários em que a migração de memórias e configurações é suportada. Para quem só quer colocar o canal no ar, o ponto central é garantir que o gateway esteja funcionando e que o QR Code seja lido pelo número que ficará responsável pelo assistente.

Quais regras de segurança configurar antes de liberar os chats?

Conectar o Hermes Agent a apps de mensagem deixa o uso mais prático, mas também cria risco de comando acidental ou acesso indevido. A primeira regra é definir uma política clara do que o agente pode fazer pelo chat: só responder, produzir rascunhos, executar ações mediante aprovação ou nunca realizar certas operações. A segunda é limitar o acesso com listas de usuários permitidos, especialmente no Telegram e no Discord. No Telegram, isso é crítico porque bots são fáceis de encontrar por nome de usuário. Outra boa prática é não deixar tokens em repositório nem em texto público; use variáveis de ambiente ou o arquivo de segredos lido pelo Hermes. Se você usa um daemon ou gateway contínuo em servidor, mantenha o processo ativo numa VPS, porque o agente só responde enquanto esse gateway estiver rodando.

Erros comuns (e como evitar)

• Configurar o canal antes do chat base: primeiro teste hermes no terminal.
• Usar token errado ou antigo: um token regenerado no BotFather invalida o anterior.
• Esquecer a allowlist: sem IDs autorizados, você pode abrir o bot para gente demais.
• Esperar que o bot leia tudo no grupo do Telegram: isso não acontece com a privacidade padrão ligada.
• Desligar a privacidade do Telegram e não recolocar o bot no grupo: a mudança só passa a valer depois de remover e adicionar o bot novamente.
• Usar WhatsApp pessoal para o agente: o recomendado é separar o número do assistente.
• Rodar em máquina que dorme ou desliga: o gateway precisa ficar ativo para receber mensagens.

Perguntas frequentes