Creare il bot Telegram di un account (BotFather, Secretary Mode, token)
Per creare il bot Telegram di un account LanaChat, Lei invia /newbot a @BotFather su Telegram, attiva il Secretary Mode del bot, poi incolla in LanaChat il token che BotFather Le invia. Ci vogliono tre minuti, è gratuito e Telegram Premium non serve.
Ogni account Telegram in LanaChat risponde ai fan con un bot tutto suo. Questi tre passaggi si fanno una volta per bot, nel passaggio Create the bot dell'assistente Add account (Studio › Telegram Accounts). Poi collega il bot all'account Telegram della creator, in Telegram Business (ultima parte di questa guida).
Prima di iniziare #
- Telegram aperto su un telefono o un computer, su qualsiasi account Telegram (va bene il Suo: il bot non è legato all'account che lo crea).
- Nella Console: Studio › Telegram Accounts → Add account, con i passaggi Creator e Details completati. Arriva al passaggio 3, Create the bot.
- L'accesso all'account Telegram della creator per l'ultima parte (il collegamento in Telegram Business).
Passaggio 1: creare il bot con /newbot #
- Su Telegram, cerchi @BotFather e lo apra. Controlli la spunta blu: è l'unico ufficiale.
- Prema Start, poi invii
/newbot. - BotFather chiede un nome. È il nome visualizzato del bot, per esempio *Julia Assistant*. Va bene qualsiasi testo, spazi compresi, e può cambiarlo più tardi.
- BotFather chiede un nome utente. È la @ del bot, unica in tutto Telegram. Le regole:
- Da 5 a 32 caratteri: solo lettere, cifre e
_, senza spazi né trattini. - Deve finire con
bot(oBot), per esempiojulia_it_5_botoJuliaItBot. - Non si può più cambiare: ne scelga uno che riconoscerà nell'elenco.
- Da 5 a 32 caratteri: solo lettere, cifre e
- BotFather risponde *Done! Congratulations on your new bot.* con il link del bot e il suo token.
Suggerimento Dia al bot il nome dell'account che gestirà, per esempio julia_it_meta_5_bot per l'account *Julia IT Meta Ads 5*. Con più account, vede a colpo d'occhio quale bot gestisce quale.
Il nome utente è già preso: cosa faccio? #
BotFather risponde *Sorry, this username is already taken.* I nomi utente sono unici in tutto Telegram: aggiunga una parola o una cifra e lo invii di nuovo: julia_it_5_bot, poi julia_it_5b_bot, e così via. Se BotFather risponde che il nome utente non è valido, controlli che finisca con bot e usi solo lettere, cifre e _.
Nell'assistente, spunti la prima casella, poi inserisca il nome utente in Enter the bot username (con o senza la @). Il campo lo accetta solo se rispetta le regole qui sopra.
Passaggio 2: attivare Secretary Mode (obbligatorio) #
Secretary Mode è il nuovo nome che BotFather dà a Business Mode. Senza di esso, Telegram rifiuta il bot in Telegram Business e l'account non può mai connettersi.
- In @BotFather, invii
/mybots. - Scelga il bot appena creato.
- Prema Bot Settings, poi Secretary Mode, poi Turn on.
- BotFather conferma: *Secretary Mode is currently enabled for @your_bot*.
Spunti la casella Turn on Secretary Mode nell'assistente solo quando vede questa frase. La casella è indicata come obbligatoria: senza di essa Next resta bloccato.
Passaggio 3: incollare il token in LanaChat #
Il token si trova nel messaggio *Done! Congratulations* di BotFather, dopo *Use this token to access the HTTP API*. Ha questo aspetto: 12345678:AAxxxx…, cioè da 8 a 10 cifre, i due punti, poi 35 caratteri.
- In BotFather, tocchi il token per copiarlo per intero.
- Nell'assistente, lo incolli in Paste the token BotFather sent.
- LanaChat lo verifica e mostra *Token accepted. It is never shown again.* Prema Next.
Se ha perso il messaggio, invii /mybots in @BotFather, scelga il bot, poi API Token: BotFather lo mostra di nuovo.
Tenga segreto il token #
Il token è la password del bot: chiunque lo abbia può leggere e inviare messaggi come il bot, quindi sull'account della creator.
- Lo incolli solo in LanaChat. Non lo invii mai in una chat, un'e-mail, uno screenshot o un ticket di assistenza. L'assistenza LanaChat non Glielo chiede mai.
- Se è trapelato, lo revochi subito: in @BotFather invii
/revokee scelga il bot (oppure/mybots→ il bot → API Token → Revoke current token). Il vecchio token smette subito di funzionare e BotFather ne invia uno nuovo. - Poi dia il nuovo token a LanaChat: in Studio › Telegram Accounts, apra il menu Actions della riga → Replace bot token e lo incolli. Lì si accetta solo un nuovo token dello stesso bot.
Collegare il bot all'account della creator #
L'assistente passa quindi al passaggio 4, Connect in Telegram. Sull'account Telegram della creator (non sull'account che ha creato il bot):
- Apra Settings → Telegram Business → Chat Automation (su alcune versioni, Chatbots).
- Aggiunga il bot con la sua @ (l'assistente ha un pulsante Copy) e mantenga *All Private Chats Except…*.
- In Bot permissions, attivi Manage Messages (indicato come Required): LanaChat non può rispondere senza.
- Manage Profile, Manage Gifts and Stars e Manage Stories sono facoltativi, consigliati. Dentro Gifts and Stars, lasci disattivati Transfer Stars e Transfer and Upgrade Gifts, a meno che non voglia che LanaChat sposti denaro.
La finestra passa da sola a Connected as @username. Prema Done. L'IA del nuovo account è spenta: la accenda quando la creator è pronta. Gli stati e cosa fare se la connessione resta in attesa sono in Collegare account Telegram.
Quali sono gli errori più comuni? #
- Secretary Mode dimenticato: il bot non si può aggiungere in Chat Automation, oppure l'account resta su Waiting for Telegram. Lo attivi in @BotFather (passaggio 2), poi aggiunga di nuovo il bot su Telegram.
- Token incollato male: *This is not a bot token: 8 to 10 digits, a colon, then 35 characters.* oppure *Token not accepted*. Basta uno spazio, un a capo o un carattere mancante. Lo copi di nuovo da BotFather e lo incolli da solo.
- Token di un altro bot: quando sostituisce un token, il token di un altro bot viene rifiutato (*This token belongs to another bot*). Incolli il nuovo token dello stesso bot.
- Bot già usato da un altro account: l'assistente mostra *This bot is already in use* e propone Use it for this account too. Accetti solo per un account della stessa creator: le Stars dei due account arrivano sullo stesso saldo del bot. Altrimenti, crei un nuovo bot con
/newbot. - Manage Messages disattivato: l'account si connette ma LanaChat non può rispondere. In Chat Automation, attivi Manage Messages con Reply to Messages.
- Bot aggiunto all'account Telegram sbagliato: il bot va aggiunto sull'account della creator, quello a cui scrivono i fan. Un account Telegram tiene un solo bot alla volta: aggiungerne uno nuovo sostituisce il precedente.
FAQ #
Creare un bot Telegram costa qualcosa? #
No. @BotFather crea i bot gratuitamente, e Telegram Premium non serve per far gestire un account a un bot Secretary.
Posso creare il bot dal mio account Telegram? #
Sì. Il bot appartiene all'account Telegram che l'ha creato in BotFather, ma si può aggiungere a qualsiasi account in Telegram Business. Solo l'ultima parte (Chat Automation) va fatta sull'account della creator.
Serve un bot per ogni account Telegram? #
Di default sì: un bot per account tiene separate le Stars di ogni account. Un bot può anche gestire più account della stessa creator, scelto sotto Use an existing bot al passaggio 3.
Posso rinominare il bot più tardi? #
Il nome sì: /mybots → il bot → Edit Bot → Edit Name. Il nome utente (la @) non si può cambiare: crei un nuovo bot e usi Change bot in Edit dell'account se Le serve un altro.
Cosa faccio se il mio token è trapelato? #
Invii /revoke a @BotFather e scelga il bot: il vecchio token smette subito di funzionare. Poi incolli quello nuovo in Studio › Telegram Accounts, riga Actions → Replace bot token.
Perché BotFather non mostra Secretary Mode? #
Aggiorni l'app Telegram, invii di nuovo /mybots e apra Bot Settings. Sulle versioni meno recenti l'impostazione si chiama ancora Business Mode: la attivi, è lo stesso interruttore.
Altre informazioni nella pagina della funzione Account Telegram.