🎧 Painel de Suporte VIS — Guia do Operador

1 O que é o painel

O Painel de Suporte é uma página web que a equipe de apoio usa durante a assembleia para conversar com os votantes pelo chat, enviar avisos e acompanhar quem entrou, quem está online e como estão as votações. Ele não precisa de instalação: abre no navegador e conversa direto com o sistema VIS.

• 💬 Chat um-a-um com cada votante, em tempo real.
• 📣 Aviso para todos os participantes de uma vez.
• 👥 Presença: quantos acessaram, quantos estão online agora e quanto cada um votou.
• 📊 Votações: resultado de cada pergunta, com exportação.

2 Entrar (login)

Ao abrir o painel você vê a tela de login. Por padrão ele já vem configurado para o servidor XVote (produção) — na maioria das vezes você só precisa digitar seu e-mail e senha de operador.

• 1 Digite seu e-mail de operador.
• 2 Digite sua senha (pode apertar Enter para entrar).
• 3 Clique em Entrar.
• 4 A engrenagem (⚙) só é usada se precisar trocar de servidor — veja a próxima seção.

3 Trocar de servidor

Se a sua assembleia está em outro servidor (Voto Remoto/SIP, Easyvote, Staging ou um endereço próprio), clique na engrenagem (⚙) no canto inferior direito para exibir a lista de servidores.

• 1 Escolha um dos servidores prontos.
• 2 Ou selecione “Outro servidor…” para digitar um endereço próprio (ex.: https://api.seucliente.com.br/api/v1/).
• 3 Clique na engrenagem de novo para esconder — depois é só logar normalmente.

4 Escolher projeto, evento e sessão

Depois de entrar, use os três seletores no topo, da esquerda para a direita: primeiro o Projeto, depois o Evento e por fim a Sessão que você vai apoiar. Só a partir da sessão escolhida o painel carrega os dados.

• 1 Projeto — o cliente/conta.
• 2 Evento — opcional; filtra as sessões daquele evento (deixe em “todos” se preferir ver tudo).
• 3 Sessão — a sala de votação. ● = aberta, ○ = fechada. O estado aparece ao lado (ABERTA · slide atual).

5 A tela por dentro

Com a sessão escolhida, o cabeçalho passa a mostrar indicadores úteis e as três abas de trabalho.

• A ⚡ ao vivo = conexão em tempo real ativa (mensagens e “online” instantâneos). Se aparecer ⚡ off, o painel usa atualização periódica — veja a seção Tempo real.
• B 👥 acessaram / total — quantos votantes já entraram no sistema.
• C 🟢 online — quantos estão conectados neste momento.
• D Badge vermelho na aba Chats = total de mensagens não lidas.

Atualizar recarrega os dados na hora. Sair encerra a sessão do navegador.

6 Aba Chats: atender conversas

Esta é a tela principal do suporte. À esquerda ficam as conversas; à direita, a conversa aberta.

• 1 Filtros de conversa: Ativas, Arquivadas ou Todas — e uma busca por nome/keypad.
• 2 + Nova conversa: inicia um chat com um votante que ainda não escreveu.
• 3 Barra de ações: mensagem a todos, snippets e exportar (detalhados adiante).

Na lista, a bolinha ao lado do nome indica ● online / ● offline; o número vermelho é a quantidade de mensagens não lidas daquela conversa; o 👁 abre o detalhe do participante sem abrir a conversa. Clique em qualquer conversa para abri-la.

7 Responder um votante

1. Clique na conversa na lista à esquerda. Ao abrir, as mensagens são marcadas como lidas automaticamente (o contador zera).
2. Escreva no campo inferior e clique em Enviar (ou aperte Enter). Para quebrar linha, use Shift+Enter.
3. Suas mensagens aparecem à direita, em azul; as do votante à esquerda. Se a conexão está ⚡ ao vivo, as respostas do votante chegam sozinhas.

8 Mensagens prontas (snippets)

Snippets são textos que você salva uma vez e reaproveita nas conversas — por exemplo “Como votar” ou “Horário de encerramento”. Ficam guardados neste navegador.

1. Na barra de ações, clique em ✂️ Snippets.
2. Digite um título e o texto, e clique em Salvar snippet. Repita para quantos quiser.
3. Numa conversa, use o menu ✂️ ao lado do campo de texto para inserir o snippet — depois é só ajustar e enviar.
4. Para levar seus snippets a outro computador, use Exportar JSON num e Importar JSON no outro.

9 Mensagem para todos

Para avisar todos os votantes de uma vez, clique em 📣 Mensagem a todos. Há dois modos:

10 Arquivar conversas

Depois de resolver um atendimento, você pode arquivar a conversa para tirá-la da lista de ativas sem perder o histórico.

1. Abra a conversa e clique em 🗄 Arquivar no cabeçalho dela.
2. Ela sai de Ativas e passa para Arquivadas (use o filtro no topo para vê-la).
3. Para reabrir, entre em Arquivadas, abra a conversa e clique em ↩ Desarquivar.

11 Exportar chats

O botão ⬇ Exportar oferece três formas de salvar as conversas:

Você também pode exportar a conversa atual pelos botões XLSX/PDF no cabeçalho dela. O PDF é gerado pela janela de impressão do navegador (escolha “Salvar como PDF”).

12 Aba Participantes

Mostra todos os votantes da sessão e o estado de cada um: se acessou o sistema, se está online agora e quanto já votou.

Os cartões no topo resumem: cadastrados, acessaram, online agora, votaram e nunca acessaram. A barra de filtros combina vários critérios ao mesmo tempo — o contador ao lado do XLSX mostra quantos participantes restam:

• Y Papel: mostra só um papel (votante, unidade ou representante). A lista de papéis é montada conforme a sessão.
• Z Voto: votaram ou não votaram (ou “todos”). Combine com o Papel para, por ex., ver “representantes que não votaram”.
• W Limpar filtros: zera busca, papel, voto e as caixas de uma vez.

• Complementam a busca as caixas “só quem acessou” e “só online” (esta última só com o tempo real ativo).
• Em cada linha: 👁 abre o detalhe do participante; 💬 abre (ou cria) a conversa dele no chat.
• XLSX X exporta a lista já filtrada para planilha.

13 Detalhe do participante

Clicando no 👁 (na lista de participantes ou numa conversa) abre uma janela com todos os dados daquele votante — inclusive as colunas extras importadas para a sessão.

Para representantes, a janela lista as unidades representadas. As colunas extras (bloco, CPF, unidade etc., conforme a importação) aparecem no fim. O botão 💬 Abrir conversa leva direto ao chat da pessoa.

14 Aba Votações

Acompanhe o resultado de cada pergunta da sessão, com contagem por alternativa e por peso.

Use XLSX ou PDF no topo para exportar todos os resultados. Ao entrar na aba, os números são recarregados para refletir o estado atual (aberta/fechada e votos).

15 Tempo real vs. atualização

O painel tenta se conectar ao sistema em tempo real. O indicador no cabeçalho mostra o estado:

16 Segurança e boas práticas

• 🔑 Login por operador: use sua própria credencial. O acesso fica só neste navegador e some ao fechar.
• 🚨 Mensagem a todos dispara push real — confirme o texto e o número de destinatários antes de enviar.
• 🧪 Treine no Staging: para aprender ou testar, entre pela engrenagem e escolha Staging (quase.online). Nunca teste em produção.
• 👁 Dados dos votantes (CPF, colunas extras) são sensíveis — evite exportar/compartilhar sem necessidade.
• 🚪 Ao terminar, clique em Sair, principalmente em computadores compartilhados.

17 Problemas comuns