Como importar contatos para o CRM do Site do Político

A importação de contatos economiza digitação, mas exige uma base limpa e uma cópia de segurança. No Site do Político, o Gabinete Digital recebe arquivos CSV separados por ponto e vírgula. O processo informa quantos registros foram importados, identificados como duplicados ou rejeitados por erro; ele não substitui a revisão da equipe.

Quem pode importar

Abra /painel/crm/[site]/eleitores, substituindo [site] pelo identificador do projeto. Use a ação Importar planilha de contatos. A importação requer acesso FULL e permissão de escrita em contatos. No modo READ_ONLY, a base pode ser consultada, mas não alterada; no modo LOCKED, resolva o requisito indicado pelo painel.

Se a base ainda precisa de uma taxonomia simples, organize primeiro os segmentos operacionais do CRM.

Use o modelo disponível no painel

No drawer de importação, a ação Copiar modelo oferece o cabeçalho atual. O arquivo deve usar esta primeira linha:

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

Salve em CSV com codificação UTF-8 e mantenha o ponto e vírgula como separador. Cada linha seguinte representa um contato. Não renomeie as colunas do modelo. Campos sem informação podem ficar vazios, mas não invente dados para preencher a planilha.

Dados que não pertencem a essa importação

O Gabinete Digital trabalha com relacionamento institucional e operacional. Por isso, a importação rejeita campos de classificação político-eleitoral como status_funil, score_apoio, opiniao, opiniao_politica, comentario, anotacoes e extras, inclusive aliases equivalentes. Não tente esconder esse conteúdo em outra coluna.

Etiquetas operacionais reconhecidas podem ser associadas. Etiquetas não resolvidas ou classificações incompatíveis aparecem no resultado para revisão. Prefira região informada, origem do contato, tema solicitado e próximo passo documentado.

Como reduzir erros e duplicidades

1. Exporte ou copie a base original e guarde-a em local protegido.
2. Remova linhas vazias, espaços excedentes e caracteres quebrados.
3. Padronize telefones com DDD e revise e-mails visivelmente inválidos.
4. Confira a finalidade e a origem do tratamento de cada grupo.
5. Crie um arquivo-piloto com poucos registros representativos.
6. Importe o piloto e leia o relatório antes de enviar a base completa.

O sistema compara identidades por e-mail e celular para ajudar a detectar registros relacionados. Dependendo do caso, um registro único pode ser conciliado; conflitos ou identidades ambíguas exigem conferência. Não assuma que toda repetição será ignorada ou que dois contatos parecidos serão unidos automaticamente.

Passo a passo no painel

1. Na lista de contatos, abra Importar planilha de contatos.
2. Cole o conteúdo CSV ou selecione o arquivo preparado.
3. Revise o arquivo fora do painel antes de clicar em importar, pois o fluxo atual não oferece uma tela separada de pré-visualização.
4. Confirme a importação e aguarde o resultado.
5. Anote os totais de importados, duplicados e erros.
6. Abra uma amostra dos contatos e confira nome, telefone, origem, consentimento e próximo passo.

Depois da revisão, você pode exportar uma amostra filtrada para validar o resultado. Se estiver migrando de ferramentas dispersas, veja também o comparativo entre CRM político, planilha e WhatsApp.

Checklist antes da base completa

• [ ] cópia original protegida;
• [ ] cabeçalho idêntico ao modelo;
• [ ] arquivo UTF-8 separado por ponto e vírgula;
• [ ] finalidade e origem dos dados conhecidas;
• [ ] campos político-eleitorais removidos;
• [ ] piloto importado e conferido;
• [ ] erros e duplicidades revisados.

Depois da importação

Não envie a planilha original para grupos de mensagem nem mantenha cópias em computadores pessoais sem necessidade. Registre quem executou a importação, qual arquivo foi usado e onde a cópia protegida ficará guardada. Corrija erros na fonte antes de uma nova rodada. Se um titular pedir atualização ou exclusão, localize também as cópias usadas no processo, não apenas o registro que aparece no CRM.

Próximo passo: abra seu site no painel e faça uma importação-piloto no Gabinete Digital.