VotaCerta CRM

• Centraliza eleitores, lideranças, comunicações e tarefas em um só lugar.
• Organiza o campo: cada contato vira histórico e pode virar follow-up (tarefas).
• Dá visão territorial: mapas (ArcGIS) e metas por RA para planejar recursos.
• Apoia estratégia: filtros robustos e IA para perguntas rápidas e insights.

• RA: Região Administrativa (escopo de acesso e recorte de metas).
• Intenção: SIM, TALVEZ, INDEFINIDO, NÃO, SEM_CONTATO.
• Probabilidade: 0 a 100 (ajuda a priorizar).
• Liderança: pessoa que influencia uma rede (também é um eleitor no sistema).
• Comunicação: registro de contato (WhatsApp, visita, telefone, evento etc.).
• Tarefa: próximo passo com responsável e prazo (controle de execução).

1. Login com email e senha.
2. Vá em Usuários (Admin) e confirme seu papel e suas RAs.
3. Vá em Eleitores e cadastre alguns eleitores com endereço (para ver pontos no mapa).
4. Abra 1 eleitor e registre 1 Comunicação com Próximos passos para gerar uma tarefa automaticamente.
5. Vá em Tarefas, filtre por Minhas e conclua a tarefa.
6. Vá em Dashboard e valide: cards, ritmo por RA e mapa/heatmap.

1. No Telegram, use /ra para definir sua RA padrão.
2. Cadastre no modo rápido: /novo Nome;Telefone (reaproveita RA) ou /novo Nome;Telefone;RA.
3. Quando possível, envie uma Localização no chat para registrar coordenadas automaticamente.
4. No fim do dia, abra o CRM e feche tarefas e comunicações pendentes.

1. Use Importação CSV em Dry run para validar uma base antes de gravar.
2. Importe e confira duplicados (telefone/CPF).
3. Valide mapas: porcentagem com coordenadas, concentração por RA, e anomalias (ex: muitos pontos fora do DF).
4. Use IA (Gemini) para responder perguntas do coordenador com recorte (RA + período).

• Preencha Email e Senha.
• Código 2FA (6 dígitos) só é necessário quando seu usuário tiver 2FA exigido/ativado.

• Mínimo: 7 caracteres.
• Recomendação operacional: use frase curta + número (ex: campanha2026).

• O Admin pode marcar Exigir 2FA ao criar o usuário.
• Quando exigido, o usuário faz o setup com app autenticador (Google Authenticator, 1Password etc.).

1. Na tela de login, clique em Esqueci minha senha.
2. Digite seu email e envie.
3. Você receberá um link por email para definir uma nova senha.
4. Ao trocar a senha, suas sessões antigas são invalidadas.

Se não chegar, verifique SPAM. Se ainda falhar, peça ao Admin para conferir o envio (Resend).

• O CRM usa papéis (roles) e escopo por RA.
• Se você tentar cadastrar/editar em uma RA fora do seu escopo, verá erro de acesso.

• Administrador: cria usuários, define RAs, vê auditoria completa, configura 2FA.
• Coordenador regional: opera 1 a 3 RAs, acompanha metas, atribui tarefas e cobra execução.
• Cabo eleitoral: captura eleitores e comunicações, executa tarefas de follow-up.
• Analista de dados: importa CSV, valida dados, segmenta e usa IA.
• Candidato / Observador: leitura de alto nível (podem ter restrições de dados sensíveis).

• Cards: volume total e distribuição por intenção.
• Minhas tarefas: sua fila de execução.
• Ritmo vs meta (RAs): onde está atrasado (precisa reforço) e onde está ok.
• Mapa / Heatmap: concentração de eleitores (filtro por intenção).
• Tendência: evolução nos últimos 30 dias.
• Atividade recente: o que entrou/mudou agora.

• Use o seletor Heatmap por intenção para ver apenas SIM, TALVEZ, INDEFINIDO etc.
• Se o mapa estiver pesado no celular, filtre por uma intenção e clique em Atualizar Heatmap.

1. Abra Dashboard e confira Ritmo vs meta: quais RAs estão atrasadas.
2. Abra Tarefas e filtre Atrasadas: quem está com backlog (e onde).
3. Abra Regiões e compare: Cadastros vs SIM (onde tem volume mas pouca conversão).
4. Abra Lideranças: foque em lideranças com rede grande e pouca taxa SIM (precisam de ação).
5. Crie/atribua 5 a 15 tarefas claras para o dia (com prazo) e acompanhe conclusão.

1. Use IA (Gemini) para perguntas como: conversão por RA, volume de mudanças INDEFINIDO->SIM, e evolução de TALVEZ.
2. Escolha 2 a 3 micro-alvos por semana: 1 RA crítica, 1 liderança-chave, 1 tema (demanda) recorrente.
3. Ajuste execução: reforçar cabos onde a densidade e maior (mapa/heatmap) e a conversão está baixa.

• Obrigatório: Nome, Telefone e RA.
• Telefone: use com DDD (10/11 dígitos) ou com +55.
• Endereço (opcional, mas recomendado): quando preenchido, o sistema tenta geocodificar e gerar coordenadas.
• Liderança: selecione quem indicou/influencia este eleitor (quando aplicável).
• Notas: contexto de campo em texto livre (histórico político, demandas, restrições, etc.).

• Busca: nome, telefone, RA.
• Filtros: RA, intenção, engajamento, probabilidade min/max, profissão, igreja/templo, interesse, fonte, cabo, liderança, período e custom_fields.
• Ordenação: updated_at/created_at/probabilidade/intenção/nome/RA.

Exemplos úteis: "INDEFINIDO em Samambaia", "TALVEZ com prob>70", "Rede de uma liderança".

• Clique em Mapa ArcGIS para ver os pontos.
• Use Somente com coordenadas para exibir apenas quem tem endereço geocodificado (ou coordenadas via Telegram).
• Se um eleitor tem endereço mas não aparece: revise o texto do endereço e salve novamente.

O geocoding é priorizado para Brasília/DF. Endereço incompleto pode falhar.

• Na tabela de eleitores, clique na linha para abrir o painel do perfil.
• Edite endereço, notas e liderança.
• Ao salvar um endereço, o sistema tenta atualizar coordenadas automaticamente (se ArcGIS estiver configurado).

• No formulário de cadastro do eleitor (ou no perfil), selecione a Liderança.
• Se preferir, use o formulário Atualizar Liderança informando o ID do eleitor.
• Isso alimenta a rede (mapa e lista) da liderança.

• Toda mudança de intenção (antes/depois) aparece no Histórico de intenção.
• Isso permite medir conversão (ex: INDEFINIDO -> SIM) por semana/RA/cabo.

• No perfil do eleitor, escolha o tipo (WhatsApp, visita, telefone, evento etc.).
• Preencha Resumo com o essencial (1 a 3 linhas).
• Se houve mudança, preencha Intenção após contato e, se quiser, Sentimento.
• Use Demandas (separadas por vírgula) para capturar temas: asfalto, creche, segurança etc.

• Ao preencher Próximos passos, o CRM cria uma tarefa automaticamente (prazo: amanhã).
• Regra operacional: toda conversa que pede retorno vira tarefa.

• Use Anexar arquivos para enviar áudio, foto, PDF etc junto da comunicação.
• Os links aparecem em Links de anexos (1 por linha) e ficam no histórico do eleitor.

• Transformar o CRM em execução: quem faz o quê, até quando.
• Evitar perder follow-up (principalmente TALVEZ/INDEFINIDO).
• Dar visibilidade: tarefas concluídas vs atrasadas por pessoa/equipe.

• Crie tarefa pela aba Tarefas (precisa do Voter ID) ou dentro do Perfil do eleitor.
• Use títulos diretos: "Retornar ligação", "Confirmar voto", "Enviar material".
• Marque como CONCLUÍDA quando finalizar e registre o resultado nas notas.

• Admin/Coord/Analista podem escolher o Responsável.
• O responsável precisa ter acesso à RA do eleitor.
• Ao atribuir para cabo eleitoral, o eleitor precisa estar vinculado ao cabo (o sistema pode vincular automaticamente quando estiver vazio).

• Liderança é uma pessoa com capacidade de influenciar votos (líder comunitário, religioso, político, etc.).
• Uma liderança sempre referencia um eleitor (ela também é um eleitor no cadastro).
• A rede é formada pelos eleitores que têm o campo Liderança preenchido.

1. Cadastre (ou encontre) o eleitor que será a liderança.
2. Copie o Voter ID desse eleitor.
3. Na aba Lideranças, crie com tipo/compromisso/alcance (opcional).
4. Depois, vincule a rede: no cadastro de cada eleitor, selecione essa liderança.

• No modo Mapa ArcGIS, clique em um ponto para focar a liderança.
• O mapa pode mostrar também os eleitores influenciados (rede).
• Use Ver rede no mapa no perfil da liderança para isolar apenas ela e sua rede.
• Use Voltar (todas) para retornar ao mapa completo.

• A página Regiões é focada em mapa e ranking.
• Use Tamanho por para alternar a métrica (Meta de votos, SIM, Cadastros).
• Clique em uma RA no mapa para ver detalhes e comparar no ranking.

O CSV deve ter cabeçalho. Mínimo obrigatório:

nome,telefone,ra

Use o botão Baixar modelo CSV na própria página de importação.

• Dry run: valida e mostra preview sem gravar.
• Duplicados: por telefone/CPF (e combinação nome+telefone). Ação:
• Pular (skip): ignora duplicados.
• Atualizar (update): atualiza campos principais do cadastro existente.
• Criar novo (create_new): cria um registro adicional.

• Inclua RA e período: "na última semana", "nos últimos 30 dias" etc.
• Peça contagens, tendências e comparações simples.

Quantos eleitores em Samambaia mudaram de INDEFINIDO para SIM nos últimos 7 dias?
Qual RA teve mais cadastros ontem?
Quantos TALVEZ existem hoje em Ceilândia e quantos têm probabilidade acima de 70?

• Por segurança, o CRM bloqueia SQL perigoso (comandos de escrita, múltiplas queries, etc.).
• Reescreva a pergunta para algo que resulte em apenas SELECT (contagens e filtros).
• Evite colar SQL manualmente. Faça a pergunta em português.

• As respostas respeitam o seu papel e seu escopo de RAs.
• Se você não tem acesso a uma RA, a IA não deve retornar dados dessa RA.

1. Entre como Administrador.
2. Vá em Usuários.
3. Preencha nome, email, senha temporária e papel (role).
4. Selecione as RAs que o usuário pode acessar.
5. Opcional: marque Exigir 2FA.

• Logins, criações/edições, importações e ações relevantes ficam registradas.
• Por privacidade, apenas Admin vê endereços IP no log de auditoria.

/help
/novo
/novo Nome;Telefone
/novo Nome;Telefone;RA
/novo Nome;Telefone;RA;INTENCAO;PROB;ENDERECO;NOTAS
/ra
/endereco ENDERECO
/endereco VOTER_ID ENDERECO
/buscar termo
/atualizar VOTER_ID campo=valor
/cancelar

/novo Rodrigo Roriz;99853333;Lago Sul;SIM;100%;SHIS QI 11 Conj 08 Casa 20;Encontrei no evento

O bot aceita telefone com DDD (ex: 61998533333) ou +55. Se você enviar apenas 8/9 dígitos, ele tenta assumir DDD 61.

• Use /ra e selecione sua RA uma vez.
• Depois use /novo Nome;Telefone e o bot reaproveita a RA (e abre seletor de intenção).
• Avançado: para mandar tudo em uma linha usando RA padrão, você pode pular a RA deixando vazio:

/novo Nome;Telefone;;SIM;90

• Envie uma Localização durante ou logo após salvar um eleitor para registrar coordenadas automaticamente.

1. Comece por tarefas atrasadas e vencem hoje.
2. Registre toda comunicação relevante (não confie em memória/WhatsApp).
3. Todo pedido de retorno vira Próximos passos (gera tarefa).
4. No fim do dia: revise TALVEZ/INDEFINIDO e programe follow-ups.

• Inclua rua/quadra + número + bairro/RA quando souber.
• Exemplos: "QS 308 Conj 2 Casa 10, Samambaia"; "SHIS QI 11 Conj 08 Casa 20, Lago Sul".
• Evite: "perto do mercado" (não geocodifica).

• Seu usuário não tem permissão para a RA escolhida.
• Um Admin deve ir em Usuários e adicionar a RA ao seu escopo.
• Se veio do Telegram: confirme se o texto da RA está correto (ex: "Samambaia" ou "RA-XII").

• Sem endereço/coords: o eleitor pode não aparecer no mapa.
• Ative Somente com coordenadas para confirmar quantos estão geocodificados.
• Revise endereços com pouca informação e salve novamente.

• Reescreva como pergunta de contagem/consulta.
• Inclua RA e período.
• Evite ponto e vírgula e qualquer comando de escrita.