Voltar para a Central de Ajuda
GuiaAtualizado em 11/08/2026

Importar pessoas por planilha

Adicione várias pessoas de uma vez usando um arquivo CSV ou XLSX e revise os dados antes de importar.

ProprietárioAdministradorCoordenador

Use a importação quando já tiver uma lista de pessoas em CSV ou XLSX.

Prepare a planilha

Cada pessoa deve ocupar uma linha. Use, de preferência, estes títulos de coluna:

ColunaExemploObservação
Nome completoMaria da SilvaObrigatório
CPF12345678909Obrigatório e válido
PapelliderancaOpcional; se ficar vazio, será Eleitor
Emailmaria@exemplo.comOpcional
WhatsApp21999999999Opcional
UF eleitoralRJUse junto com a zona
Zona eleitoral0123Use junto com a UF
Seção de votação0456Opcional

Se preencher a coluna Papel, use exatamente um destes valores:

  • lideranca
  • cabo_eleitoral
  • eleitor

Faça a importação

  1. 1Abra Banco de Dados.
  2. 2Clique em Importar.
  3. 3Escolha o arquivo CSV ou XLSX.
  4. 4Confira a pré-visualização.
  5. 5Verifique se cada coluna da planilha foi ligada ao campo correto.
  6. 6Corrija os avisos de mapeamento, se houver.
  7. 7Confirme a importação.

O VotoMetrics reconhece vários nomes comuns de colunas. Mesmo assim, sempre revise o mapeamento antes de confirmar.

Entenda o resultado

Ao terminar, a tela separa as linhas em grupos:

  • Inseridas: novas pessoas adicionadas à base.
  • Ignoradas: linhas repetidas que não foram importadas novamente.
  • Rejeitadas: linhas com CPF inválido, campo obrigatório ausente ou outra inconsistência.

Uma duplicidade não atualiza silenciosamente a pessoa existente. Abra a ficha dela para fazer correções.

Atenção à zona eleitoral

UF eleitoral e zona eleitoral devem ser informadas juntas. O número 137, por exemplo, será tratado como 0137.

Se uma zona não for reconhecida, revise a UF e o número ou confira a informação em Zonas TSE.

Antes de importar dados reais

Faça uma primeira importação com poucas linhas. Isso ajuda a confirmar nomes de colunas, papéis e formatos sem gerar uma correção grande depois.