Conectar o grupo de WhatsApp pelo código

O Torneyo entra no grupo de WhatsApp da turma como mais um participante. Com o grupo conectado, ele posta o convite de cada encontro, responde aos comandos, lembra quem não respondeu e cadastra quem está no grupo. A turma não depende do grupo para funcionar: sem ele, tudo segue pelo link de presença.

O assistente Primeiros passos

Logo depois de criar a turma (ou pelo botão Configurar em 4 passos no cartão da turma), o assistente conduz a configuração. Nenhuma etapa é obrigatória; todas têm “agora não” ou “pular”, e o progresso fica guardado para retomar depois.

Etapa	O que acontece
1. Grupo	”A galera já tem um grupo no WhatsApp?” Sim leva à conexão; “ainda não” mostra o link de convite e o botão Chamar no WhatsApp, com a opção Criei o grupo, quero conectar para voltar depois.
2. Conectar	”Quer que o Torneyo entre no grupo?” com os benefícios e os três passos da conexão por código (abaixo).
3. Pessoas	Lê a lista do grupo, mostra só quem é novo (nome editável, telefone mascarado) e cadastra em lote. Sem grupo, oferece o link de convite e o cadastro manual.
4. Pronto	Resumo (grupo, pessoas, encontros automáticos e antecedência do convite), a cola dos comandos para colar no grupo e atalhos para Encontros, Chamada e a turma.

O mesmo assistente existe no aplicativo (em fase final de testes antes das lojas), com as mesmas etapas.

Conectar pelo código

1. Adicione o número do Torneyo ao grupo. O número aparece na tela do assistente (e em Encontros, no bloco do grupo).
2. Gere o código de vínculo. O Torneyo mostra um código no formato PELADA-7K4Q2M uma única vez. Ele vale por 30 minutos, serve uma vez e gerar outro invalida o anterior.
3. Envie no grupo: /vincular PELADA-7K4Q2M.

O bot responde no grupo (“Grupo vinculado à turma X! Envie /ajuda para ver os comandos”) e a tela avança sozinha. Quem envia o comando não precisa estar cadastrado: ter o código é a prova de que o grupo é seu.

Nota Um grupo só pode estar ligado a uma turma por vez. Se o código for enviado num grupo que já pertence a outra turma, o bot responde “código inválido ou expirado” e nada muda. Se a turma já tinha outro grupo, o novo substitui o antigo: o grupo anterior recebe um aviso de desvinculação e as mensagens e métricas dele são apagadas.

Código errado cinco vezes bloqueia aquele remetente por 15 minutos. Código inválido, expirado ou já usado recebe sempre a mesma resposta genérica.

Escolher o grupo por nome numa lista é uma função reservada ao administrador da plataforma; o gestor usa o código.

A mensagem de apresentação

Assim que o grupo é vinculado, o Torneyo posta uma única vez uma mensagem de apresentação: quem ele é, o que faz no grupo e que, para desligar, basta falar com o organizador. Essa mensagem é pré-condição para a leitura de mensagens (opcional) e é repostada se você trocar de grupo.

Estado da conexão

Na tela Encontros, o selo do grupo mostra:

Estado	Significado
Conectado	O número do Torneyo está no grupo e a sessão está ativa.
Desconectado	O número saiu do grupo ou a sessão caiu. Os gestores da turma recebem uma notificação (in-app e push) quando isso acontece duas verificações seguidas, a cada 10 minutos.
Indisponível	A integração está desligada neste ambiente ou o serviço está fora do ar. A tela explica e a turma segue pelo link.

Botões úteis no mesmo bloco: Mensagem de teste (espera 30 s entre testes), Avisar presença (reposta a apresentação) e Pausar postagens, que silencia tudo que o Torneyo faz naquele grupo, inclusive os comandos, até você retomar.

Configurações do grupo

• Horas de antecedência: quantas horas antes do encontro o convite é postado.
• Ler mensagens do grupo (opt-in, desligado por padrão): guarda primeiro nome e texto por 30 dias, com dados pessoais mascarados, para o relatório do dia e as métricas de engajamento. Só liga se a mensagem de apresentação já foi postada.
• Mensagens agendadas: mensagens únicas ou semanais no grupo, com as variáveis {{data}}, {{horario}}, {{local}}, {{link_presenca}} e {{turma}}. Uma mensagem agendada não pode começar com / ou !.

Desvincular ou trocar de grupo

Para trocar, gere um código novo e envie /vincular no grupo novo. Para desvincular de vez, use a opção correspondente em Encontros ou o escopo Desvincular o grupo em Zerar dados da turma. Em ambos os casos, o que deriva do grupo antigo (mensagens, métricas, participantes monitorados) é apagado.

Perguntas frequentes

Preciso de um número meu? Não. O número é do Torneyo. Você só o adiciona ao grupo.

O gestor precisa estar no grupo? Para enviar /vincular, sim (ou peça para alguém do grupo enviar o código). Para os comandos de gestão, o bot reconhece o gestor da organização pelo telefone do usuário ou o admin do grupo do WhatsApp.

O bot lê as conversas? Só se você ligar “Ler mensagens do grupo”. Comandos nunca são guardados como texto.