Team Telegram Assistant | Easy Understand Hermes Agent

Assistente Telegram da Equipe

Se você já desejou poder conversar com seu agente de IA pelo celular, mandar um áudio enquanto passeia com o cachorro, ou fazer com que ele observe um grupo em silêncio e entre na conversa só quando você chamar pelo nome — este artigo é para você.

Estamos dando continuidade à nossa série sobre o Hermes Agent, e hoje vamos mergulhar na integração com o Telegram. Isso não é apenas um bot de “manda mensagem, recebe resposta”. É um assistente conversacional completo que vive dentro do Telegram, pronto para ajudar de qualquer dispositivo, a qualquer hora.

Vamos passar pela configuração e pelos novos recursos incríveis que fazem essa integração parecer um verdadeiro colega de equipe.

Passo 1: Crie Seu Bot (É Mais Fácil do Que Você Imagina)

Primeiro, você precisa de um token de bot. Ele é como uma chave que permite o Hermes controlar seu bot. Veja como conseguir um:

Abra o Telegram e procure por @BotFather (ou visite t.me/BotFather)
Envie /newbot
Escolha um nome de exibição — o que você quiser, como “Hermes Agent”
Escolha um nome de usuário — precisa ser único e terminar com bot (ex.: my_hermes_bot)
O BotFather vai responder com seu token de API. Ele se parece com isto:

123456789:ABCdefGHIjklMNOpqrSTUvwxYZ

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

Passo 2: Deixe Seu Bot com Cara de Profissional (Opcional)

Você pode personalizar o perfil do seu bot com alguns comandos simples do BotFather:

Comando	Finalidade
`/setdescription`	O texto “O que este bot pode fazer?” exibido antes de alguém começar a conversar
`/setabouttext`	Texto curto na página de perfil do bot
`/setuserpic`	Enviar uma foto de perfil
`/setcommands`	Definir o menu de comandos (o botão `/` no chat)
`/setprivacy`	Controlar a visibilidade de mensagens em grupos (veja o Passo 3)

Para /setcommands, um bom conjunto inicial:

help - Mostra informações de ajuda
new - Inicia uma nova conversa
sethome - Define este chat como o canal principal

Mostrar Status Online/Offline (Novo!)

Bots do Telegram não têm o ponto verde de “online” como contas de usuário. Mas agora o Hermes pode simular isso! Ative status_indicator e o Hermes atualizará a descrição curta do bot (a linha abaixo do nome no perfil) para dizer Online quando conectado e Offline em um desligamento limpo.

gateway:
  platforms:
    telegram:
      extra:
        status_indicator: true
        # Textos personalizados opcionais (padrão: "Online" / "Offline"):
        status_online: "🟢 Online"
        status_offline: "🔴 Offline"

Nota: Este status é global (visível para todos os usuários), não por chat. E ele só é atualizado em um desligamento limpo — uma queda brusca deixa o último status conhecido.

O Hermes registra automaticamente seu menu de comandos quando o gateway inicia. Por padrão, ele limita a 60 comandos para manter o payload confiável (o Telegram permite até 100, mas payloads grandes podem falhar).

Se você tem comandos de plugins que devem permanecer visíveis no seletor /, você pode priorizá-los:

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: os padrões do Hermes primeiro, depois os seus
replace: use apenas sua lista para a ordenação de prioridade

Passo 3: Modo Privacidade — O Erro Nº 1 (Crítico para Grupos)

Esta é a fonte mais comum de confusão. Bots do Telegram têm o modo privacidade ativado por padrão.

Com o modo privacidade LIGADO, seu bot só consegue 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 privacidade DESLIGADO, o bot vê todas as mensagens do grupo.

Como desativar:

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

⚠️ Você precisa remover e adicionar o bot novamente a qualquer grupo após mudar isso. O Telegram armazena em cache o estado de privacidade quando o bot entra — ele não atualiza até que você o adicione novamente.

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

Observe a Conversa do Grupo Sem Responder Automaticamente (Novo!)

Quer que seu bot observe um grupo mas só fale quando for mencionado? Isso é perfeito para canais de equipe onde você quer contexto sem ruído.

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

Com esta configuração, mensagens não mencionadas de chats na lista de permissões são adicionadas à transcrição da sessão compartilhada como contexto observado — o agente as vê, mas não responde. Então, quando você menciona @nomedobot, ele tem contexto completo da conversa.

Por Que Isso Importa para Equipes

Esta integração transforma o Hermes de uma ferramenta individual em um jogador de equipe. Você pode:

Enviar áudios que são transcritos automaticamente
Receber resultados de tarefas agendadas diretamente no chat
Compartilhar imagens e arquivos
Ter o bot monitorando canais silenciosamente e entrando quando necessário

O novo modo de observação é especialmente poderoso — seu bot se torna um colega silencioso que está sempre por dentro, pronto para ajudar no momento em que você chamar pelo nome.

Concluindo

Configurar o Telegram com o Hermes leva cerca de cinco minutos, e o retorno é enorme. Você ganha um assistente conversacional que funciona do seu bolso, entende voz, respeita a dinâmica de grupos e pode ser tão tagarela ou tão quieto quanto você precisar.

Na próxima, vamos explorar mais maneiras de fazer o Hermes parecer parte da equipe. Até lá, boas conversas! 🚀