Comandos do bot no grupo de WhatsApp
Referência completa dos comandos do Torneyo no grupo: /vou, /lista, /sortear, /placar, /gol, /ranking, /pix, /novo e os demais, com quem pode usar cada um.
Depois de conectar o grupo pelo código, o Torneyo responde a comandos digitados no grupo. Um comando é qualquer mensagem que começa com / ou !, em qualquer caixa (/VOU, !vou, /nãovou). O bot também aceita a menção na frente (@Torneyo /vou), o sufixo /vou@bot e pontuação no fim (/vou!). Texto que não começa com / ou ! é ignorado.
Quem é quem para o bot
O bot identifica cada pessoa pelo telefone do cadastro na turma, nunca pelo nome nem pelo texto da mensagem.
| Papel | Quem é | O que pode |
|---|---|---|
| Participante | Qualquer pessoa no grupo, cadastrada ou não | /proxima, /ajuda, /cadastro, /vincular |
| Atleta vinculado | Telefone bate com uma matrícula ativa da turma | Tudo acima, mais presença, lista, times, rankings, /pix e /devo |
| Organizador | Gestor da organização no Torneyo (proprietário, administrador ou gestor, pelo telefone do usuário) ou admin do grupo do WhatsApp | Tudo acima, mais os comandos de gestão |
Quem não está cadastrado recebe, uma vez por hora, o link público do encontro para responder pelo nome. Se o mesmo telefone estiver em mais de um cadastro (pai com dois filhos, por exemplo), o bot pede para usar o link.
Por padrão, o admin do grupo do WhatsApp pode os comandos operacionais (/sortear, /fechar, /abrir, /novo, /cor, /convidado), mas /placar e /gol, que alimentam rankings, exigem gestor da organização. O administrador da plataforma pode liberar o modo permissivo.
Presença
| Comando | Quem | O que faz |
|---|---|---|
/vou | atleta | Confirma presença no próximo jogo. Respeita vagas, lista de espera, suspensão em vigor e aceite pendente do regulamento. Sem argumento, mantém a posição atual; na primeira confirmação, quem está cadastrado como goleiro assume a vaga de goleiro. |
/vou goleiro | atleta | Pede a vaga de goleiro (/vou linha pede a de linha). |
/vou churrasco, /vou jogo, /vou tudo | atleta | Escolhe o evento quando há mais de um no dia. Só /vou com dois eventos abertos devolve um menu numerado; responda 1, 2 ou 3 em até 2 minutos. |
/naovou (/nao vou, /nao) | atleta | Marca que não vai, mesmo suspenso. Se havia lista de espera, o primeiro da fila sobe e o grupo é avisado. |
/lista (/list) | atleta | Confirmados numerados com a hora, goleiros, lista de espera, vagas restantes, pendentes, quem não vai e o link. /lista churrasco detalha um evento. Repetida em menos de 60 s é ignorada. |
/meus (/status) | atleta | A sua situação em cada evento do dia. |
/proxima (/proximo, /next) | qualquer um | Data, hora, local, prazo de confirmação (ou “confirmações fechadas”) e link do encontro. |
/ajuda (/help, /comandos, /ayuda) | qualquer um | Lista os comandos; o organizador vê também os de gestão. |
/vou com um texto que o bot não entende (por exemplo /vou não posso) não confirma: o bot pergunta se você quis dizer /naovou.
Cadastro
| Comando | Quem | O que faz |
|---|---|---|
/cadastro Nome Sobrenome (/registro, /register) | qualquer um | Pede o próprio cadastro na turma. Vira uma solicitação em Cadastros pendentes para o gestor aprovar. Só letras no nome; o telefone vem do WhatsApp. |
/cadastrar | organizador | Responde no grupo com a quantidade de cadastros pendentes e o link do painel. Se outra pessoa mandar /cadastrar Nome, vale como /cadastro. |
/vincular CODIGO | quem tem o código | Vincula o grupo à turma. É o único comando aceito em grupo ainda não vinculado. |
Jogo e pós-jogo
| Comando | Quem | O que faz |
|---|---|---|
/sortear [n] | organizador | Sorteia de 2 a 6 times (padrão 2) com os confirmados do jogo da vez, balanceados pelas notas dos colegas e pela frequência. Mesmos confirmados = mesmo sorteio. Só em turmas do tipo pelada ou turma avulsa. |
/times (/teams) | atleta | Reposta o último sorteio e o placar, se já lançado. |
/cor <time> <cor> | organizador | Cor da camisa de um time (/cor 1 azul, /cor time2 sem colete). Sem argumentos, lista as cores. Paleta: branco, preto, azul, vermelho, verde, amarelo, laranja, colete, sem colete, ou um nome livre. |
/fechar [apelido] | organizador | Trava as confirmações do jogo da vez (ou do evento com apelido). Vale para o grupo e para o link. Com a lista fechada a espera não promove ninguém. |
/abrir [apelido] | organizador | Destrava as confirmações e reavalia a fila. Se o prazo original já passou, o bot avisa. |
/convidado Nome | organizador | Adiciona ao jogo alguém sem cadastro, só pelo nome. Entra se houver vaga; senão, na espera. Fica fora de ranking e cobrança. |
/placar 3x2 | gestor da organização | Grava o placar no sorteio de referência (um número por time, na ordem dos times). Placar diferente já gravado só é trocado com /placar 3x2 confirmar. |
/gol Fulano [assist Ciclano] | gestor da organização | Lança gol e, opcionalmente, assistência no dia do sorteio de referência. Com nomes repetidos, o bot pergunta “Qual João? 1) … 2) …” e você responde com o número em até 2 minutos. |
/craque (/mvp) | atleta | Link da votação do craque do último jogo (aberta do início até 48 h depois). |
O jogo da vez para /sortear, /fechar e /abrir é o de hoje que começou há menos de 4 horas (ou que ainda vai começar); na falta, o próximo. O sorteio de referência para /times, /placar e /gol é o mais recente até hoje (janela de 3 dias); sem nenhum, o futuro mais próximo.
Abrir uma lista pelo grupo
| Comando | Quem | O que faz |
|---|---|---|
/novo [dia] [hora] [apelido] | organizador | Abre a lista de um jogo (/novo sexta 20h, /novo 12/10 19h30) ou de um evento extra (/novo churrasco sábado 14h). Sem dia nem hora, abre o próximo horário da grade. Sinônimos: /novalista, /novoencontro, /abrirlista, /encontro, /nova. Só datas futuras, até 60 dias à frente; no máximo 2 jogos e 3 eventos extras por dia. |
Rankings e dinheiro
| Comando | Quem | O que faz |
|---|---|---|
/ranking [tipo] [mes|ano|tudo] | atleta | Top 5 de um ranking da turma: presenca, palavra, artilharia, assistencia, vitorias, aproveitamento, craque, parceria, evolucao. Sem tipo, presença do mês. |
/artilharia [ano|tudo] | atleta | Top 5 de gols do mês. |
/devo (/owe) | atleta | No privado: o que você deve na turma (itens, atraso, total). No grupo sai só “te enviei no privado”. |
/pix | atleta | No privado: o Pix copia e cola do que você deve, com a chave da turma. Sem chave configurada, orienta a falar com o organizador. |
Limites e privacidade
- Cada pessoa pode mandar até 6 comandos por minuto; o grupo recebe no máximo 40 respostas por minuto. Acima disso o bot fica em silêncio.
- Comandos com mais de 3 minutos de atraso (WhatsApp sem sinal, por exemplo) são ignorados para não confirmar fora de hora.
/vincularcom código errado 5 vezes bloqueia aquele remetente por 15 minutos.- O bot nunca publica telefone, valor devido ou motivo de suspensão no grupo. O texto de um comando não é guardado, mesmo com a leitura de mensagens ligada.
- As respostas saem no idioma da organização (português, inglês ou espanhol).
Perguntas frequentes
Mandei /vou e o bot respondeu com um link. Seu telefone não está no cadastro da turma, ou está em mais de um cadastro. Peça ao gestor para conferir em Participantes do grupo, ou confirme pelo link mesmo.
O bot parou de responder. Veja o estado da conexão na tela Encontros. Se o grupo estiver pausado (“Pausar postagens”) ou desvinculado, o bot fica mudo. A turma continua funcionando pelo link.
Pausar as postagens também silencia os comandos? Sim. Pausar desliga tudo que o Torneyo faz naquele grupo.