Hermes v2026.3.28 Update: Telegram Setup Made Simple

Atualização do Hermes v2026.3.28: Configuração do Telegram Simplificada

O Telegram é uma das formas mais populares de conversar com seu Agente Hermes. Nesta atualização, refinamos o processo de configuração e adicionamos algumas opções práticas. Seja você um iniciante completo ou um profissional experiente, este guia fará você conversar com seu agente em pouco tempo.

Passo 1: Crie Seu Bot

Antes de tudo, você precisa de um token de bot. Isso é como uma chave secreta que permite ao Hermes controlar seu bot. Veja como obter um:

1. Abra o Telegram e procure por @BotFather (ou visite t.me/BotFather)
2. Envie /newbot
3. Escolha um nome de exibição (o que você quiser, ex.: “Hermes Agent”)
4. Escolha um nome de usuário que termine em bot (ex.: my_hermes_bot)
5. O BotFather responderá com seu token de API

Seu token será algo assim:

123456789:ABCdefGHIjklMNOpqrSTUvwxYZ

Importante: Mantenha este token em segredo! Qualquer pessoa com ele pode controlar seu bot. Se ele vazar, revogue-o imediatamente com /revoke no BotFather.

Passo 2: Personalize Seu Bot (Opcional, mas Recomendado)

Você pode tornar seu bot mais amigável com alguns comandos rápidos do BotFather:

Comando	Finalidade
/setdescription	O texto “O que este bot pode fazer?” exibido antes da conversa
/setabouttext	Texto curto na página de perfil do bot
/setuserpic	Enviar um avatar
/setcommands	Definir o menu de comandos /
/setprivacy	Controlar a visibilidade de mensagens em grupos (veja o Passo 3)

Para /setcommands, um bom conjunto inicial é:

help - Mostrar informações de ajuda
new - Iniciar uma nova conversa
sethome - Definir este chat como canal principal

Novo: Indicador de Status Online/Offline

Bots do Telegram não têm o ponto verde “online” como contas de usuário. Mas agora você pode mostrar o status do seu bot na descrição do perfil! Ative isso na sua configuração:

gateway:
  platforms:
    telegram:
      extra:
        status_indicator: true
        status_online: "🟢 Online"
        status_offline: "🔴 Offline"

O status muda para Online quando o gateway conecta e Offline em um desligamento limpo. Observe que isso é global (visível para todos), e uma falha grave não atualizará o status — isso é uma limitação do Telegram.

Novo: Prioridade do Menu de Comandos

O Hermes registra automaticamente seu menu de comandos quando o gateway inicia. Por padrão, ele limita a 60 comandos por confiabilidade (o Telegram permite até 100, mas cargas grandes podem falhar). Você pode personalizar quais comandos aparecem primeiro:

platforms:
  telegram:
    extra:
      command_menu:
        max_commands: 60
        priority_mode: prepend  # prepend | append | replace
        priority:
          - my_plugin_command

• prepend: Seus comandos primeiro, depois os padrões do Hermes
• append: Padrões do Hermes primeiro, depois os seus
• replace: Usar apenas sua lista para ordenação de prioridade

Passo 3: Modo de Privacidade — A Pegadinha Nº 1

Esta é a fonte mais comum de confusão. Bots do Telegram têm modo de privacidade ativado por padrão. Isso significa que seu bot só pode ver:

• Mensagens que começam com /
• Respostas às próprias mensagens do bot
• Mensagens de serviço (entradas, saídas, fixações)
• Mensagens em canais onde ele é administrador

Com o modo de privacidade DESATIVADO, o bot vê tudo no grupo.

Para desativá-lo:

1. Envie mensagem para @BotFather
2. Envie /mybots
3. Selecione seu bot
4. Vá em Bot Settings → Group Privacy → Turn off

Aviso: Você deve remover e adicionar o bot novamente a qualquer grupo após alterar isso. O Telegram armazena em cache o estado de privacidade!

Alternativa: Promova o bot a administrador do grupo — administradores sempre veem todas as mensagens, sem precisar alternar a privacidade.

Novo: Observar Conversas do Grupo Sem Responder Automaticamente

Quer que seu bot veja mensagens do grupo, mas só responda quando for mencionado? Este novo modo é perfeito para isso:

telegram:
  allowed_chats:
    - "-1001234567890"
  group_allowed_chats:
    - "-1001234567890"
  require_mention: true
  observe_unmentioned_group_messages: true

Com isso ativado, mensagens não mencionadas de chats na lista de permissões são adicionadas à transcrição da sessão como contexto, mas não acionam o agente. Uma menção posterior com @nomedobot terá contexto completo do que foi dito.

Concluindo

É isso! Agora você está pronto para conversar com seu Agente Hermes no Telegram de qualquer lugar. O novo indicador de status, os controles do menu de comandos e o modo de observação de grupos oferecem mais flexibilidade do que nunca. Boas conversas!