Conectando o Telegram

Na aba Gatilhos do editor do agente, o card Telegram conecta um bot do Telegram diretamente a este agente — mensagens recebidas pelo bot são respondidas automaticamente, usando o mesmo prompt, modelo, ferramentas e bases de conhecimento configurados nele.

Criando o bot

O bot em si é criado fora da Flow2Agents, falando com o @BotFather no próprio Telegram (/newbot, escolher nome e usuário). O BotFather devolve um token no formato 123456:ABC-... — é esse valor que se cola no campo Token do bot aqui.

Conectando

Colar o token e clicar Conectar valida o token direto com a API do Telegram antes de salvar qualquer coisa — um token malformado ou inexistente é recusado com um erro, sem deixar nenhum resíduo configurado. Uma vez conectado, o card mostra o @usuário do bot como confirmação.

O que o agente recebe de um chat do Telegram

Cada conversa do Telegram vira uma conversa própria na plataforma (visível no Hub de Chat com o selo “Telegram”), identificada pelo chat do Telegram — múltiplas pessoas falando com o mesmo bot geram conversas separadas. O título é derivado automaticamente da primeira mensagem recebida (por isso pode aparecer como /start, se for o primeiro comando que o Telegram manda antes do usuário digitar algo).

Guardrail, RAG, ferramentas e o limite de chamadas por turno funcionam exatamente como em qualquer outro canal — não há tratamento especial para mensagens vindas do Telegram. A única diferença de comportamento: se o Guardrail bloquear uma mensagem vinda do Telegram, o bot simplesmente não responde nada (sem uma explicação de “bloqueado por segurança”), já que não há uma interface de usuário logado para mostrar esse aviso.

Desconectando

O botão Desconectar no mesmo card remove a integração — o bot para de responder, mas o histórico de conversas já geradas por ele permanece no Hub de Chat.