Conectar el grupo de WhatsApp con el código

Torneyo entra al grupo de WhatsApp del equipo como un participante más. Con el grupo conectado, publica la convocatoria de cada encuentro, responde a los comandos, le recuerda a quien no respondió y registra a quien está en el grupo. El equipo no depende del grupo de WhatsApp para funcionar: sin él, todo sigue por el enlace de asistencia.

El asistente Primeros pasos

Justo después de crear el grupo (o con el botón Configurar en 4 pasos en la tarjeta del grupo), el asistente guía la configuración. Ninguna etapa es obligatoria; todas tienen “ahora no” o “saltar”, y el progreso queda guardado para retomarlo después.

Etapa	Qué pasa
1. Grupo	”¿La gente ya tiene un grupo en WhatsApp?” Sí lleva a la conexión; “todavía no” muestra el enlace de invitación y el botón Invitar por WhatsApp, con la opción Creé el grupo, quiero conectarlo para volver después.
2. Conectar	”¿Quieres que Torneyo entre al grupo?” con los beneficios y los tres pasos de la conexión por código (abajo).
3. Personas	Lee la lista del grupo, muestra solo a quienes son nuevos (nombre editable, teléfono enmascarado) y registra en lote. Sin grupo, ofrece el enlace de invitación y el registro manual.
4. Listo	Resumen (grupo, personas, encuentros automáticos y anticipación de la convocatoria), la chuleta de comandos para pegar en el grupo y accesos directos a Encuentros, Asistencia y el grupo.

El mismo asistente existe en la aplicación (en fase final de pruebas antes de las tiendas), con las mismas etapas.

Conectar con el código

1. Agrega el número de Torneyo al grupo. El número aparece en la pantalla del asistente (y en Encuentros, en el bloque del grupo).
2. Genera el código de vinculación. Torneyo muestra un código con el formato PELADA-7K4Q2M una sola vez. Vale por 30 minutos, sirve una vez y generar otro invalida el anterior.
3. Envía en el grupo: /vincular PELADA-7K4Q2M.

El bot responde en el grupo (“¡Grupo vinculado al equipo X! Las invitaciones y los comandos ya funcionan aquí. Envía /ayuda para ver los comandos.”) y la pantalla avanza sola. Quien envía el comando no necesita estar registrado: tener el código es la prueba de que el grupo es tuyo.

Nota Un grupo solo puede estar conectado a un equipo a la vez. Si el código se envía en un grupo que ya pertenece a otro equipo, el bot responde “código inválido o vencido” y nada cambia. Si el equipo ya tenía otro grupo, el nuevo reemplaza al anterior: el grupo anterior recibe un aviso de desvinculación y sus mensajes y métricas se borran.

Un código equivocado cinco veces bloquea a ese remitente por 15 minutos. Un código inválido, vencido o ya usado recibe siempre la misma respuesta genérica.

Elegir el grupo por nombre en una lista es una función reservada al administrador de la plataforma; el organizador usa el código.

El mensaje de presentación

Apenas el grupo queda vinculado, Torneyo publica una única vez un mensaje de presentación: quién es, qué hace en el grupo y que, para desactivarlo, basta hablar con el organizador. Ese mensaje es requisito para la lectura de mensajes (opcional) y se vuelve a publicar si cambias de grupo.

Estado de la conexión

En la pantalla Encuentros, la insignia del grupo muestra:

Estado	Significado
Conectado	El número de Torneyo está en el grupo y la sesión está activa.
Desconectado	El número salió del grupo o la sesión se cayó. Los organizadores del grupo reciben una notificación (en la app y push) cuando eso pasa en dos verificaciones seguidas, cada 10 minutos.
No disponible	La integración está desactivada en este entorno o el servicio está fuera de línea. La pantalla lo explica y el grupo sigue por el enlace.

Botones útiles en el mismo bloque: Mensaje de prueba (espera 30 s entre pruebas), Avisar presencia (vuelve a publicar la presentación) y Pausar publicaciones, que silencia todo lo que Torneyo hace en ese grupo, incluidos los comandos, hasta que lo reanudes.

Configuración del grupo

• Horas de anticipación: cuántas horas antes del encuentro se publica la convocatoria.
• Leer mensajes del grupo (opt-in, desactivado por defecto): guarda primer nombre y texto por 30 días, con datos personales enmascarados, para el reporte del día y las métricas de participación. Solo se activa si el mensaje de presentación ya fue publicado.
• Mensajes programados: mensajes únicos o semanales en el grupo, con las variables {{data}}, {{horario}}, {{local}}, {{link_presenca}} y {{turma}}. Un mensaje programado no puede empezar con / ni !.

Desvincular o cambiar de grupo

Para cambiar, genera un código nuevo y envía /vincular en el grupo nuevo. Para desvincular definitivamente, usa la opción correspondiente en Encuentros o el alcance Desvincular el grupo en Reiniciar datos del grupo. En ambos casos, lo que deriva del grupo anterior (mensajes, métricas, participantes monitoreados) se borra.

Preguntas frecuentes

¿Necesito un número propio? No. El número es de Torneyo. Solo lo agregas al grupo.

¿El organizador tiene que estar en el grupo? Para enviar /vincular, sí (o pídele a alguien del grupo que envíe el código). Para los comandos de gestión, el bot reconoce al gestor de la organización por el teléfono del usuario o al admin del grupo de WhatsApp.

¿El bot lee las conversaciones? Solo si activas “Leer mensajes del grupo”. Los comandos nunca se guardan como texto.