Importação em massa

Quando você está migrando de outra ferramenta de gestão eclesiástica — ou tem uma planilha que sua secretária vem mantendo — a importação em massa é a ferramenta certa. Ela lida com milhares de linhas, exibe erros por linha e detecta prováveis duplicatas antes que cheguem ao seu banco de dados.

1. Prepare seu CSV

Exporte seus dados para um arquivo CSV (codificado em UTF-8, separado por vírgulas). Você pode usar Salvar como → CSV UTF-8 do Excel ou Baixar → CSV do Google Planilhas.

Colunas recomendadas:

Coluna	Obrigatória	Observações
first_names	sim	Nomes próprios
last_names	sim	Sobrenomes
email	—	Minúsculas, sem espaços
primary_phone	—	Formato E.164 preferido (ex.: +5511987654321)
date_of_birth	—	Formato ISO AAAA-MM-DD
gender	—	male / female / other
country	—	Código de duas letras (BR, US, GB)
date_of_registration	—	Padrão é a data de importação se vazio
member_type	—	Deve corresponder a um rótulo de tipo de membro existente
org_unit	—	Deve corresponder a um nome de unidade existente

Você pode incluir as colunas que quiser — as extras são ignoradas ou mapeadas para campos personalizados na próxima etapa.

TIP

Abra seu arquivo em um editor de texto antes de enviar. Aplicativos de planilha às vezes deformam datas ou números de telefone (transformando +5511... em notação científica). Reformate essas colunas como texto simples.

2. Envie o arquivo

Vá em Membros → Importação em massa. Arraste o CSV ou clique para navegar. O GCM lê a linha de cabeçalho e mostra as primeiras linhas como visualização.

3. Mapeie as colunas

O mapeador mostra as colunas do seu CSV à esquerda e os campos correspondentes do GCM à direita. Fazemos o auto-match por nome — first_names, email, dob encaixam-se automaticamente.

Para colunas que não reconhecemos, você escolhe:

• Mapear para campo existente — escolhe entre qualquer campo padrão ou personalizado.
• Criar campo personalizado — adiciona um novo campo personalizado na hora. Bom para "dons espirituais" ou "data de batismo" que você ainda não configurou.
• Ignorar — para colunas que não quer trazer (IDs internos, notas do sistema de origem).

WARNING

O mapeamento é por importação. Se executar uma segunda importação, você definirá o mapeamento novamente. Salve seu template de CSV preparado para que os nomes das colunas combinem todas as vezes.

4. Detecção de duplicatas

Antes de salvarmos qualquer coisa, o GCM varre seu arquivo contra os membros existentes. Marcamos:

• Correspondência exata de nome + e-mail.
• Correspondência exata de nome + telefone.
• Correspondência aproximada de nome dentro da mesma unidade organizacional.

Para cada correspondência você escolhe:

• Pular — deixa o cadastro existente intacto, descarta a linha.
• Atualizar — funde os dados do CSV no cadastro existente (valores não vazios do CSV ganham).
• Criar mesmo assim — útil quando duas pessoas reais têm o mesmo nome.

5. Revise e importe

A tela final mostra os totais: quantos serão criados, atualizados, ignorados e quantos tiveram erros.

Clique no botão de importação. O job roda no servidor e mostra o progresso ao vivo. A maioria das importações de 500 linhas termina em menos de um minuto.

Quando termina, você recebe um relatório de erros para download listando as linhas que falharam e por quê (formato de data inválido, campo obrigatório ausente, unidade não encontrada etc.). Corrija essas linhas e reenvie — o detector de duplicatas vai pular as linhas que já foram importadas com sucesso.

6. Depois da importação

Visite Membros e você verá os novos cadastros. Agora é uma boa hora para:

• Executar o scanner de duplicatas para pegar qualquer coisa que a verificação por linha tenha deixado passar.
• Abrir uma amostra de perfis para confirmar se fotos, campos personalizados e atribuições de unidade estão corretos.
• Disparar um workflow de "bem-vindo ao GCM" se quiser que todos recebam uma notificação.

Perguntas comuns

Qual é o tamanho máximo do arquivo? 50.000 linhas ou 25 MB, o que for menor. Importações maiores — divida em pedaços.

Posso importar presença ou doações ao mesmo tempo? Não. A importação em massa de membros lida apenas com cadastros de membros e seus campos diretos. Presença e doações têm seus próprios importadores com validação mais rigorosa.

Isso dispara workflows? Por padrão não — as importações em massa pulam o gatilho member.created para evitar enviar mensagens de boas-vindas a todos no meio da migração. Há uma caixa de seleção na tela final de revisão se você realmente quiser que os gatilhos disparem.

E se eu importar o arquivo errado? Abra a página Configurações → Dados e Logs e encontre a importação no histórico. Você pode revertê-la, o que faz soft-delete de todos os membros criados naquele lote. Membros com soft-delete são restauráveis por 30 dias.

Próximos passos

• Campos personalizados — defina a estrutura antes da sua segunda importação.
• Fundindo duplicatas — limpeza após uma importação confusa.