Docs / Monitor / Resolución de problemas

Monitor de Canales — Resolución de problemas

Issues comunes y cómo arreglarlos.

"🚨 Tu sesión de monitor ha sido revocada"

Tu cuenta de Telegram ha terminado la sesión de Telethon (manualmente, por inactividad, o Telegram la invalidó).

Fix: 1. Regenera la session string localmente: python scripts/generate_monitor_session.py 2. DM al bot: /monitor_setup 3. Pega los 3 valores (api_id, api_hash, nueva SESSION_STRING).

"⏳ Flood wait de Xh en tu sesión"

Telegram aplicó un rate limit a tu cuenta de scraping. OmniGest pausa las lecturas automáticamente hasta que expire.

Fix: no hagas nada. Se reanuda solo.

Si lo ves repetidamente: - Reduce el número de fuentes activas (/monitor_sources del @X). - Espera unos días y reintenta. - Considera usar otra cuenta secundaria.

"⚠ Backlog saturado en @canal"

El canal fuente publicó ≥100 mensajes desde el último scrape. OmniGest avanzó last_seen_msg_id al último procesado; algunos del medio pueden haberse saltado.

Fix: es normal en fuentes muy activas. Si es persistente y te pierdes chollos, el intervalo de 1h de OmniGest es el cuello de botella — el tier premium soportará intervalos configurables.

"❌ No soy miembro de {canal}. Añádeme primero y reintenta."

Reenviaste un mensaje de un chat donde OmniGest no es miembro. Los destinos requieren que el bot esté presente.

Fix: 1. Añade @OmniGest_bot como miembro (o admin, según el tipo de chat) en el destino. 2. Reintenta /monitor_dest 1 y reenvía otra vez.

"❌ No es un reenvío válido desde un canal o grupo"

El mensaje que reenviaste no tiene metadatos de origen (configuración de privacidad de Telegram oculta el forward origin).

Fix: el chat origen tiene "Ocultar reenviado-desde" activado. Elige otro destino, o pide al dueño del chat que permita la visibilidad del forward-from.

"🚫 No tienes acceso al Monitor de Canales"

Tu user id de Telegram no está en el allowlist. En tier Free, Monitor de Canales está limitado a un usuario específico.

Fix: contacta con el admin de OmniGest para que añada tu id, o verifica que estás DMando al bot desde la cuenta correcta.

No llegan DMs aunque el canal fuente publique

Checklist:

  1. ¿Flag activo? Confirma MONITOR_ENABLED=true en el .env de bot-referidos.
  2. ¿Sesión activa? DM /monitor_sources list — si el bot responde, los handlers están registrados.
  3. ¿bot-monitor healthy? En el servidor: docker logs bot-monitor --tail 20 Busca errores de Telethon.
  4. ¿Poller corriendo? docker logs bot-referidos --tail 20 | grep poll_once Debe aparecer cada 3 segundos.
  5. ¿Candidatos en BD? sql SELECT status, COUNT(*) FROM monitor_candidates WHERE owner_id=TU_ID GROUP BY status; Si hay filas en error, revisa error_reason.

Si hay candidatos pero el DM nunca llega: la URL en el post puede no ser convertible (no es un enlace de AliExpress/Amazon), o tu filtro de marketplace lo excluye.

El mensaje publicado tiene tag erróneo / enlace roto

La conversión de URL de afiliado puede haber fallado. Verifica:

  1. Credenciales de /afiliado aún válidas (tu tag de AliExpress o Amazon no expirado).
  2. Pulsa un enlace recién publicado para verificar que redirige a la página de producto correcta con tu tag en los parámetros de la URL.

Si el enlace está roto, el error_reason del candidato lo explica. Los errores transitorios se reintentan automáticamente (máx 3 veces).

El primer scrape no ocurre

El primer scrape corre 1 hora después de que arranca bot-monitor. Si acabas de desplegar la feature y esperaste menos, estás bien — revisa más tarde.

Para forzar un scrape inmediato (solo admin, acceso VPS):

docker exec bot-monitor python -c "
import asyncio; from bot.monitor.runner import scrape_all_owners
asyncio.run(scrape_all_owners())
"

Sigue bloqueado

Contacta con soporte con: - Tu user id de Telegram. - El comando o acción exacta que falla. - El mensaje de error que ves (si hay).