Docs / Monitor / Configuración

Monitor de Canales — Setup

Guía paso a paso para activar Monitor de Canales en tu bot OmniGest.

Paso 1 — Prepara una cuenta Telegram secundaria

No uses tu cuenta personal. Si Telegram marca el comportamiento de scraping, solo la cuenta secundaria se ve afectada.

Recomendaciones: - eSIM o número virtual barato (~5€/año). - No entres con este número en tus grupos personales de Telegram. - Trátalo como una credencial de servicio.

Paso 2 — Obtén api_id y api_hash

  1. Entra en https://my.telegram.org con el número secundario.
  2. Click en API development tools.
  3. Crea una nueva aplicación (cualquier nombre, platform: "Other").
  4. Copia api_id (número) y api_hash (cadena hex de 32 caracteres).

Paso 3 — Genera la session string

Ejecuta el generador localmente en tu portátil (nunca en un servidor):

pip install telethon
python scripts/generate_monitor_session.py

El wizard pide: - api_id - api_hash - Número de teléfono de la cuenta secundaria - Código SMS (llega a ese teléfono) - Contraseña 2FA (si la tienes)

Imprime un SESSION_STRING — un token base64 largo. Guárdalo bien; trátalo como una contraseña.

Paso 4 — Registra la sesión en OmniGest

DM a @OmniGest_bot desde tu cuenta principal (no la secundaria):

/monitor_setup

Sigue el wizard de 3 pasos: 1. Envía api_id 2. Envía api_hash 3. Envía SESSION_STRING

El bot hace un smoke test contra Telegram para verificar que la sesión funciona, y la guarda cifrada (Fernet) en la BD. Verás:

✅ Sesión activa para +** *** ** **XXXX

Paso 5 — Añade canales fuente

/monitor_sources add @chollometro

El bot responde con tres botones: 🛒 Solo AliExpress / 📦 Solo Amazon / 🔀 Ambos. Elige uno:

  • Solo AliExpress — ignora posts con solo URLs de Amazon.
  • Solo Amazon — ignora posts con solo URLs de AliExpress.
  • Ambos (por defecto) — publica cualquier URL convertible.

Repite para cada canal que quieras vigilar (máx 3 en tier Free).

Lista las fuentes actuales:

/monitor_sources list

Elimina una fuente:

/monitor_sources del @chollometro

Paso 6 — Configura destinos

OmniGest debe ser miembro de cada chat destino.

/monitor_dest 1

El bot te pide reenviar un mensaje del canal/grupo que quieras usar como Slot 1. Abre ese chat, elige cualquier mensaje, pulsa Reenviar → envíalo a @OmniGest_bot.

Opcional: configura Slot 2:

/monitor_dest 2

Comprueba los destinos actuales:

/monitor_dest

Paso 7 — Espera al primer scrape

El scraper corre una vez por hora. En menos de 60 minutos desde el Paso 6, recibirás el primer DM con preview de cualquier chollo nuevo publicado en tus fuentes.

Cada preview tiene 4 botones: [📢 Slot 1] [📢 Slot 2] [✏️ Editar] [🗑 Ignorar]. Pulsa para publicar o descartar.

Qué esperar

  • Latencia: hasta 60 minutos desde la publicación hasta el DM.
  • Volumen: depende de los canales fuente (un canal de chollos activo = 10-20 DMs/día).
  • Publicación: solo cuando pulsas un botón. OmniGest nunca publica automáticamente.