How to create AI agent for Telegram

• Um navegador para o Prostir e o app oficial do Telegram em qualquer dispositivo onde você consiga abrir @BotFather.
• Uma conta Telegram que será dona do bot que você vai criar.
• Um workspace no Prostir onde você vai criar o agente IA e conectar o canal Telegram.
• Um Agent publicado com channel runtime model explícito, Channels ativado no Agent e saldo positivo de Model Usage Credits se você escolher um modelo hospedado pelo Prostir. A alternativa é uma conexão BYOK salva.

Você precisa de um navegador para o Prostir, do app do Telegram e do seu workspace no Prostir.

1. 01
   Abra o Telegram.

   Use o app oficial do Telegram no computador ou celular. Entre na conta do Telegram que deve ser dona do bot.

2. 02
   Encontre o BotFather real.

   Na busca do Telegram, digite BotFather e abra @BotFather. É o bot oficial do Telegram para criar e gerenciar bots.

3. 03
   Crie o bot do Telegram com o BotFather.

   Envie /newbot. O BotFather pede primeiro um display name e depois um username. O username precisa terminar em bot, por exemplo your_agent_bot ou YourAgentBot.

4. 04
   Copie o bot token.

   O BotFather devolve um token parecido com 123456:ABC... Trate como senha: não cole em docs públicos, tickets, screenshots ou chats. Se perder ou vazar, use /token no BotFather para gerar outro.

5. 05
   Crie o agente no Prostir.

   Abra o Prostir no navegador, crie um agente, escreva o que ele deve fazer, adicione o knowledge ou as tools necessárias, escolha o modelo e publique quando estiver pronto.

6. 06
   Configure o runtime do canal e salve o Telegram.

   Em Channels, escolha primeiro o channel runtime model explícito do Agent: uma conexão BYOK salva ou um modelo hospedado pelo Prostir com saldo positivo de Model Usage Credits. Ative Channels no Agent, escolha Telegram, cole o BotFather token e o username sem @, e aperte Save. O Prostir registra o webhook e ativa o Telegram somente quando publicação, modelo, switch, credenciais e créditos passam nas verificações; caso contrário, o canal fica desativado com um erro visível.

7. 07
   Teste pelo Telegram.

   Abra https://t.me/your_agent_bot, aperte Start, mande uma pergunta real e veja a conversa aparecer no Prostir. Se precisar de você, entre pela aba Channels como humano.

O setup é simples porque as partes difíceis têm dono claro.

Navegador, app do Telegram, BotFather token, Save.

• A pessoa aperta Start no Telegram, faz uma pergunta e o agente Prostir publicado responde a partir das instructions, knowledge, tools e modelo escolhido.
• Você não configura setWebhook manualmente: o Prostir usa a superfície pública HTTPS do agente e valida os callback secrets do Telegram no runtime edge.
• Se o token vazar, gere outro no BotFather, cole o novo token no canal Telegram do Prostir, aperte Save de novo e continue.