Configurador inicial (Setup Wizard)
OmniGest te lleva de la mano la primera vez que lo añades a un grupo o canal. En lugar de explorar /config a ciegas, el bot te invita a un asistente paso a paso por DM que deja el grupo listo en 2-3 minutos.
Cómo se dispara
Tras añadir el bot a un grupo, supergrupo o canal, OmniGest detecta el evento y manda un mensaje único al chat con dos botones:
- ⚙️ Configurar bot — abre conversación privada con el bot (
/start setup_<chat_id>) y arranca el wizard. - ℹ️ Más tarde — guarda que has pospuesto la configuración. No volverá a invitarte aunque vuelvas a añadir el bot al mismo grupo más tarde.
En canales, donde un botón sería confuso (los posts los ven todos los suscriptores), el mensaje es plano y el admin puede arrancar el wizard manualmente con /setup por DM.
Los dos modos: Rápido y Completo
Tras pulsar el botón el wizard te ofrece elegir el camino:
| Modo | Pasos | Para quién |
|---|---|---|
| Rápido | 5 | Quieres dejar el grupo funcional en 2 minutos. Cubre lo esencial. |
| Completo | 7 | Quieres revisar todas las protecciones antes de aceptar defaults. |
Pasos del modo Rápido
- Idioma — Español o English
- Bienvenida — usar mensaje por defecto o escribir el tuyo
- Captcha — exigir verificación a los nuevos miembros (recomendado en grupos públicos)
- AliExpress — usar enlaces de afiliado del bot, conectar tus credenciales propias, o saltar
- Cupones — cadencia con la que quieres recibir broadcasts: diario / cada 2 días / semanal / quincenal / no recibir
Pasos extra del modo Completo
- Pack de seguridad — activar AntiSpam + AntiFlood + WordFilter de una vez
- Moderación IA — análisis automático con OpenAI Moderation (NSFW, scam, CSAM)
Modo Canal
Los canales tienen un wizard reducido a 3 pasos: idioma, cadencia de cupones y Daily Tip. Las protecciones de grupo (captcha, antispam, etc.) no aplican porque solo el admin publica.
Reanudar un wizard a medias
Si cierras el DM o pulsas ⏸️ Pausar en cualquier paso, OmniGest guarda el estado:
- Al volver a escribir
/starto/configpor DM, el bot detecta wizards pendientes y te ofrece ▶️ Reanudar o 🗑️ Descartar. - El estado persiste hasta que termines, descartes o pase un mes (purga automática prevista para volúmenes altos).
Saltar pasos individuales
Cada paso tiene tres acciones:
- Pulsar una opción — aplica la decisión y avanza al siguiente
- ⏭️ Saltar — marca el paso como
~saltadoy avanza sin tocar la configuración - ⬅️ Atrás — vuelve al paso anterior
Los saltos se registran (~lang, ~captcha, etc.) por si más adelante quieres ver qué decidió cada admin durante el setup.
Una sola invitación por grupo
Para no spamear, OmniGest marca setup_invite_resolved_at en cuanto:
- Completas el wizard, o
- Pulsas ℹ️ Más tarde en la invitación, o
- Saltas todos los pasos.
A partir de ahí, aunque te expulsen del grupo y vuelvan a añadirte, no se manda otra invitación. Si quieres re-configurar, escribe /setup por DM.
Kill-switch para owners
El owner del bot puede desactivar el auto-trigger globalmente:
SETUP_WIZARD_ENABLED=false
Con la variable a false:
- Los grupos nuevos NO reciben la invitación con botón.
- /setup por DM responde con un short-circuit silencioso.
- Wizards en curso siguen funcionando hasta que terminen o cierren.
Útil para apagones de emergencia o despliegues donde quieres validar el resto del bot antes de exponer el wizard.
Por qué este feature importa
El primer minuto en cualquier grupo nuevo es donde se pierde el admin. Si tiene que descubrir 20 comandos para entender qué hace el bot, lo más probable es que cierre Telegram y se olvide. El configurador inicial reduce ese onboarding a "pulsa este botón" → DM guiado → grupo listo. Es la diferencia entre un bot que se prueba y un bot que se usa.