Como importar e exportar contatos políticos em CSV

O Gabinete Digital permite importar e exportar contatos em CSV. O fluxo valida o arquivo, informa quantos registros foram importados, duplicados ou rejeitados e impede a entrada de alguns campos usados para classificação política.

Antes de abrir o arquivo, confirme se a base pode ser utilizada. Origem, finalidade, fundamento jurídico, retenção e compartilhamentos precisam estar documentados; consentimento isolado não torna legítima uma lista obtida irregularmente. Faça primeiro um lote pequeno, confira o resultado e só então avance para o restante da base.

Quem pode importar ou exportar

A referência comercial é o Gabinete Completo. Para importar, alterar ou exportar contatos, a conta precisa estar com o acesso completo e com a ação correspondente liberada.

Em somente leitura, o histórico pode ser consultado, mas não há importação, alteração ou exportação.

Modelo atual do CSV do Gabinete

O modelo disponível na interface usa ponto e vírgula e inclui estes cabeçalhos:

nome;email;cidade;endereco;cep;celular;prioridade;responsavel;proxima_acao;data_proxima_acao;lgpd_consentimento;lgpd_consentimento_em;lgpd_consentimento_origem

Use somente as colunas necessárias. Não preencha consentimento como “sim” sem evidência da ação, do texto apresentado e da origem.

Campos que o importador bloqueia no Gabinete

O CSV do Gabinete rejeita classificações eleitorais, opiniões, notas e campos livres de observação. Entre os nomes bloqueados estão status de funil, pontuação de apoio, opinião, comentário, anotação e variações equivalentes.

Esse bloqueio não certifica toda a conformidade; ele evita um conjunto conhecido de classificações incompatíveis com o fluxo atual.

Como preparar o arquivo

1. Baixe o modelo da própria interface.
2. Mantenha os cabeçalhos esperados e o separador correto.
3. Remova colunas sem finalidade.
4. Normalize e-mails, telefones, CEP e datas.
5. Elimine linhas vazias e revise duplicidades conhecidas.
6. Guarde evidência de origem e autorização fora do arquivo que será importado.
7. Proteja o arquivo durante transferência e armazenamento.

Para uma preparação guiada apenas da importação, veja como importar contatos sem perder dados.

Como importar e interpretar o resultado

1. Acesse Gabinete Digital > Pessoas.
2. Abra a ação de importar CSV.
3. Selecione ou cole o conteúdo conforme a interface.
4. Revise o resumo antes de seguir.
5. Leia as contagens de importados, duplicados e erros.
6. Corrija somente as linhas com problema e faça uma nova rodada pequena.

Duplicado não significa necessariamente erro: e-mail e telefone podem coincidir com uma pessoa já registrada. Não crie outro contato apenas para contornar a deduplicação.

Como exportar com segurança

A exportação permite selecionar campos e aplicar filtros autorizados. A plataforma limita a consulta ao site da equipe e bloqueia filtros eleitorais no Gabinete. O arquivo gerado é CSV e respeita o limite operacional mostrado durante a exportação.

1. Defina a finalidade concreta da exportação.
2. Selecione o menor conjunto de campos.
3. Evite baixar dados sensíveis quando não forem necessários.
4. Armazene em local com acesso restrito.
5. Registre quem baixou, por quê e quando o arquivo será apagado.
6. Não envie por grupos ou contas pessoais sem proteção.

O tutorial de exportação de contatos do CRM mostra a operação específica.

O que não fazer

• comprar ou raspar listas;
• usar “base eleitoral” como se fosse cadastro oficial de eleitores;
• importar opinião ou pontuação de apoio;
• marcar consentimento sem evidência;
• exportar para contornar bloqueios do Gabinete;
• manter cópias indefinidas em dispositivos pessoais.

Para estruturar contatos e etiquetas operacionais antes da migração, leia o guia de CRM e cuidados com dados.

Mantenha um registro da operação

Para cada importação, anote arquivo de origem, responsável, finalidade, data, quantidade de linhas, resultado e correções feitas. Para cada exportação, registre campos, filtros, destinatário autorizado e descarte previsto. Esse histórico ajuda a investigar duplicidades e atender direitos sem transformar o CSV em depósito permanente.

Próximo passo

Veja a gestão de contatos do Gabinete Digital e organize a migração em lotes revisáveis.

Este conteúdo é informativo. Não substitui orientação jurídica eleitoral nem análise de proteção de dados para a origem e a finalidade de cada base.