FlowAgents

Conectar seu agente de IA ao Telegram

Publicado em 16. novembro 2026

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

  1. Na barra lateral, em FlowAgents, abra Agentes de IA.
  2. 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.
  3. Abre-se a janela Conectar o Telegram para … com as três etapas Verificar o bot, Liberar a pessoa e Concluído.

A linha de um agente de IA na lista de agentes com a dica Conectar o Telegram sobre o ícone do Telegram

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

  1. Cole o token no campo Token do bot.
  2. Se quiser, preencha também o Nome de usuário do bot, sem o @ inicial. Assim nós o comparamos com o token.
  3. Clique em Verificar o bot.

A primeira etapa Verificar o bot com os campos Token do bot e Nome de usuário do 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.

A etapa Liberar a pessoa com QR code, o botão Abrir o bot no Telegram e o aviso de que a mensagem está sendo aguardada

A etapa Liberar a pessoa depois de iniciar o bot: Encontrado: Anna, com ID de Telegram e nome de usuário

  • 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.

Este artigo foi útil?

Voltar para Telegram