Soporte de X Bot: solución de problemas, preguntas frecuentes y guía de contacto

La mayoría de los problemas se solucionan solos con una sola acción de /setup. La primera mitad de esta página te guía por el flujo de autodiagnóstico; la segunda mitad son preguntas frecuentes. Si ninguna lo resuelve, el formulario de contacto al final enruta directamente al canal de soporte de desarrollo de BWS.

Primero — flujo de autodiagnóstico

Open /setup → ℹ️ About in your chat.
└─ Copy that text. It's everything support needs to triage.

Then ask yourself, in order:

  1. Does the bot reply to /setup at all?
     ├─ No  → bot was kicked or demoted from admin → re-promote and retry
     └─ Yes → continue.

  2. Did /setup → 📊 Reports → ⚡ Generate report now produce something
     within 3 minutes?
     ├─ No DM, no post → check next question.
     ├─ DM "no posts found"  → filter too narrow or no on-topic posts;
                                /setup → 🎯 Filters to see
                                the literal X API query.
     ├─ DM "credit exhausted" → /setup → 💳 Buy Credits → 💰 Buy.
     ├─ Post landed but image looks wrong → re-fire; if persistent,
                                contact support with the chat ID.
     └─ Post landed correctly → you're fine.

  3. Are scheduled reports arriving?
     ├─ No  → /setup top screen shows the cron. Compare to actual UTC time.
              The bot's first scheduled fire happens AFTER the next cron tick,
              not immediately after setup.
     └─ Yes → all good.

Si nada de eso te lleva a una solución, desplázate más allá de las preguntas frecuentes hasta el enlace de contacto.

Preguntas frecuentes

Configuración e instalación

P. El bot no responde cuando lo añado. Confirma que está promovido a administrador, no solo "miembro". Telegram → configuración del grupo → Administradores. La repromoción es instantánea; el bot no necesita reinstalarse.

P. ¿Puedo mover el bot a un grupo diferente? Sí — añádelo al grupo nuevo, ejecuta /setup ahí. Los dos chats son independientes (diferentes ID de chat = diferente configuración, calendarios, puntuaciones). No hay migración de datos entre chats.

P. El bot reporta en el hilo principal, pero mi grupo tiene temas — ¿puedo redirigir? Desde dentro del tema de foro deseado, envía:

/set_topic Reports

Los futuros reportes se enrutan a ese tema. Restablece con /set_topic clear.

P. ¿Cómo desinstalo?

Detén los reportes primero: /setup → ⏰ Calendario → ✕ Desactivar calendario.
Elimina el bot: Telegram → grupo → administradores → expulsa a @BWS_X_Bot.
La configuración permanece en la base de datos. Volver a añadir el bot al mismo ID de chat reanuda todo. Pide a soporte una eliminación completa.

Reportes y filtrado

P. ¿Por qué mis números son diferentes de los rastreadores de terceros? X Bot extrae directamente de la API oficial de X. La mayoría de los rastreadores de terceros hacen scraping o extrapolan — hemos medido discrepancias del 20–50%. El número de la API de X es la fuente de verdad.

P. El leaderboard muestra usuarios que no esperaba rastrear. Los filtros son aditivos. Si un chat rastrea el cashtag $YOUR_TOKEN, cualquiera que twittee ese cashtag queda clasificado, no solo las cuentas que listaste. Para requerir tanto una cuenta como un cashtag, usa la forma from:@x cashtags:$YOUR_TOKEN vía /set_x_filtering (la semántica AND-de-todo de los filtros nombrados).

P. El reporte dice "0 publicaciones" — ¿ahora qué? Tres posibilidades, en orden de probabilidad:

Filtro demasiado estrecho — /setup → 🎯 Filtros muestra la consulta literal de la API de X. Error tipográfico común: $BTC (espacio al final) vs $BTC.
Período demasiado estrecho — si configuraste un período personalizado, las publicaciones fuera de esa ventana no cuentan. /setup → 📊 Reportes → 🗑 Borrar período revierte a la ventana móvil de 24 h.
Las cuentas que rastreas realmente no publicaron nada en tema en 24 h — extiende con cashtags o palabras clave para señal de respaldo.

P. ¿Puedo rastrear una cuenta de X privada/protegida? No — la API de X solo devuelve publicaciones públicas.

P. ¿Puedo excluir usuarios específicos del leaderboard de un chat (p. ej. bots de spam)? Sí: /setup → 🎯 Filtros → 🙈 Ignorar → ➕ Añadir. Las cuentas listadas se eliminan de los resultados después de la obtención.

P. ¿Por qué mi chat tiene múltiples disparos de reporte al día? O configuraste un cron de disparo múltiple (cron(0 14,22 ? * * *)) o tienes múltiples filtros nombrados ejecutándose con el mismo calendario. Cada filtro nombrado produce su propio reporte.

P. La selección de "Mejor Tweet" parece rara. El selector de IA elige la publicación de mayor engagement que no haya sido elegida recientemente. Si los resultados se sienten consistentemente equivocados, contacta a soporte — el prompt es ajustable.

Retransmisión automática de publicaciones de X

P. La retransmisión reenvió un hilo de 6 publicaciones a la vez. Solo quería la primera. Eso es porque exclude=replies de la API de X solo filtra respuestas a otros usuarios; las auto-respuestas (continuaciones de hilo) lo eluden. /setup → 📡 Retransmisión automática de X → @cuenta → desactiva ☐ Continuaciones de hilo. El bot entonces mantiene solo la cabeza de cada hilo.

P. La retransmisión dejó de reenviar a mitad del día. Revisa la pantalla por retransmisión — si Today: 10/10 forwarded, alcanzaste el límite diario. Toca ✏️ Límite para aumentarlo. El límite se reinicia a medianoche UTC.

P. La retransmisión muestra ⏸ Pausada pero nunca la pausé. El bot se pausa automáticamente en errores de chat desaparecido de Telegram (expulsado / bloqueado / chat actualizado) y detiene el calendario de sondeo. /setup → 📡 Retransmisión automática de X muestra la fila por si vuelves a añadir el bot.

Facturación y créditos

P. ¿Qué es exactamente un "crédito"? Un crédito = una publicación devuelta por la API de X. Los chats FREE obtienen 100 créditos gratis/mes; los chats PRO se facturan vía Stripe (suscripción) o ETH (paquete de créditos).

P. ¿Dónde veo mi saldo de créditos?/setup → 💳 Comprar créditos. Muestra usado / restante / fecha de reinicio.

P. Acabo de pagar pero mi saldo / plan no se actualizó.

Ruta Stripe (suscripción con tarjeta): el webhook usualmente activa PRO en segundos. Si después de 5+ minutos no ves PRO ✓ en /setup → 💳 Comprar créditos, contacta a soporte con tu recibo de Stripe e ID de chat.
Ruta ETH (paquete de créditos): la confirmación en cadena puede tardar 1–3 minutos. Si después de 10 minutos los créditos no aparecen, contacta a soporte con el hash de la transacción y el ID de chat.

P. ¿Puedo tener tanto una suscripción de Stripe COMO créditos ETH en el mismo chat? Sí — se combinan. Un chat PRO·créditos que se suscribe mantiene su saldo ETH existente, y la facturación por obtención consume primero los créditos ETH antes de que la asignación mensual de la suscripción entre en acción. Efecto práctico: si tienes 5000 créditos ETH y te suscribes, las primeras 5000 obtenciones no tocan Stripe en absoluto; las obtenciones siguientes usan la asignación de 1000/mes de la suscripción; cualquier cosa más allá se mide a $0.02/publicación de excedente. El saldo ETH nunca expira.

La única restricción: un chat que ya está en PRO·sub no puede añadir un paquete ETH nuevo desde el mismo flujo de compra hoy (el comando de compra lo bloquea). Cancela la suscripción primero si quieres volver a facturación solo de créditos.

P. ¿Qué pasa cuando mi saldo de PRO·créditos llega a cero? La licencia se degrada automáticamente a FREE. El bot sigue obteniendo bajo el límite FREE de 100/mes hasta que también se agote. El próximo /setup → 💳 → 💰 Comprar entonces ofrece ambas rutas de nuevo.

P. ¿El saldo de créditos es por chat o por usuario? Por chat. Cada grupo de Telegram tiene sus propios créditos y licencia.

Panel público

P. Mi proyecto no aparece en xbot.ninja. Se deben cumplir tres umbrales en el mes en curso:

Puntuación del usuario principal ≥ 300
Publicaciones rastreadas ≥ 5
Usuarios activos ≥ 2

El primer mes suele ser el cuello de botella. La URL directa https://xbot.ninja/?chatId=<tu-id> funciona independientemente.

P. ¿Cómo encuentro mi ID de chat?/setup → ℹ️ Acerca de. El entero largo con prefijo negativo.

P. ¿Puedo personalizar la tarjeta pública de xbot.ninja?/setup → 🎨 Personalización. Configura Nombre, Descripción, Logo, URLs. La tarjeta se actualiza en el próximo ciclo de reporte.

Peculiaridades de la API de X

P. ¿Por qué se cuentan algunas publicaciones más antiguas de lo esperado? El bot usa tweets/search/all (endpoint de archivo completo). Cuando configuras un período, el bot puede obtener publicaciones de cualquier momento dentro de él. El predeterminado es una ventana móvil de 24 h, pero un período personalizado puede tener fecha retroactiva.

P. A veces una publicación tarda 5+ minutos en aparecer en una retransmisión. La retransmisión automática de X sondea cada 5 minutos. La latencia es de hasta un intervalo de sondeo (~2.5 min en promedio / ~5 min en el peor caso). Más una breve latencia de la API de X + entrega de Telegram.

P. La API de X devolvió un error — ¿qué ve el operador? Los contadores internos de error aumentan; los administradores designados reciben un DM privado (/setup → 👥 Administradores para configurar quién). Códigos 4xx comunes: 401/403 (credenciales del lado del operador), 402 (créditos agotados), 429 (limitado por tasa — el bot reintenta con retroceso).

Qué incluir en una solicitud de soporte

Copia y pega esta plantilla:

Project: <your project name>
Chat ID: <from /setup → ℹ️ About>
Plan: FREE / PRO·credits / PRO·sub
What's wrong: <1–2 sentences>
What you tried: </setup → … → … steps you ran>
When it broke: <approx UTC time>
Recent change: <any new filter / schedule / payment in the last 24 h>

El ID de chat por sí solo le da a soporte el 80% de la información de triage — por favor inclúyelo siempre.

Tiempos de respuesta esperados

Crítico: bot fuera de línea en toda la plataforma, fallos de facturación → respuesta dentro de 1 hora hábil durante el solapamiento de horario laboral UE+EE. UU.
Alto: reporte no se entrega para un solo chat → el mismo día hábil
Normal: preguntas sobre funciones, ayuda de configuración → 1–2 días hábiles

Enlaces útiles

Bot de Telegram: @BWS_X_Bot
Panel público: xbot.ninja
Documentación: /docs/
Issues de GitHub: blockchain-web-services/bws-api-telegram-xbot
Soporte directo: bws.ninja — el formulario de contacto enruta al soporte de desarrollo de BWS

Antes de contactar a soporte, recorre el flujo de autodiagnóstico de Solución de problemas — la mayoría de los problemas se resuelven en las dos primeras verificaciones.

Soporte de X Bot: solución de problemas, preguntas frecuentes y guía de contacto ​

Primero — flujo de autodiagnóstico ​

Preguntas frecuentes ​

Configuración e instalación ​

Reportes y filtrado ​

Retransmisión automática de publicaciones de X ​

Facturación y créditos ​

Panel público ​

Peculiaridades de la API de X ​

Qué incluir en una solicitud de soporte ​

Tiempos de respuesta esperados ​

Enlaces útiles ​