Crear el bot de Telegram de una cuenta (BotFather, Secretary Mode, token)

Para crear el bot de Telegram de una cuenta de LanaChat, envíe /newbot a @BotFather en Telegram, active el Secretary Mode del bot y luego pegue en LanaChat el token que le envía BotFather. Lleva tres minutos, es gratis y no necesita Telegram Premium.

Cada cuenta de Telegram en LanaChat responde a los fans con su propio bot. Estos tres pasos se hacen una vez por bot, en el paso Create the bot del asistente Add account (Studio › Telegram Accounts). Después vincula el bot a la cuenta de Telegram de la creadora, en Telegram Business (última parte de esta guía).

Antes de empezar #

• Telegram abierto en un teléfono o un ordenador, en cualquier cuenta de Telegram (la suya sirve: el bot no está ligado a la cuenta que lo crea).
• En la Console: Studio › Telegram Accounts → Add account, con los pasos Creator y Details terminados. Llega al paso 3, Create the bot.
• Acceso a la cuenta de Telegram de la creadora para la última parte (la vinculación en Telegram Business).

Paso 1: crear el bot con /newbot #

1. En Telegram, busque @BotFather y ábralo. Compruebe la marca azul: es el único oficial.
2. Pulse Start y envíe /newbot.
3. BotFather pide un nombre. Es el nombre visible del bot, por ejemplo *Julia Assistant*. Sirve cualquier texto, con espacios incluidos, y puede cambiarlo más tarde.
4. BotFather pide un nombre de usuario. Es la @ del bot, única en todo Telegram. Sus reglas:
   • De 5 a 32 caracteres: solo letras, cifras y _, sin espacios ni guiones.
   • Debe terminar en bot (o Bot), por ejemplo julia_it_5_bot o JuliaItBot.
   • No se puede cambiar después: elija uno que reconozca en la lista.
5. BotFather responde *Done! Congratulations on your new bot.* con el enlace del bot y su token.

El nombre de usuario ya está ocupado: ¿qué hago? #

BotFather responde *Sorry, this username is already taken.* Los nombres de usuario son únicos en todo Telegram: añada una palabra o una cifra y envíelo de nuevo: julia_it_5_bot, luego julia_it_5b_bot, y así sucesivamente. Si BotFather responde que el nombre de usuario no es válido, compruebe que termina en bot y que solo usa letras, cifras y _.

En el asistente, marque la primera casilla y escriba el nombre de usuario en Enter the bot username (con o sin la @). El campo solo lo acepta si cumple las reglas anteriores.

Paso 2: activar Secretary Mode (obligatorio) #

Secretary Mode es el nuevo nombre que BotFather da a Business Mode. Sin él, Telegram rechaza el bot en Telegram Business y la cuenta nunca podrá conectarse.

1. En @BotFather, envíe /mybots.
2. Elija el bot que acaba de crear.
3. Pulse Bot Settings, luego Secretary Mode y luego Turn on.
4. BotFather confirma: *Secretary Mode is currently enabled for @your_bot*.

Marque la casilla Turn on Secretary Mode en el asistente solo cuando vea esa frase. La casilla está marcada como obligatoria: Next sigue bloqueado sin ella.

Paso 3: pegar el token en LanaChat #

El token está en el mensaje *Done! Congratulations* de BotFather, después de *Use this token to access the HTTP API*. Tiene este aspecto: 12345678:AAxxxx…, es decir, de 8 a 10 cifras, dos puntos y luego 35 caracteres.

1. En BotFather, toque el token para copiarlo entero.
2. En el asistente, péguelo en Paste the token BotFather sent.
3. LanaChat lo comprueba y muestra *Token accepted. It is never shown again.* Pulse Next.

Si perdió el mensaje, envíe /mybots en @BotFather, elija el bot y luego API Token: BotFather lo muestra de nuevo.

Mantenga el token en secreto #

El token es la contraseña del bot: quien lo tenga puede leer y enviar mensajes como el bot, es decir, en la cuenta de la creadora.

• Péguelo solo en LanaChat. Nunca lo envíe en un chat, un correo, una captura de pantalla o un ticket de soporte. El soporte de LanaChat nunca se lo pide.
• Si se filtró, revóquelo de inmediato: en @BotFather envíe /revoke y elija el bot (o /mybots → el bot → API Token → Revoke current token). El token antiguo deja de funcionar al momento y BotFather envía uno nuevo.
• Después dé el nuevo token a LanaChat: en Studio › Telegram Accounts, abra el menú Actions de la fila → Replace bot token y péguelo. Ahí solo se acepta un token nuevo del mismo bot.

Vincular el bot a la cuenta de la creadora #

El asistente pasa entonces al paso 4, Connect in Telegram. En la cuenta de Telegram de la creadora (no en la cuenta que creó el bot):

1. Abra Settings → Telegram Business → Chat Automation (en algunas versiones, Chatbots).
2. Añada el bot por su @ (el asistente tiene un botón Copy) y mantenga *All Private Chats Except…*.
3. En Bot permissions, active Manage Messages (marcado como Required): LanaChat no puede responder sin él.
4. Manage Profile, Manage Gifts and Stars y Manage Stories son opcionales, recomendados. Dentro de Gifts and Stars, deje Transfer Stars y Transfer and Upgrade Gifts desactivados, salvo que quiera que LanaChat mueva dinero.

La ventana pasa sola a Connected as @username. Pulse Done. La IA de la nueva cuenta está apagada: enciéndala cuando la creadora esté lista. Los estados y qué hacer si la conexión espera están en Conectar cuentas de Telegram.

¿Cuáles son los errores más frecuentes? #

• Secretary Mode olvidado: el bot no se puede añadir en Chat Automation, o la cuenta se queda en Waiting for Telegram. Actívelo en @BotFather (paso 2) y vuelva a añadir el bot en Telegram.
• Token mal pegado: *This is not a bot token: 8 to 10 digits, a colon, then 35 characters.* o *Token not accepted*. Basta un espacio, un salto de línea o un carácter que falta. Cópielo de nuevo desde BotFather y péguelo solo.
• Token de otro bot: al sustituir un token, se rechaza el token de otro bot (*This token belongs to another bot*). Pegue el nuevo token del mismo bot.
• Bot ya usado por otra cuenta: el asistente muestra *This bot is already in use* y ofrece Use it for this account too. Acepte solo para una cuenta de la misma creadora: las Stars de ambas cuentas llegan al mismo saldo del bot. Si no, cree un bot nuevo con /newbot.
• Manage Messages desactivado: la cuenta se conecta pero LanaChat no puede responder. En Chat Automation, active Manage Messages con Reply to Messages.
• Bot añadido a la cuenta de Telegram equivocada: el bot debe añadirse en la cuenta de la creadora, a la que escriben los fans. Una cuenta de Telegram tiene un solo bot a la vez: añadir uno nuevo sustituye al anterior.

FAQ #

¿Crear un bot de Telegram cuesta algo? #

No. @BotFather crea bots gratis, y no se necesita Telegram Premium para que un bot Secretary gestione una cuenta.

¿Puedo crear el bot desde mi propia cuenta de Telegram? #

Sí. El bot pertenece a la cuenta de Telegram que lo creó en BotFather, pero se puede añadir a cualquier cuenta en Telegram Business. Solo la última parte (Chat Automation) debe hacerse en la cuenta de la creadora.

¿Necesito un bot por cada cuenta de Telegram? #

Por defecto, sí: un bot por cuenta mantiene separadas las Stars de cada cuenta. Un bot también puede gestionar varias cuentas de la misma creadora, eligiéndolo en Use an existing bot en el paso 3.

¿Puedo cambiar el nombre del bot más tarde? #

El nombre, sí: /mybots → el bot → Edit Bot → Edit Name. El nombre de usuario (la @) no se puede cambiar: cree un bot nuevo y use Change bot en Edit de la cuenta si necesita otro.

¿Qué hago si mi token se filtró? #

Envíe /revoke a @BotFather y elija el bot: el token antiguo deja de funcionar al momento. Después pegue el nuevo en Studio › Telegram Accounts, fila Actions → Replace bot token.

¿Por qué BotFather no muestra Secretary Mode? #

Actualice la aplicación de Telegram, envíe de nuevo /mybots y abra Bot Settings. En versiones antiguas el ajuste todavía se llama Business Mode: actívelo, es el mismo interruptor.

Más información en la página de la función Cuentas de Telegram.