Comandos del bot en el grupo de WhatsApp

Después de conectar el grupo con el código, Torneyo responde a los comandos escritos en el grupo. Un comando es cualquier mensaje que empieza con / o !, en mayúsculas o minúsculas (/VOU, !vou, /nãovou). El bot también acepta la mención adelante (@Torneyo /vou), el sufijo /vou@bot y puntuación al final (/vou!). El texto que no empieza con / o ! se ignora.

Quién es quién para el bot

El bot identifica a cada persona por el teléfono del registro en el grupo, nunca por el nombre ni por el texto del mensaje.

Rol	Quién es	Qué puede hacer
Participante	Cualquier persona en el grupo, registrada o no	/proxima, /ajuda, /cadastro, /vincular
Atleta vinculado	Su teléfono coincide con una matrícula activa del grupo	Todo lo anterior, más asistencia, lista, equipos, rankings, /pix y /devo
Organizador	Gestor de la organización en Torneyo (propietario, administrador o gestor, por el teléfono del usuario) o admin del grupo de WhatsApp	Todo lo anterior, más los comandos de gestión

Quien no está registrado recibe, una vez por hora, el enlace público del encuentro para responder por su nombre. Si el mismo teléfono está en más de un registro (un padre con dos hijos, por ejemplo), el bot pide usar el enlace.

Por defecto, el admin del grupo de WhatsApp puede usar los comandos operativos (/sortear, /fechar, /abrir, /novo, /cor, /convidado), pero /placar y /gol, que alimentan rankings, exigen ser gestor de la organización. El administrador de la plataforma puede habilitar el modo permisivo.

Asistencia

Comando	Quién	Qué hace
/vou	atleta	Confirma asistencia al próximo partido. Respeta cupos, lista de espera, suspensión vigente y aceptación pendiente del reglamento. Sin argumento, mantiene la posición actual; en la primera confirmación, quien está registrado como arquero toma el cupo de arquero.
/vou goleiro	atleta	Pide el cupo de arquero (/vou linha pide el de jugador de campo).
/vou churrasco, /vou jogo, /vou tudo	atleta	Elige el evento cuando hay más de uno en el día. Solo /vou con dos eventos abiertos devuelve un menú numerado; responde 1, 2 o 3 en hasta 2 minutos.
/naovou (/nao vou, /nao)	atleta	Marca que no va, incluso suspendido. Si había lista de espera, el primero de la fila sube y se avisa al grupo.
/lista (/list)	atleta	Confirmados numerados con la hora, arqueros, lista de espera, cupos restantes, pendientes, quién no va y el enlace. /lista churrasco detalla un evento. Repetida en menos de 60 s se ignora.
/meus (/status)	atleta	Tu situación en cada evento del día.
/proxima (/proximo, /next, /siguiente)	cualquiera	Fecha, hora, lugar, plazo de confirmación (o “confirmaciones cerradas”) y enlace del encuentro.
/ajuda (/help, /comandos, /ayuda)	cualquiera	Lista los comandos; el organizador ve también los de gestión.

/vou con un texto que el bot no entiende (por ejemplo /vou no puedo) no confirma: el bot pregunta si quisiste decir /naovou.

Registro

Comando	Quién	Qué hace
/cadastro Nombre Apellido (/registro, /register)	cualquiera	Pide tu propio registro en el grupo. Se convierte en una solicitud en Registros pendientes para que el organizador apruebe. Solo letras en el nombre; el teléfono viene de WhatsApp.
/cadastrar	organizador	Responde en el grupo con la cantidad de registros pendientes y el enlace del panel. Si otra persona manda /cadastrar Nombre, vale como /cadastro.
/vincular CODIGO	quien tiene el código	Vincula el grupo al equipo. Es el único comando aceptado en un grupo todavía no vinculado.

Partido y pospartido

Comando	Quién	Qué hace
/sortear [n]	organizador	Sortea de 2 a 6 equipos (por defecto 2) con los confirmados del partido del día, equilibrados por las notas de los compañeros y la asistencia. Mismos confirmados = mismo sorteo. Solo en grupos del tipo partido entre amigos o clase suelta.
/times (/teams)	atleta	Vuelve a publicar el último sorteo y el marcador, si ya se cargó.
/cor <equipo> <color>	organizador	Color de camiseta de un equipo (/cor 1 azul, /cor time2 sem colete). Sin argumentos, lista los colores. Paleta: blanco, negro, azul, rojo, verde, amarillo, naranja, chaleco, sin chaleco, o un nombre libre.
/fechar [apodo]	organizador	Bloquea las confirmaciones del partido del día (o del evento con apodo). Vale para el grupo y para el enlace. Con la lista cerrada, la espera no sube a nadie.
/abrir [apodo]	organizador	Desbloquea las confirmaciones y reevalúa la fila. Si el plazo original ya pasó, el bot avisa.
/convidado Nombre	organizador	Agrega al partido a alguien sin registro, solo por el nombre. Entra si hay cupo; si no, a la espera. Queda fuera de rankings y cobros.
/placar 3x2	gestor de la organización	Guarda el marcador en el sorteo de referencia (un número por equipo, en el orden de los equipos). Un marcador distinto ya guardado solo se cambia con /placar 3x2 confirmar.
/gol Fulano [assist Mengano]	gestor de la organización	Carga gol y, opcionalmente, asistencia en el día del sorteo de referencia. Con nombres repetidos, el bot pregunta “¿Cuál João? 1) … 2) …” y respondes con el número en hasta 2 minutos.
/craque (/mvp)	atleta	Enlace de la votación del crack del último partido (abierta desde el inicio hasta 48 h después).

El partido del día para /sortear, /fechar y /abrir es el de hoy que empezó hace menos de 4 horas (o que todavía va a empezar); si no hay, el próximo. El sorteo de referencia para /times, /placar y /gol es el más reciente hasta hoy (ventana de 3 días); si no hay ninguno, el futuro más cercano.

Abrir una lista desde el grupo

Comando	Quién	Qué hace
/novo [día] [hora] [apodo] (/nuevo)	organizador	Abre la lista de un partido (/novo sexta 20h, /novo 12/10 19h30) o de un evento extra (/novo churrasco sábado 14h). Sin día ni hora, abre el próximo horario de la grilla. Sinónimos: /novalista, /novoencontro, /abrirlista, /encontro, /nova. Solo fechas futuras, hasta 60 días adelante; como máximo 2 partidos y 3 eventos extra por día.

Rankings y dinero

Comando	Quién	Qué hace
/ranking [tipo] [mes|ano|tudo]	atleta	Top 5 de un ranking del grupo: presenca, palavra, artilharia, assistencia, vitorias, aproveitamento, craque, parceria, evolucao. Sin tipo, asistencia del mes.
/artilharia [ano|tudo]	atleta	Top 5 de goles del mes.
/devo (/owe)	atleta	En privado: lo que debes en el grupo (ítems, atraso, total). En el grupo sale solo “te lo envié en privado”.
/pix	atleta	En privado: el Pix copia y pega de lo que debes, con la clave del grupo. Sin clave configurada, orienta a hablar con el organizador.

Límites y privacidad

• Cada persona puede mandar hasta 6 comandos por minuto; el grupo recibe como máximo 40 respuestas por minuto. Por encima de eso, el bot se queda en silencio.
• Los comandos con más de 3 minutos de atraso (WhatsApp sin señal, por ejemplo) se ignoran para no confirmar fuera de hora.
• /vincular con código equivocado 5 veces bloquea a ese remitente por 15 minutos.
• El bot nunca publica teléfono, importe adeudado ni motivo de suspensión en el grupo. El texto de un comando no se guarda, ni siquiera con la lectura de mensajes activada.
• Las respuestas salen en el idioma de la organización (portugués, inglés o español).

Preguntas frecuentes

Mandé /vou y el bot respondió con un enlace. Tu teléfono no está en el registro del grupo, o está en más de un registro. Pídele al organizador que lo revise en Participantes del grupo, o confirma directamente por el enlace.

El bot dejó de responder. Mira el estado de la conexión en la pantalla Encuentros. Si el grupo está pausado (“Pausar publicaciones”) o desvinculado, el bot queda mudo. El grupo sigue funcionando por el enlace.

¿Pausar las publicaciones también silencia los comandos? Sí. Pausar desactiva todo lo que Torneyo hace en ese grupo.