Importação e Exportação de Dados

Público: Este artigo é para administradores da igreja.

O TimelyChurch facilita importar suas pessoas de outras plataformas de gestão de igreja e exportar seus dados para relatórios, backup ou migração.

Os formatos suportados abaixo são detectados automaticamente com base nos cabeçalhos das colunas do seu arquivo.

Importando Pessoas (Importação CSV)

Detecção Automática Inteligente

O TimelyChurch possui um sistema de importação inteligente que detecta automaticamente de qual plataforma de gestão de igreja seu arquivo CSV veio e mapeia as colunas de acordo. Plataformas suportadas incluem:

Quando você faz upload de um arquivo CSV, o sistema examina os cabeçalhos das colunas e identifica automaticamente a plataforma de origem. Em seguida, mapeia as colunas para os campos do TimelyChurch sem necessidade de configuração manual.

Nota: A janela de importação destaca algumas das plataformas mais comuns (Planning Center, Breeze ChMS, ChurchTrac, Elvanto, Tithely, mais "Qualquer CSV"), mas a detecção automática funciona para todas as plataformas na tabela acima.

Como Importar Pessoas

1. Navegue até a seção Pessoas na barra lateral esquerda.
2. Clique no botão Adicionar Pessoa no canto superior direito para abrir seu menu suspenso.
3. Selecione Importar de Arquivo. A janela Importar Pessoas abre.
4. Prepare seu arquivo CSV com os dados das pessoas. Se não está migrando de outra plataforma, clique em Baixar modelo na parte inferior da janela para obter um arquivo inicial pré-formatado (opcional).
5. Arraste e solte seu arquivo CSV na área de upload, ou clique para procurar e selecioná-lo.
6. Deixe Ignorar duplicatas marcado (recomendado). Quando habilitado, o sistema verifica pessoas existentes correspondendo primeiro nome, último nome e endereço de e-mail.
7. Clique em Importar Pessoas.

O Que É Importado

A importação mapeia os seguintes dados do seu CSV para registros de pessoa do TimelyChurch:

• Campos de nome: Primeiro nome, último nome, nome do meio, apelido, prefixo, sufixo
• Informações de contato: E-mail, e-mail secundário, celular, telefone residencial, telefone comercial
• Detalhes pessoais: Gênero, data de nascimento, data de aniversário de casamento, estado civil
• Endereço: Endereço (linha 1 e 2), cidade, estado, CEP/código postal, país
• Específico da igreja: Status de membro, relacionamentos familiares, status ativo/inativo

Agrupamento Familiar

Se sua plataforma de origem inclui identificadores de família/domicílio (ID da família, nome do domicílio, etc.), o TimelyChurch irá:

• Criar automaticamente registros de família
• Agrupar pessoas nas famílias corretas
• Preservar papéis familiares (chefe, cônjuge, filho, etc.) quando disponíveis

Resultados da Importação

Após a importação ser concluída, você verá uma mensagem de confirmação informando:

• Origem detectada — Qual formato de plataforma foi reconhecido (por exemplo, "Formato Planning Center detectado")
• Pessoas importadas — Número de novos registros de pessoa criados
• Famílias criadas — Número de novos registros de família criados
• Duplicatas ignoradas — Número de registros que corresponderam a pessoas existentes
• Linhas ignoradas — Número de linhas com erros (por exemplo, campos obrigatórios ausentes)

Dica: Sempre faça uma importação de teste com um pequeno subconjunto dos seus dados primeiro (10-20 registros) para verificar se tudo mapeia corretamente antes de importar todo o diretório.

Usando o Modelo CSV

Se não está migrando de outra plataforma e quer inserir pessoas manualmente via planilha:

1. Na página Pessoas, abra o menu suspenso Adicionar Pessoa e escolha Importar de Arquivo, depois clique em Baixar modelo dentro da janela de Importação.
2. Abra o modelo no Excel, Google Sheets ou outro editor de planilhas. Ele inclui colunas para primeiro nome, último nome, e-mail, celular, gênero, status de membro, data de nascimento e um endereço postal básico.
3. Preencha os dados das pessoas seguindo os cabeçalhos das colunas. Primeiro nome e último nome são obrigatórios.
4. Salve no formato CSV.
5. Importe o arquivo de volta no TimelyChurch usando a mesma janela de Importação.

Limites de Importação

• Tamanho máximo do arquivo: 10 MB
• Formatos de arquivo: CSV (.csv) ou texto simples (.txt)

Exportando Dados

O TimelyChurch permite exportar seus dados de pessoas e famílias como arquivos CSV para relatórios, análise ou backup.

Como Exportar

1. Navegue até Configurações na barra lateral esquerda para abrir a página Configurações da Igreja.
2. Na barra de abas perto do topo, clique na aba Exportar.
3. Escolha sua exportação e clique no botão Exportar CSV correspondente:
   • Exportar Pessoas — Baixa todos os registros de pessoa
   • Exportar Famílias — Baixa todos os registros de família

Cada exportação baixa todos os registros daquele tipo. O CSV abre no Excel, Google Sheets ou qualquer aplicativo de planilha.

Campos da Exportação de Pessoas

A exportação CSV de pessoas inclui as seguintes colunas:

Campos da Exportação de Famílias

A exportação CSV de famílias inclui:

Nomenclatura dos Arquivos de Exportação

Arquivos exportados são nomeados automaticamente usando o nome da sua igreja e a data da exportação (no formato AAAA-MM-DD):

• Pessoas: nome-da-sua-igreja-people-AAAA-MM-DD.csv
• Famílias: nome-da-sua-igreja-families-AAAA-MM-DD.csv

Dicas para Migração de Dados Bem-Sucedida

1. Limpe seus dados primeiro. Antes de importar, revise seu arquivo CSV em busca de entradas duplicadas, formatação inconsistente e campos obrigatórios ausentes (primeiro nome e último nome no mínimo).

2. Comece com um lote de teste. Importe 10-20 registros primeiro para verificar se o mapeamento de campos parece correto.

3. Deixe "Ignorar duplicatas" marcado. Isso evita criar acidentalmente registros duplicados se importar o mesmo arquivo duas vezes.

4. Verifique agrupamentos familiares. Após a importação, verifique algumas famílias para garantir que os membros foram agrupados corretamente.

5. Faça backup antes de operações em massa. Exporte seus dados atuais antes de fazer uma importação grande, para ter um snapshot de referência se algo der errado.

Perguntas Frequentes

P: Posso importar dados de uma plataforma que não está listada? R: Sim. Se sua plataforma não for detectada automaticamente, o TimelyChurch usará o formato CSV Genérico e tentará corresponder cabeçalhos de coluna comuns (first_name, last_name, email, phone, etc.). Pode ser necessário renomear as colunas do seu CSV para corresponder aos nomes padrão.

P: A importação sobrescreverá registros existentes? R: Não. A importação apenas cria novos registros. Se "Ignorar duplicatas" estiver habilitado, registros que correspondem a uma pessoa existente (por primeiro nome, último nome e e-mail) serão ignorados. Registros existentes nunca são modificados pelo processo de importação.

P: Posso importar histórico de doações/contribuições? R: A importação de pessoas foca em dados de contato e diretório. A importação de histórico de doações pode estar disponível por meio de recursos separados de importação de dados financeiros.

P: Quanto tempo leva uma importação grande? R: A maioria das importações de várias centenas de registros é concluída em menos de um minuto. Importações muito grandes (milhares de registros) podem levar alguns minutos.

P: E se algumas linhas falharem durante a importação? R: O resumo do resultado da importação informará quantas linhas foram ignoradas devido a erros. Causas comuns incluem primeiro ou último nome ausentes, formatos de e-mail inválidos ou dados ilegíveis. Registros importados com sucesso não são afetados por linhas com falha.