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
- Envie uma mensagem para @BotFather no Telegram
- Envie
/newbote siga as instruções - 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 —
/tasksmostra 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