Se seu agente de IA já está funcionando, mas ainda não tem um bot do Telegram, você mesmo pode conectá-lo. Basta o token do bot e alguns minutos. Depois disso, você escreve para o agente diretamente no Telegram.
Antes de começar
- Você criou um bot próprio para o agente e tem o token em mãos, veja Criar um bot do Telegram com o BotFather e copiar o token.
- A pessoa a quem o agente pertence no organograma tem o Telegram no celular. Só ela vai poder escrever para o agente depois.
- Você tem permissão para conectar o agente: é o seu próprio agente, ou você pode editar o FlowAgents para a equipe inteira e, assim, também conecta os agentes dos membros da sua equipe. Saiba mais em Quem pode fazer o quê no FlowAgents?
Passo 1: abrir a janela
- Na barra lateral, em FlowAgents, abra Agentes de IA.
- Em um agente sem bot, o ícone do Telegram na coluna Ações fica laranja. Ao passar o mouse sobre ele, aparece Conectar o Telegram. Clique nele.
- Abre-se a janela Conectar o Telegram para … com as três etapas Verificar o bot, Liberar a pessoa e Concluído.

Se você recebeu de nós um link com esta cara: https://flowagents.one/dashboard/agenten?telegram=…, a janela abre direto depois do login. Se o agente não pertencer a você ou já tiver um bot, a janela não abre.
Passo 2: verificar o bot
- Cole o token no campo Token do bot.
- Se quiser, preencha também o Nome de usuário do bot, sem o @ inicial. Assim nós o comparamos com o token.
- Clique em Verificar o bot.

Perguntamos ao Telegram se o token é válido e se o bot ainda está livre. O token é enviado criptografado e nunca mais é exibido. Se estiver tudo certo, aparece no topo O bot @… foi verificado. Com Usar outro bot você volta e digita outro token.
Se você fechar a janela sem querer, não precisa verificar o bot de novo na hora: se abrir a janela outra vez em até 30 minutos, continua na etapa Liberar a pessoa.
Passo 3: liberar a pessoa
Só uma pessoa liberada pode escrever para o agente, e é a pessoa a quem o agente pertence no organograma. A janela mostra o nome dela no título ID de Telegram de …. Para isso precisamos do ID do Telegram dela.
- Se o ID já for conhecido, a janela mostra Este ID de Telegram já está cadastrado. com os últimos algarismos para conferência. Nesse caso, só o nosso suporte pode cadastrar outro ID.
- Se ele estiver faltando, a janela mostra um QR code e o botão Abrir o bot no Telegram. A pessoa lê o código com o celular ou toca no botão e depois toca em Iniciar no Telegram. Em poucos segundos aparece na janela Encontrado: com o primeiro nome dela.


- Prefere fazer manualmente? Em Digitar o ID você informa o ID de Telegram e, se houver, o Nome de usuário do Telegram, veja Descobrir seu ID do Telegram. Com Capturar pelo bot você volta ao QR code.
Passo 4: conectar
Clique em Conectar. A janela mostra então O Telegram está sendo conectado: o bot é configurado no servidor do agente, o que costuma levar um ou dois minutos. Depois disso o agente responde no Telegram, e na lista o ícone laranja vira um ícone normal do Telegram com a dica Abrir o Telegram. Para testar, mande um simples "Olá" para o agente.
Se algo der errado
- "Este não é um token de bot válido. Copie-o por completo da mensagem do BotFather.": falta uma parte do token. Copie-o de novo com todos os caracteres antes e depois dos dois-pontos.
- "O Telegram não conhece este token. Verifique-o ou crie um novo com /token no BotFather.": o token está errado ou foi renovado no BotFather. Copie de novo o token atual.
- "O token pertence ao bot @…, não ao nome digitado.": o nome de usuário não corresponde ao token. Deixe o campo vazio ou corrija o nome.
- "Este bot já é usado por outro programa. Crie um bot próprio para o agente.": o bot já está funcionando em outro lugar. Crie um bot novo para o agente.
- "Tentativas demais. Aguarde um pouco e tente de novo.": são possíveis dez verificações por hora. Aguarde um pouco e tente de novo.
- "A verificação do bot expirou. Digite o token de novo.": passaram mais de 30 minutos desde a verificação. Clique em Usar outro bot e digite o token de novo.
- Nenhuma mensagem chega: a pessoa precisa mesmo tocar em Iniciar no Telegram. Depois de cinco minutos a janela para de aguardar e mostra Ainda não chegou nenhuma mensagem. Com Aguardar de novo o processo continua.
- "Já existe outro ID do Telegram registrado para esta pessoa. Somente o nosso suporte pode inserir um ID diferente.": fale com a gente e diga de qual agente se trata.
- O ícone mostra "Abrir o Telegram" em vez de "Conectar o Telegram": o agente já tem um bot, e um clique abre o chat. Se você precisar de outro bot, nós o cadastramos para você, é só falar com a gente.
- "Não é possível conectar o Telegram aqui para este agente. Ele já tem um bot ou está sendo configurado." ou nenhum ícone do Telegram no agente: o agente ainda está sendo configurado, ainda não está ativo ou pertence a outra pessoa da equipe. Fale com a gente se isso não fizer sentido.
- O agente não responde depois de conectado: leia Seu agente de IA não responde no Telegram.