1Para que servem os grupos

Uma organização Tavora vive nos grupos do Telegram que você conecta a ela: é ali que os membros votam as propostas, recebem tarefas, eventos e avisos e usam comandos como /board, /newtask, /done.

Você pode ter vários grupos na mesma organização — um para os associados, um para a diretoria, um para cada departamento —, cada um com as suas funções ativadas. Máximo de 20 grupos por organização: o limite não pode ser aumentado, então para conectar outro grupo você precisa antes desconectar um.

2Método 1: adicionar o bot ao grupo

Para conectar um grupo são necessárias duas coisas ao mesmo tempo: a permissão «Conectar grupos» na organização (o fundador e os administradores já a têm) e ser administrador do grupo do Telegram. O bot também precisa ser administrador do grupo.

O jeito mais rápido: toque em «Me adicione a um grupo» (no fim da criação) ou «Adicionar grupo» (na tela inicial do bot) e escolha o grupo. O Telegram pede logo que você dê ao bot os poderes de administrador: você confirma e o bot já entra como admin. Se você tem uma só organização, o grupo é conectado na hora; se tem mais de uma, o bot escreve para você no privado para você escolher (no grupo os nomes das suas organizações nunca aparecem).

Se, em vez disso, você adicionar o bot como membro comum, promova-o a administrador: assim que você o promover, ele mesmo propõe a conexão. Ou então toque em «🔗 Conectar este grupo» abaixo da mensagem de boas-vindas dele, ou escreva /link no grupo: mesmo comportamento (uma só organização → conectado na hora; várias → a escolha chega no privado). Se você é um admin anônimo, /link responde com o botão «🔗 Conectar este grupo»: toque nele e a conexão é feita em seu nome.

3Método 2: conectar com o ID do grupo

Se preferir fazer tudo pelo chat privado com o bot:

Adicione o bot ao grupo e promova-o a administrador
No grupo, como administrador, use o comando /chatid para ler o ID numérico do grupo
No privado com o bot, vá em «⚙️ Gestão» → «🔗 Grupos» → «➕ Conectar grupo» e cole o ID, com o sinal de menos (ex.: -1001234567890)

Um grupo já conectado a outra organização não é transferido. Canais não podem ser conectados: o Tavora funciona só em grupos. Quando você chega a 20 grupos, «➕ Conectar grupo» some do menu.

4Ativar funções e configurar o grupo

Um grupo recém-conectado começa com tudo desligado: nada de propostas, tarefas ou avisos do Balcão até você ativá-los. Cada função é ativada no seu próprio menu:

Propostas — «⚙️ Gestão» → «🔗 Grupos» → «💡 Grupos de propostas»: marque os grupos onde as propostas são publicadas e votadas. É preciso ter «Conectar grupos» e a função «Propostas e votações» ativa; com o Balcão ligado, a mesma lista também abre em «📮 Balcão» → «🔗 Grupos de destino» → «💡 Propostas». Num grupo com as propostas ativadas, qualquer pessoa com a permissão «Criar propostas» pode propor.
Tarefas — «Atividades» → «🔗 Grupos de tarefas»: define onde funcionam os comandos de tarefas, o feed e o resumo. Com departamentos a lista é por departamento, e atribuir um grupo a um departamento («🗂 Departamentos» → departamento → «👥 Grupos») ativa as tarefas ali. Depois do primeiro departamento, os grupos sem departamento não têm tarefas nem turnos até você atribuí-los.
Avisos do Balcão — «📮 Balcão» → «🔗 Grupos de destino» → «🙋 Pedidos» / «🚩 Reportes»: o grupo recebe só um breve aviso de chegada, nunca o conteúdo nem o nome de quem escreveu.

As configurações do próprio grupo abrem em «⚙️ Gestão» → «🔗 Grupos», tocando no número do grupo, ou escrevendo /settings no grupo (nesse caso o painel responde só a quem o abriu). É preciso ter «Conectar grupos». Valem só para aquele grupo:

Pin de propostas — fixa no topo as propostas publicadas neste grupo
«🚪 Acesso à organização» — entrada e saída automáticas: quem entra no grupo pode ser adicionado à organização ou convidado a entrar, e quem sai pode ser removido dela
«🗑 Desconectar grupo» (dentro do grupo se chama «🔓 Desconectar grupo»), com confirmação

Propostas e tarefas não se ativam pelo painel do grupo: elas são ativadas nos menus das suas funções (veja acima). O idioma em que o bot escreve nos grupos é um só para toda a organização: «🌐 Idioma da organização», em «⚙️ Gestão» → «⚙️ Configurações». No fim do painel o bot também avisa se não é admin no grupo ou se não pode fixar mensagens.

5Desconectar um grupo

Para desconectar um grupo: «⚙️ Gestão» → «🔗 Grupos» → toque no número do grupo → «🗑 Desconectar grupo», ou /settings no grupo → «🔓 Desconectar grupo». Será pedida uma confirmação. As votações ainda abertas naquele grupo se encerram com os votos recolhidos até aquele momento, que ficam no resultado, e quem escreveu a proposta recebe um aviso. Os dados da organização continuam lá.

Se o bot for removido do grupo, a conexão é desfeita sozinha e todos os que têm «Conectar grupos» recebem um aviso no privado com o nome do grupo e o botão «🔗 Grupos». As propostas e tarefas já arquivadas não se perdem.

Se o bot perder os poderes de administrador, o grupo continua conectado, mas fixar mensagens, expulsar e criar links de convite deixam de funcionar: quem tem «Conectar grupos» recebe um aviso no privado, no máximo um por dia por grupo. O mesmo acontece se o bot não conseguir mais escrever no grupo.