Prostir

Artigo

How to create AI agent for Telegram

Artigo passo a passo: como criar um agente IA no Telegram pelo Windows. Você cria um bot do Telegram no BotFather, copia o bot token, cria o agente no Prostir, abre Channels, escolhe Telegram, cola o token, aperta Save, publica e testa o agente pelo Telegram.

01

O que você precisa antes de começar

  • Um computador Windows com navegador e Telegram Desktop ou Telegram Web.
  • 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.
02

Como criar o agente IA no Telegram

Você precisa de um navegador no Windows, Telegram Desktop ou Telegram Web, e o seu workspace no Prostir.

  1. 01
    Abra o Telegram no Windows.

    Use o Telegram Desktop do site oficial do Telegram ou o Telegram Web. 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 Windows, 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
    Cole o token e aperte Save no Prostir.

    Abra a aba Channels do agente, escolha Telegram, cole o BotFather token, adicione o bot username sem @ e aperte Save. O Prostir registra o webhook do Telegram na superfície pública HTTPS do agente.

  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.

03

O que preparar antes de apertar Save

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

data BotFather token A credencial secreta para a Telegram Bot API. Cole só no Prostir.
doc agent instructions O que o agente deve responder, o que deve recusar e quando chamar uma pessoa.
doc knowledge or tools FAQs, docs, CRM/MCP tools, consulta de pedidos, agenda ou support workflows que o agente Telegram pode usar.
04

Passo final no Prostir: token, username, Save

Windows, navegador, BotFather token, Save.

Prostir Studio

Criei @YourAgentBot com o BotFather no Windows e copiei o token. Quero conectar ao meu support agent.

Crie ou abra o agente no Prostir. Adicione primeiro as support instructions e o knowledge para o canal Telegram responder com material real.

O agente está pronto. Onde coloco a Telegram key?

Abra Channels, escolha Telegram, cole o BotFather token, digite YourAgentBot como bot username e aperte Save.

Prostir

Telegram channel saved. Webhook registered for the published agent. Channel enabled.

Live

Telegram connected · https://t.me/your_agent_bot · Conversas visíveis em Channels

05

Teste o agente IA no Telegram

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

O que você publica

No final, você tem um agente IA do Prostir publicado em https://t.me/your_agent_bot. O Telegram envia mensagens ao Prostir pelo webhook HTTPS registrado, e o agente responde usando suas instruções, knowledge, tools e modelo.

Pronto para lançar?

Uma tarde da ideia ao link no ar.

Coloque o que só você tem. Escreva as regras em linguagem simples. Abra o link no ChatGPT, no Claude ou no seu site. Publique o agente que só você poderia publicar.

Precisa de escala sob medida, white-label ou setup dedicado? Fale com vendas.