Guía de BotFather: crea y administra un bot de Telegram

Respuesta rápida

BotFather es el propio bot de Telegram para registrar y configurar bots, y es gratuito, sin ningún cargo por mensaje. Para crear un bot, abre Telegram, busca "@BotFather", envía /newbot, dale un nombre visible y un nombre de usuario que termine en "bot", y te responderá con un token de API parecido a 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Ahí termina el trabajo de BotFather: registra el bot pero no le da ningún comportamiento, así que pegas ese token en tu propio código alojado o en un creador sin código como TeleMinute ($3.99 por semana, $9.99 por mes, o $49.99 pago único de por vida) y ahí diseñas las respuestas.

¿Qué es BotFather en Telegram?

BotFather es un bot oficial operado por Telegram, con el nombre de usuario @BotFather, y es la única forma de registrar un bot nuevo. Hablas con él como con cualquier otro chat: le envías comandos, te hace preguntas, tú respondes y él guarda el resultado.

BotFather es gratuito. Crear bots no cuesta nada, Telegram no cobra una cuota mensual, y no hay ningún cargo por mensaje enviado, que es la principal diferencia de costo frente a la API de WhatsApp Business. Puedes registrar varios bots desde una misma cuenta de Telegram.

Antes de presionar Iniciar, verifica que la cuenta que abriste tenga la insignia azul de verificación y el nombre de usuario exacto @BotFather. Existen cuentas falsas con nombres de usuario parecidos, y su único propósito es recolectar los tokens que la gente les pega.

¿Cómo se crea un bot con BotFather?

Envías /newbot, respondes dos preguntas y copias el token. Todo el proceso toma unos dos minutos y se ve así:

Abre @BotFather. Busca "BotFather" en Telegram, abre la cuenta verificada y presiona Iniciar.
Envía /newbot. BotFather te responderá pidiéndote el nombre de tu nuevo bot.
Envía el nombre visible. Por ejemplo "Sunrise Cafe". Es lo que los usuarios ven en la parte superior del chat. Se permiten espacios, mayúsculas y emojis, y puedes cambiarlo después con /setname.
Envía el nombre de usuario. Debe tener entre 5 y 32 caracteres, usar solo letras latinas, dígitos y guiones bajos, y debe terminar en la palabra "bot": SunriseCafeBot y sunrise_cafe_bot son válidos, SunriseCafe no lo es. Los nombres de usuario son únicos en todo Telegram, así que si el tuyo ya está ocupado, BotFather simplemente te pedirá otro.
Copia el token. BotFather te felicita y muestra un token de API como 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Cópialo en un lugar seguro y trátalo como una contraseña.
Abre tu bot y presiona Iniciar. Toca el enlace t.me en la respuesta de BotFather. El bot ya existe, pero todavía no responderá nada. Eso es lo esperado.
Pega el token en lo que sea que hará funcionar al bot. Tu propio código de servidor, o un creador sin código donde defines los comandos y las respuestas. El bot queda activo en el momento en que algo empieza a recibir actualizaciones para ese token.

Elige el nombre de usuario con cuidado. BotFather tiene comandos para cambiar el nombre, la foto y la descripción de un bot, pero ninguno para cambiar su nombre de usuario, así que en la práctica un cambio de nombre de usuario significa crear un bot nuevo y redirigir tus enlaces hacia él.

Si quieres ver el recorrido completo para principiantes con capturas de pantalla de lo que pasa después del token, revisa cómo crear un bot de Telegram sin programar.

¿Cuáles son todos los comandos de BotFather?

Estos son los comandos que importan para crear y hacer funcionar un bot. Enviar /help a BotFather muestra la lista actual en cualquier momento, y /mybots expone casi todos estos comandos como botones.

Comando	Qué hace	Cuándo lo necesitas
`/newbot`	Registra un bot nuevo: pide un nombre visible, luego un nombre de usuario que termine en "bot", y después devuelve el token de API.	Una vez por bot, al principio de todo.
`/mybots`	Abre un menú con todos los bots que tienes, con botones para Token de API, Editar bot, Configuración del bot y Eliminar bot.	La ruta más rápida a todo lo de abajo, sin memorizar comandos.
`/token`	Muestra el token de API actual del bot que selecciones. No cambia el token.	Perdiste el token pero no tienes motivos para pensar que se filtró.
`/revoke`	Invalida el token actual de inmediato y emite uno nuevo en su lugar.	El token se filtró, se subió a un repositorio, o un colaborador externo dejó de trabajar contigo.
`/setname`	Cambia el nombre visible en la parte superior del chat. El nombre de usuario no se modifica.	Cambios de marca, nombres de temporada, corregir una errata.
`/setdescription`	Define el texto que aparece en la pantalla vacía del chat bajo "¿Qué puede hacer este bot?", hasta 512 caracteres.	Contarle a la gente qué hace el bot antes de que presione Iniciar.
`/setabouttext`	Define la biografía corta que aparece en el perfil del bot y en las vistas previas de enlaces, hasta 120 caracteres.	Una descripción de una línea que aparece cuando se comparte tu bot.
`/setuserpic`	Sube la foto de perfil del bot. Envía una imagen cuadrada para un recorte limpio.	Cualquier bot que los usuarios vean en una lista de chats.
`/setcommands`	Define la lista de comandos que los usuarios ven en el menú "/". Envías una línea por comando con el formato `comando - descripción`.	Después de decidir a qué comandos responde tu bot.
`/setjoingroups`	Activa o desactiva si las personas pueden agregar tu bot a grupos.	Desactívalo para un bot de soporte estrictamente uno a uno.
`/setprivacy`	Modo de privacidad en grupos. Activado (el valor predeterminado) significa que el bot solo recibe comandos, respuestas a sus propios mensajes, mensajes que mencionan su nombre de usuario y mensajes de servicio. Desactivado significa que recibe todos los mensajes del grupo.	Bots de grupo que deben reaccionar a palabras clave sueltas. Vuelve a agregar el bot a los grupos existentes para que el cambio surta efecto.
`/setinline`	Activa el modo en línea, para que los usuarios puedan escribir @tubot seguido de una consulta dentro de cualquier chat.	Bots tipo buscador. Déjalo desactivado si no admites consultas en línea.
`/deletebot`	Elimina un bot de forma permanente después de que confirmes con la frase exacta que BotFather te pide.	Retirar un bot definitivamente. No se puede deshacer.

BotFather tiene algunos comandos más que puedes ignorar sin problema al principio, incluidos los comandos de juegos (/newgame, /mygames, /listgames, /editgame, /deletegame), los comandos de ajuste del modo en línea (/setinlinegeo, /setinlinefeedback) y /setdomain, que vincula un dominio web para el Telegram Login Widget.

¿Qué es el token de un bot de Telegram y cómo lo obtienes de nuevo?

El token del bot es la única credencial que permite que un software actúe como tu bot, y puedes volver a verlo en cualquier momento con /token o desde /mybots y luego Token de API. Se ve así:

110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

Los dígitos antes de los dos puntos son el ID numérico del bot, que es público. La cadena después de los dos puntos es el secreto. Toda llamada a la Bot API de Telegram es simplemente una solicitud a https://api.telegram.org/bot<token>/methodName, así que quien tenga la cadena completa puede llamar a cualquier método en nombre de tu bot.

Un token solo puede ser usado por un sistema en ejecución a la vez. Telegram permite una única URL de webhook por bot, y hacer polling de actualizaciones mientras hay un webhook configurado devuelve un error 409 Conflict. Si mueves un bot de una plataforma a otra, desconecta la anterior en lugar de dejar ambas funcionando.

¿Qué pasa si el token de tu bot se filtra y cómo lo revocas?

Trata el token como una contraseña: cualquiera que lo tenga controla el bot por completo, y la solución es /revoke. No existe un acceso parcial ni un modo de solo lectura.

Con un token robado, un atacante puede:

Leer todos los mensajes que los usuarios envíen a tu bot desde ese momento, incluido cualquier dato escrito en tus formularios
Enviar, editar y eliminar mensajes como tu bot a cualquiera que ya lo haya iniciado
Apuntar el webhook a su propio servidor, para que tu tráfico llegue silenciosamente a ellos en lugar de a ti
Cambiar el menú de comandos, la descripción y el comportamiento en línea mediante la Bot API

También vale la pena saber lo que no pueden hacer. El token no da acceso a tu cuenta personal de Telegram, no puede eliminar el bot (eso requiere tu cuenta dentro de BotFather), no puede enviar mensajes a personas que nunca iniciaron tu bot, y la Bot API no tiene ningún método para descargar una lista de tus usuarios, así que tu lista de suscriptores no se puede exportar simplemente.

Para rotar un token:

Envía /revoke a BotFather
Selecciona el bot afectado en el teclado que muestra
BotFather anula el token anterior al instante y responde con el nuevo
Pega el nuevo token en todos los lugares donde estaba el anterior, ya que el bot queda fuera de línea hasta que lo hagas

La prevención se reduce sobre todo a un hábito: nunca pongas el token en un lugar público. No lo subas a GitHub, no lo pegues en un chat grupal ni en un ticket de soporte, y recórtalo de las capturas de pantalla. Los repositorios públicos se escanean continuamente en busca del patrón de dígitos, dos puntos y letras, y los tokens filtrados suelen ser explotados en minutos. Más reglas de higiene como esta están reunidas en nuestro artículo de mejores prácticas para bots de Telegram.

¿Cómo cambias el nombre, la descripción, el texto "Acerca de" o la foto de un bot?

Usa /setname, /setdescription, /setabouttext y /setuserpic, o abre /mybots, elige el bot y selecciona Editar bot para hacer las cuatro cosas desde un menú. Cada comando primero te pregunta qué bot quieres editar, y luego te pide el nuevo valor.

Los dos campos de texto son fáciles de confundir. La descripción tiene hasta 512 caracteres y aparece en la pantalla vacía del chat, encima del botón Iniciar, así que es lo último que lee un usuario antes de decidir si usa tu bot. El texto "Acerca de" tiene hasta 120 caracteres y aparece en la página de perfil del bot y en las vistas previas de enlaces cuando alguien lo comparte.

Los cambios se aplican de inmediato, y ninguno de ellos afecta el token ni el nombre de usuario. Si ya tienes usuarios activos, cambiar el nombre es seguro: su chat sigue funcionando.

¿Cómo configuras el menú de comandos que ven los usuarios?

Envía /setcommands, elige tu bot y luego manda la lista completa en un solo mensaje, con un comando por línea en el formato comando - descripción, sin la barra inicial. Por ejemplo:

start - Inicia el bot y abre el menú principal
menu - Consulta el menú actual y los precios
book - Reserva una mesa
hours - Horario de atención y dirección
help - Cómo usar este bot

Las reglas de Telegram para esa lista: los nombres de comando usan letras latinas minúsculas, dígitos y guiones bajos, tienen de 1 a 32 caracteres, y cada descripción tiene de 1 a 256 caracteres. Un bot puede tener hasta 100 comandos en el menú. Una vez guardada, la lista aparece cuando un usuario escribe "/" y también detrás del botón Menú junto al campo de mensajes.

Hay algo que casi a todos les sorprende: registrar un comando en BotFather solo lo hace visible. No hace que funcione. Si agregas /hours al menú pero nada del lado receptor maneja /hours, los usuarios lo tocan y no obtienen respuesta, lo cual se ve peor que no listarlo en absoluto.

¿Qué es lo que BotFather no hace?

BotFather registra el bot, configura su perfil y te entrega un token, y ese es todo su trabajo. No le da ningún comportamiento a tu bot, por eso un bot recién creado nunca responde nada, sin importar cuánto esperes.

Cada mensaje que un usuario le envía a tu bot se convierte en una actualización del lado de Telegram. Algo tiene que recibir esas actualizaciones, ya sea por webhook o por polling, decidir cuál debe ser la respuesta, y llamar a la Bot API para enviarla. Tienes dos opciones realistas para ese algo:

Escribirlo y alojarlo tú mismo. Un script en Python o Node, un servidor o una función serverless para ejecutarlo, un endpoint HTTPS para el webhook, además de monitoreo y redespliegues para siempre.
Usar un creador sin código. Pegas el token en la plataforma, construyes comandos y respuestas en un editor visual, y la plataforma se encarga de recibir las actualizaciones y enviar las respuestas.

TeleMinute es del segundo tipo. Pegas el token de BotFather en app.teleminute.com y obtienes bots de Telegram ilimitados, comandos y respuestas por palabra clave ilimitados, botones y menús en línea, formularios de captación con seguimiento de respuestas dentro de la app, notificaciones push cuando llega una nueva respuesta de formulario, difusiones a todos los usuarios de tu bot con programación y segmentación, estadísticas detalladas e informes de entrega, y hasta 4 imágenes por comando. Los bots funcionan mediante webhooks de Telegram, así que están en línea 24/7 sin necesidad de rentar ni mantener despierto un servidor. Hay un bot de prueba gratuito de 15 minutos sin necesidad de tarjeta, y si quieres comparar las opciones primero, revisa nuestro resumen de los mejores creadores de bots de Telegram.

Qué cuesta	Precio	Qué incluye
BotFather y la Bot API de Telegram	Gratis	Registro del bot, token, configuración de perfil. Sin cargo por mensaje.
Bot de prueba de TeleMinute	Gratis, sin tarjeta	Un bot de prueba de 15 minutos para probar el creador de principio a fin.
TeleMinute Premium, semanal	$3.99 por semana	Todas las funciones. No hay niveles.
TeleMinute Premium, mensual	$9.99 por mes	Todas las funciones. La opción más popular.
TeleMinute Premium, de por vida	$49.99 pago único	Todas las funciones, se paga una vez, acceso de por vida.

Sin importar qué camino elijas, hay dos reglas de Telegram que aplican a todos los bots y que ninguna plataforma puede eliminar. Un bot solo puede enviar mensajes a personas que lo hayan iniciado primero, así que no hay contacto en frío, y el envío masivo tiene un límite de aproximadamente 30 mensajes por segundo, así que una difusión a una audiencia grande se pone en cola y tarda en completarse.

¿Cómo se elimina un bot de Telegram?

Envía /deletebot a BotFather, elige el bot y confirma enviando de vuelta la frase exacta que BotFather te muestra (actualmente "Yes, I am totally sure."). Puedes hacer lo mismo desde /mybots y luego Eliminar bot.

La eliminación es permanente. El token deja de funcionar, el bot desaparece de tu cuenta, y BotFather te advierte que no se puede deshacer. No lo trates como un botón de pausa.

Si solo quieres que el bot deje de responder por un tiempo, revoca el token con /revoke o desconéctalo en la plataforma que lo esté ejecutando. Ambas acciones toman segundos y ambas son reversibles.

Ya tienes el token. Ahora dale al bot algo que decir.

Pega tu token de BotFather en TeleMinute y crea comandos, respuestas por palabra clave, menús en línea y formularios de captación de forma visual. Empieza con un bot de prueba gratuito de 15 minutos, sin necesidad de tarjeta.

Conecta el token de tu bot

Puntos clave

BotFather es el bot oficial de Telegram para crear bots, en @BotFather, y es gratuito, sin cargo por mensaje.
Crea un bot con /newbot: un nombre visible, luego un nombre de usuario de 5 a 32 caracteres que debe terminar en "bot", y después el token.
El token es una contraseña. /token vuelve a mostrarlo, /revoke lo reemplaza al instante si se filtra.
BotFather puede cambiar el nombre, la descripción, el texto "Acerca de", la foto, el menú de comandos y la configuración de grupo de un bot, pero no su nombre de usuario.
BotFather nunca hace que un bot responda. Eso lo hace tu propio código alojado o un creador como TeleMinute ($3.99 por semana, $9.99 por mes, o $49.99 pago único).

Conclusión

BotFather es deliberadamente sencillo. Es un mostrador de registro: emite una identidad y un token, te deja pulir el perfil, y no se interpone en el camino. Aprende la docena de comandos de arriba y nunca más tendrás que buscarlos.

El trabajo interesante empieza después del token. Decide qué debe responder tu bot, conecta el token a algo que pueda responder, y prueba las primeras cinco preguntas que harán tus usuarios reales. Esa es la diferencia entre un bot registrado y uno útil.