EN·ES·DE·PT·FR
⌘K

Configuração do Bot Telegram

O Telegram é o canal principal do aidaemon, construído sobre o framework teloxide. Veja também Slack para integração com workspace.

Criar um Bot

  1. Envie uma mensagem para @BotFather no Telegram
  2. Envie /newbot e siga as instruções
  3. Copie o token do bot (formato: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ)

Obter Seu ID de Usuário

Seu ID numérico de usuário do Telegram é necessário para a lista allowed_user_ids. Você pode encontrá-lo enviando uma mensagem para @userinfobot.

Configuração

config.toml
[telegram]
bot_token = "123456789:ABCdefGHIjklMNOpqrSTUvwxYZ"
allowed_user_ids = [123456789]
Controle de Acesso
Se allowed_user_ids estiver vazio, qualquer pessoa que encontrar seu bot pode conversar com ele. Sempre defina isso em produção.

Funcionalidades

  • Indicador de digitação — enviado a cada 4 segundos durante o processamento do agente
  • Renderização Markdown — respostas do agente são convertidas para HTML do Telegram
  • Divisão de mensagens longas — respostas acima de 4096 caracteres são divididas em limites de parágrafo/linha
  • Compartilhamento de capturas de tela — capturas de tela do navegador enviadas como fotos com legendas
  • Transferência de arquivos — envie e receba documentos, fotos, áudio e vídeo via Telegram
  • Status de tarefas em tempo real/tasks mostra tarefas do agente em execução com tempo decorrido
  • Botões de aprovação inline — botões Allow Once / Allow Always / Deny para aprovação de comandos
  • Suporte multi-bot — configure múltiplos bots do Telegram via [[telegram.bots]]
  • Tratamento aprimorado de arquivos — detecção de tipo MIME, limites de tamanho e validação de segurança de caminho

Comportamento de Retry

O dispatcher do Telegram usa backoff exponencial em caso de falhas:

  • Backoff inicial: 5s
  • Dobra a cada falha: 5s → 10s → 20s → 40s → 60s (máximo)
  • Reseta para 5s se o bot rodar estável por mais de 60 segundos