Instalación

Configura X Bot en tu grupo de Telegram en tres pasos. La mayoría de los equipos completan la instalación en menos de tres minutos; el asistente hace el trabajo pesado.

Camino más rápido — @BWS_X_Bot → añadir al grupo → /setup → 🚀 Inicio rápido. Las cuatro indicaciones que siguen son todo lo que necesitas.

Reúne estos 5 elementos antes de empezar

Antes de empezar, ten esto listo:

Para un recorrido pantalla por pantalla de cada opción que configurarás abajo, consulta El menú /setup.

Necesitas	De dónde viene
Una cuenta de Telegram	telegram.org
Derechos de administrador en un grupo de Telegram	Crea uno si no lo tienes: Telegram → Nuevo grupo
Las cuentas de X, cashtags o palabras clave que quieres rastrear	P. ej. @your_username, $YOUR_TOKEN, "#YourCampaign"
(Opcional) Logo del proyecto + lista de URLs	Para la vitrina pública de xbot.ninja
(Opcional) Preferencia de zona horaria	El calendario está en UTC; elige una hora UTC que coincida con el momento de mayor actividad de tu comunidad

¿No estás seguro de qué plan necesitarás? Consulta Precios — la mayoría de los equipos comienzan en el nivel FREE (100 publicaciones/mes) y actualizan después.

Si no estás seguro de qué escenario aplica para ti, echa un vistazo a los 4 casos de uso en el Resumen — elige el más cercano y usa su recomendación de filtro en el paso 2 a continuación.

Paso 1 — Añade el bot a tu grupo

1. Abre Telegram y busca @BWS_X_Bot.
2. Añade el bot a tu grupo.
3. Promuévelo a administrador. No se requieren permisos especiales más allá del administrador predeterminado (el bot necesita estatus de administrador únicamente para que Telegram le permita leer mensajes del grupo y publicar reportes).

Grupo, no DM

Las funciones de análisis del bot solo funcionan en grupos, no en DM privados. Si inicias un DM con @BWS_X_Bot verás que /help y /buy funcionan, pero la mayor parte del menú de configuración no.

Paso 2 — Ejecuta /setup

En tu grupo, escribe:

/setup

El bot responde con un menú interactivo. Toca 🚀 Inicio rápido para abrir el asistente de cuatro pasos.

El asistente hace cuatro preguntas en orden:

Paso	Indicación	Ejemplos
1	Nombre del proyecto	MyToken, KOL Campaign Q2, @your_username Performance
2	Qué rastrear en X	📢 Cuentas + usuarios, 💵 Cashtags + tickers, o 🔍 Palabras clave + frases
3	Cuándo debe ejecutarse el bot	Elige un preset diario (09:00 / 14:00 / 18:00 / 22:00 UTC) o envía una hora personalizada
4	Listo	Resumen de lo que se guardó

Omitir y Salir siempre están disponibles — un asistente parcialmente completado nunca te bloquea, la configuración simplemente se queda en sus valores predeterminados.

¿Por qué /setup? Envuelve cada comando de administrador en una interfaz clicable y editable en el lugar, para que no tengas que memorizar comandos. La configuración se guarda al instante. Los usuarios avanzados aún pueden escribir comandos slash directamente — las dos superficies son equivalentes y el comportamiento es idéntico. Recorrido completo: El menú /setup.

Paso 3 — Verifica

Cuando el asistente termina, abre /setup → 📊 Reportes → ⚡ Generar reporte ahora para enviar un reporte inmediato (el próximo reporte programado se ejecutará a la hora que elegiste en el paso 2).

El bot publica la imagen del leaderboard en el grupo en ~1–3 minutos. Los chats más pequeños (un puñado de cuentas, bajo volumen de publicaciones) terminan más rápido; los chats comunitarios con cientos de publicaciones por obtener pueden tardar 2–3 minutos.

Espera la primera ejecución programada

Después del Generar reporte ahora manual, la próxima ejecución automática ocurre a tu hora cron configurada. Obtendrás un reporte por disparo — sin publicaciones duplicadas.

Costo y créditos

X Bot usa la API oficial de X para toda la obtención de datos. Cada chat comienza en FREE; desde ahí puedes agregar una o ambas rutas de pago:

Plan	Lo que pagas	Lo que cubre
FREE	$0	100 publicaciones/mes de un límite fijo. El bot pausa las obtenciones a las 100; se reinicia el día 1 del próximo mes.
Suscripción PRO (Stripe)	$19/mes + $0.02/publicación por encima de 1000/mes (medido por Stripe)	Se renueva automáticamente. Las primeras 1000 publicaciones/mes están incluidas como umbral gratuito (no un saldo de créditos — no hay acumulación).
Créditos PRO (ETH)	$0.02/crédito, paquetes de 1000 / 2000 / 3000 / 4000 / 5000 / 10 000 / 50 000 / 100 000	Compra única. Los créditos nunca expiran. Recarga un saldo existente.

Un chat puede tener tanto PRO·sub como PRO·créditos al mismo tiempo — la facturación por obtención consume primero los créditos ETH, luego la asignación mensual de la suscripción, luego el excedente medido. Consulta precios para la matriz completa de transición de planes y el flujo de compra.

Plan + saldo siempre visibles en /setup → 💳 Comprar créditos. Los administradores designados reciben un DM de Telegram cuando los créditos llegan al 80% y de nuevo cuando se agotan por completo.

Próximos pasos recomendados por caso de uso

Elige la fila que coincida con tu escenario, luego sigue la sección del Resumen vinculada para la receta completa:

Escenario	Qué añadir después del asistente	Detalle
Agencia de KOL rastreando 5 KOL	Refinamiento de cashtag + hashtag de campaña, calendario 22:00 UTC	Caso de uso 1
Proyecto involucrando a la comunidad	Logo + URLs en 🎨 Personalización para la tarjeta pública de xbot.ninja	Caso de uso 2
Portafolio de KOL independiente	Foto personal + URL de LinkedIn en Personalización, comparte la URL de xbot.ninja con prospectos	Caso de uso 3
Agencia multi-cliente	/setup → 🎯 Filtros → ⤴ Filtros nombrados → ➕ Añadir filtro nombrado — uno por cliente	Caso de uso 4
Recibir publicaciones de cuentas X en tiempo real	/setup → 📡 Retransmisión automática de X → ➕ Añadir cuenta	El menú /setup

Qué se configura

Sección en /setup	Qué configuras	Por qué importa
🎯 Filtros	Cuentas, cashtags, palabras clave, menciones a rastrear en X	Define qué publicaciones obtiene el bot
⏰ Calendario	Hora del día para el reporte automatizado	El bot ejecuta la obtención + renderizado en este cron
📊 Reportes y período	Ventana de fechas opcional (p. ej. período de una competencia)	Restringe el reporte a un tramo específico
🎨 Personalización	Nombre del proyecto, descripción, logo, URLs, pesos y colores del leaderboard	Marca para la imagen del reporte y la vitrina pública de xbot.ninja
👥 Administradores	Quién recibe DM privados sobre problemas de créditos / obtención	Visibilidad operativa
💳 Suscripción	Plan, saldo de créditos, punto de entrada de actualización	Visibilidad de costos y pago
📡 Retransmisión automática	Cuentas de X para reenviar al chat en tiempo real (cada 5 min)	Actualizaciones en vivo entre reportes programados

Vitrina pública (opcional)

Si tu proyecto cumple los umbrales de inclusión pública (≥ 300 puntuación máxima, ≥ 5 publicaciones, ≥ 2 usuarios activos en el mes en curso), aparece en xbot.ninja. Añade los metadatos del proyecto en /setup → 🎨 Personalización (Nombre, Descripción, Logo, URLs).

Las configuraciones de KOL independiente (una sola cuenta) no pasan la regla de "≥ 2 usuarios activos" y permanecen accesibles solo en su URL directa — eso es intencional.

Verificar la instalación

La mayoría de los diagnósticos son visibles directamente en /setup (cada pantalla muestra el estado actual del chat en la parte superior). Lista de verificación rápida:

Verificación	Cómo
El bot es administrador	Telegram → configuración del grupo → Administradores
El rastreo está configurado	/setup → 🎯 Filtros → ver cuentas/cashtags/palabras clave listadas
El filtro se renderiza correctamente	/setup → 🎯 Filtros
El calendario está configurado	/setup (la parte superior del menú muestra el calendario actual)
Créditos disponibles	/setup → 💳 Comprar créditos
El reporte manual funciona	/setup → 📊 Reportes → ⚡ Generar reporte ahora

El primer reporte no apareció — solución de problemas

Si Generar reporte ahora no produce una publicación en 3 minutos:

Síntoma	Causa probable	Solución
El DM del bot dice "no se encontraron publicaciones"	Filtro demasiado estrecho O no hay publicaciones recientes que coincidan	/setup → 🎯 Filtros — revisa la consulta literal de la API de X en busca de errores tipográficos. Intenta ampliar (elimina el período de fechas si está configurado).
El DM del bot dice "crédito agotado"	El chat FREE alcanzó el límite de 100/mes	Espera al próximo mes, o /setup → 💳 Comprar créditos → 💰 Comprar para suscribirte o comprar un paquete de créditos
No pasa nada, sin DM	El bot no es administrador, O el webhook se detuvo	Vuelve a promover el bot a administrador. Si aún no pasa nada, contacta a soporte.
La imagen se renderiza pero el texto está vacío	El comentario de IA agotó el tiempo	Vuelve a ejecutar; es transitorio. Si persiste, contacta a soporte — el proveedor de IA a veces tiene interrupciones rotativas
Error "Unauthorized" / "Forbidden"	Problema con el token de la API de X (del lado del operador)	Contacta a soporte; nada que el usuario pueda arreglar

Diagnóstico autoservicio

/setup → ℹ️ Acerca de muestra el ID de tu chat, plan y calendario en una sola pantalla. Copia ese texto en cualquier solicitud de soporte — acorta la clasificación en ~80%.

Preguntas frecuentes sobre la instalación

P. ¿Puedo instalar el bot en un canal de Telegram (no un grupo)? No, solo grupos y supergrupos. Los canales no permiten contexto de respuesta a mensajes, que usa el flujo de reportes.

P. ¿Puedo ejecutar el bot en un grupo de estilo foro con temas? Sí. Usa /set_topic desde dentro del tema en el que quieras que se publiquen los reportes. El bot publica en ese tema en adelante; si no está configurado, publica en el hilo principal.

P. ¿El bot necesita acceso de lectura a los mensajes de mi grupo? El bot solo necesita recibir mensajes de comando (p. ej. /setup). No lee el chat normal. Los datos del lado de X provienen de la API oficial de X, no de tus mensajes de Telegram.

P. ¿Puedo rastrear una cuenta de X privada/protegida? No — la API de X solo devuelve publicaciones públicas. Rastrear una cuenta protegida devuelve resultados vacíos silenciosamente.

P. ¿Eliminar el bot del grupo borra mis datos? No. La configuración, el historial, las puntuaciones y los reportes permanecen en la base de datos del bot. Si vuelves a añadir el bot al mismo ID de chat, todo se reanuda. Si quieres un desmontaje limpio, pídeselo a soporte.

P. ¿Puedo cambiar el nombre del proyecto más tarde? Sí — /setup → 🎨 Personalización → 🏷 Nombre. Actualiza el próximo reporte y el slug de la URL pública de xbot.ninja.

P. ¿Por qué veo conteos de publicaciones diferentes que [herramienta X]? X Bot extrae directamente de la API oficial de X. La mayoría de los rastreadores de terceros hacen scraping o extrapolan. Hemos encontrado discrepancias del 20–50% en la práctica. El número de la API de X es la fuente de verdad.

P. ¿Cómo cancelo?

• Chats FREE: simplemente elimina el bot del grupo.
• Suscripción PRO: /setup → 💳 Comprar créditos → 🛠 Gestionar suscripción abre el Portal de Clientes de Stripe donde puedes cancelar. La cancelación entra en vigor al final del período pagado actual.
• Créditos PRO (ETH): los créditos no se renuevan automáticamente — el chat baja a FREE por sí solo cuando el saldo llega a cero. Elimina el bot en cualquier momento.

¿Necesitas ayuda?

Consulta Soporte, o abre /setup → ℹ️ Acerca de en tu chat para obtener información de diagnóstico para compartir con el equipo.

Lee el resumen de X Bot para el desglose completo de lo que cada audiencia — proyectos cripto, agencias de KOL, KOL independientes, inversores — obtiene del bot antes de comenzar la configuración.