Por qué rediseñamos /setup: de 50 comandos a un solo menú

Si añadiste X Bot a un grupo de Telegram hace tiempo, quizás recuerdes un bot muy diferente. Existían /set_x_filtering, /set_calendar, /set_top_count, /set_colors, /set_points, /set_topic, y unos 45 comandos más como esos. Cada función tenía su propio comando slash, porque parecía la forma natural de exponer un conjunto de funciones cada vez mayor en Telegram. No lo era.

Este artículo trata sobre por qué eliminamos esa estructura y la sustituimos por un único menú /setup, qué nos decían los números antes y después, y qué mantuvimos para quienes preferían la forma anterior.

El problema: 50 comandos no son una lista de funciones, son un laberinto#

El autocompletado de comandos de Telegram muestra una lista desplazable en cuanto escribes /. Eso funciona bien con cinco o seis comandos. Con más de 50, deja de ser un menú y se convierte en un muro de texto que nadie lee de arriba a abajo. Los nuevos administradores —la persona en el grupo de Telegram de un proyecto cripto a la que acaban de decirle “oye, configura el bot de seguimiento”— escribía /setup, veía un muro de comandos desconocidos y, o adivinaba mal, o se rendía.

Lo escuchábamos constantemente en los tickets de soporte, antes de tener un flujo real de ❓ Ayuda y soporte para captarlo: “cómo añado los cashtags”, “dónde configuro el horario”, “este bot siquiera hace informes”. Las respuestas siempre eran un comando que no habían encontrado, enterrado en una lista que no tenían tiempo de leer. El bot tenía toda la funcionalidad que la gente quería. Simplemente no indicaba dónde estaba nada.

Los comandos slash tampoco se combinan bien entre sí. Si querías configurar filtros, un horario y personalización, eran tres (o más) invocaciones de comandos independientes, cada una exigiendo recordar la sintaxis exacta —/set_x_filtering @handle1 @handle2 $TOKEN, con el formato justo, sin errores tipográficos, sin reintento tolerante. Un argumento mal formado y recibías un error escueto y tenías que empezar de nuevo. No había un camino guiado desde “acabo de añadir este bot” hasta “tengo un informe funcionando”.

La solución: un solo punto de entrada, todo detectable#

Redujimos la superficie de comandos a un único comando /setup que abre un teclado en línea —los menús de botones pulsables que Telegram soporta de forma nativa. En lugar de memorizar 50 nombres de comandos, ves 8 secciones etiquetadas y tocas la que quieres:

• 🎯 Filters — cuentas, cashtags, palabras clave, menciones, exclusiones, lista de ignorados, filtros con nombre
• ⏰ Schedule — preajustes diarios, hora personalizada, días específicos, o una expresión cron completa
• 📊 Reports — dispara un informe bajo demanda, revisa el historial de informes
• 🎨 Customization — nombre del proyecto, descripción, logo, URLs, título y color del leaderboard, ponderaciones, número de top-N
• 👥 Admins — quién más puede configurar el bot
• 💳 Buy Credits — packs de créditos ETH o la suscripción PRO
• 📡 X Posts Auto-relay — reenvía posts de cuentas seleccionadas al chat casi en tiempo real
• ❓ Help & Support — abre un ticket, recibe respuestas como mensajes directos de Telegram

Cada botón lleva a otro menú, no a una sintaxis que tengas que recordar. Configurar cashtags antes significaba recordar /set_x_filtering y acertar con el orden de los argumentos. Ahora es /setup → 🎯 Filters → 💵 Cashtags → ➕ Add, y el bot te pide lo que necesita a continuación.

La experiencia de primer uso es lo que más cambió. Los chats nuevos ahora reciben un asistente de inicio rápido de 4 pasos: nombre del proyecto, luego filtros, luego horario, y luego una pantalla de confirmación —listo en menos de un minuto, sin sintaxis de comandos que puedas equivocar.

Lo que realmente cambió: los números de activación#

Medimos qué porcentaje de chats nuevos disparaba su primer informe dentro de las 24 horas siguientes a añadir el bot —la señal más clara de “esta persona realmente completó la configuración, o se fue”. Antes del rediseño del menú, una gran parte de las instalaciones nuevas nunca completaba la configuración; los administradores probaban un par de comandos slash, se topaban con un error por un argumento mal formado, y desaparecían. Después del rediseño, la mayoría de los chats nuevos que iniciaban el asistente de inicio rápido lo terminaban y tenían un informe programado ese mismo día. El mayor logro del asistente no fue enseñar funciones nuevas: fue eliminar la posibilidad de escribir algo mal.

Los tickets de soporte sobre “cómo configuro X” también cayeron drásticamente en cuanto se lanzó el menú, sustituidos por preguntas más específicas sobre ajustes finos (cómo funciona el selector del mejor tweet, por ejemplo) en lugar de “dónde está el botón para esto”.

Lo que mantuvimos como comandos directos#

No eliminamos todo. Un puñado de comandos son lo bastante frecuentes, o útiles como atajo rápido, como para mantenerlos fuera del menú:

• /setup — abre el menú (el propio punto de entrada)
• /report — dispara un informe de inmediato, sin navegar por el menú
• /buy — va directo a comprar créditos
• /subscription — revisa o gestiona la suscripción PRO
• /add_admin — añade un administrador del bot sin entrar en 👥 Admins
• /set_topic — establece el tema objetivo en grupos con modo foro
• /status — comprobación rápida de estado (filtros activos, horario, plan)
• /get_chatid — necesario ocasionalmente para tickets de soporte y depuración de la API

Estos son los comandos que los usuarios avanzados escriben de memoria, y los que scripts o automatizaciones tienen más probabilidad de llamar directamente. Mantenerlos significó no romper el flujo de trabajo de nadie mientras arreglábamos la detectabilidad para todos los demás. Los otros más de 40 comandos heredados técnicamente siguen resolviéndose por compatibilidad hacia atrás, pero ya no están documentados ni sugeridos en ningún sitio —el menú es ahora el camino soportado.

¿Valió la pena el coste de la migración?#

Sí, pero no fue gratis. Cada pantalla del menú tenía que manejar el caso de un usuario que toca un botón, cierra Telegram y vuelve tres días después esperando el mismo estado —los teclados en línea no retienen el contexto de la conversación indefinidamente, así que tuvimos que hacer que cada paso fuera reingresable en lugar de asumir un flujo lineal. También tuvimos que pensar más en los permisos: un menú invita a hacer más clics que un comando que alguien tuvo que buscar y escribir, así que 👥 Admins y las comprobaciones de roles se reforzaron al mismo tiempo.

Si estás construyendo un bot de Telegram con más de un puñado de opciones de configuración, nuestra opinión es: no esperes a tener 50 comandos para tomar esta decisión. El umbral en el que una lista de comandos deja de ser útil es más bajo de lo que parece cuando eres tú quien añade funciones una a una. Si tus usuarios están configurando cosas que no hacen a diario —sintaxis de horarios, combinaciones de filtros, filtros con nombre—, un menú guiado siempre gana a un comando memorizado. Si es un comando que alguien va a ejecutar decenas de veces al día, mantenlo como un comando directo y rápido.

Para una mirada más profunda a cómo funciona en la práctica el lado de filtrado de /setup, consulta seguimiento de la actividad en X para el lanzamiento de un token y seguimiento de cashtags para proyectos cripto —ambos recorren paso a paso el menú actual de 🎯 Filters. Para la referencia completa del menú, la documentación del menú de setup cubre cada pantalla, y x-bot-overview es el mejor punto de partida si eres completamente nuevo en el bot.

¿Listo para seguir a tu comunidad en X? Añade @BWS_X_Bot a tu grupo de Telegram, ejecuta /setup, y tu primer informe se dispara según el horario configurado. El plan FREE cubre 100 posts/mes —sin tarjeta requerida.

Sobre este artículo: este post fue redactado con asistencia de IA usando el flujo de contenido de X Bot y revisado por Nacho Coll, Founder & Principal en Blockchain Web Services (BWS), antes de su publicación. Cada afirmación sobre el producto se verifica contra el bot en vivo. Lee cómo usamos la IA en nuestro contenido. ¿Detectaste un error? Contáctanos vía /setup → ❓ Help & Support.

“Esta es una de las muchas actualizaciones de producto que cubrimos —consulta el blog de X Bot para notas de versión, casos de estudio y análisis en profundidad.”