Guida pratica

How to create AI agent for Telegram

Guida passo passo: crea e pubblica l'Agent, scegli il channel runtime model esplicito, attiva Channels a livello di Agent e poi salva BotFather token e username. Con un modello ospitato serve anche un saldo positivo di Model Usage Credits prima di poter attivare e provare Telegram.

Cosa ti serve prima di iniziare

Un browser per Prostir e l'app ufficiale Telegram su qualsiasi dispositivo dove puoi aprire @BotFather.
Un account Telegram che sarà proprietario del bot che stai creando.
Un workspace Prostir dove creerai l'agente IA e collegherai il canale Telegram.
Un Agent pubblicato con channel runtime model esplicito, Channels attivo a livello di Agent e saldo positivo di Model Usage Credits se scegli un modello ospitato da Prostir. In alternativa serve una connessione BYOK salvata.

Come creare l'agente IA in Telegram

Ti servono un browser per Prostir, l'app Telegram e il tuo workspace Prostir.

01
Apri Telegram.
Usa l'app ufficiale Telegram su computer o telefono. Entra con l'account Telegram che deve possedere il bot.
02
Trova il vero BotFather.
Nella ricerca di Telegram scrivi BotFather e apri @BotFather. È il bot ufficiale di Telegram per creare e gestire bot.
03
Crea il bot Telegram con BotFather.
Invia /newbot. BotFather ti chiede prima un display name e poi uno username. Lo username deve finire con bot, per esempio your_agent_bot o YourAgentBot.
04
Copia il bot token.
BotFather restituisce un token simile a 123456:ABC... Trattalo come una password: non incollarlo in docs pubblici, ticket, screenshot o chat. Se lo perdi o finisce fuori, usa /token in BotFather per generarne uno nuovo.
05
Crea l'agente in Prostir.
Apri Prostir nel browser, crea un agente, scrivi cosa deve fare, aggiungi knowledge o tools necessari, scegli il modello e pubblica quando l'agente è pronto.
06
Configura il runtime del canale e salva Telegram.
In Channels, scegli prima il channel runtime model esplicito dell'Agent: una connessione BYOK salvata o un modello ospitato da Prostir con saldo positivo di Model Usage Credits. Attiva Channels a livello di Agent, scegli Telegram, incolla BotFather token e username senza @, poi premi Save. Prostir registra il webhook e attiva Telegram solo se pubblicazione, modello, switch, credenziali e crediti superano i controlli; altrimenti il canale resta disattivato con un errore visibile.
07
Testa da Telegram.
Apri https://t.me/your_agent_bot, premi Start, invia una domanda reale e guarda la conversazione comparire in Prostir. Se serve una persona, entra da Channels come umano.

Cosa prepari prima di premere Save

Il setup è semplice perché ogni parte difficile ha un proprietario chiaro.

dataBotFather tokenLa credenziale segreta per Telegram Bot API. Incollala solo in Prostir.

linkTelegram usernameLo username del bot che finisce con bot, usato per il link pubblico t.me.

docagent instructionsCosa deve rispondere l'agente, cosa deve rifiutare e quando deve chiamare una persona.

docknowledge or toolsFAQ, docs, CRM/MCP tools, ricerca ordini, prenotazioni o support workflows che l'agente Telegram può usare.

Passo finale in Prostir: token, username, Save

Browser, app Telegram, BotFather token, Save.

Prostir Studio

Ho creato @YourAgentBot con BotFather in Telegram e ho copiato il token. Voglio collegarlo al mio support agent.

Crea o apri l'agente in Prostir. Aggiungi prima support instructions e knowledge, così il canale Telegram risponde da materiale reale.

L'agente è pronto. Dove metto la Telegram key?

Apri Channels, scegli il channel runtime model esplicito, verifica il saldo positivo se è ospitato e attiva Channels a livello di Agent. Poi scegli Telegram, incolla BotFather token, inserisci YourAgentBot come bot username e premi Save.

Prostir

Impostazioni Telegram salvate. Il webhook viene registrato e il canale si attiva solo dopo i controlli su Agent pubblicato, channel model, Channels switch, credenziali e crediti ospitati; altrimenti resta disattivato con un errore visibile.

Live

Telegram connected · https://t.me/your_agent_bot · Conversazioni visibili in Channels

Prova l'agente IA in Telegram

Un utente preme Start in Telegram, fa una domanda e l'agente Prostir pubblicato risponde da instructions, knowledge, tools e modello scelto.
Non configuri setWebhook a mano: Prostir usa la superficie pubblica HTTPS dell'agente e valida i callback secrets Telegram sul runtime edge.
Se il token finisce fuori, ruotalo in BotFather, incolla il nuovo token nel canale Telegram in Prostir, premi di nuovo Save e continua.

Cosa pubblichi

Alla fine hai un agente IA Prostir pubblicato su https://t.me/your_agent_bot. Telegram manda i messaggi a Prostir tramite il webhook HTTPS registrato, e l'agente risponde dalle sue instructions, knowledge, tools e modello.

Soluzioni

Agente conversazionale IA multicanale con un’unica fonte di verità

Mantieni un Agent controllato e collega soltanto i canali che rispettano i requisiti attuali.

Chiedi una prova su Telegram Vedi la soluzione

Soluzioni

Scegli i canali che servono davvero

Raccontaci dove arrivano le conversazioni e cosa deve restare coerente.