Importando de Outra Plataforma

Se sua igreja está migrando para o TimelyChurch a partir de outro sistema de gestão de igreja — Planning Center People, Breeze, ChurchTrac, Elvanto, Tithely, Realm (ACS), Pushpay / Church Community Builder (CCB), Church Windows, Servant Keeper, uma planilha Google ou qualquer outro — este guia percorre como trazer seus dados de pessoas e famílias.

A versão resumida:

1. Exporte seus dados da outra plataforma como arquivo CSV.
2. No TimelyChurch, abra People na barra lateral.
3. Clique no menu suspenso Add Person ▾ (canto superior direito) e escolha Import from File.
4. Envie o CSV. O TimelyChurch detecta automaticamente o formato de origem e mapeia os campos.
5. Revise o resumo da importação. Pronto.

Oferecemos suporte a importações CSV genéricas mais detecção automática de vários formatos de exportação de plataformas comuns. Esta página cobre o formato CSV genérico em detalhes; guias específicos por plataforma (PCO, Breeze, CCB) estão no roadmap e serão artigos futuros.

Etapa 1: Exporte do Sistema Atual

O processo de exportação de cada plataforma é diferente, mas o objetivo é o mesmo: produzir um arquivo CSV (valores separados por vírgula) com uma linha por pessoa.

Dicas para uma exportação limpa:

• Inclua email e phone se tiver — eles alimentam o login do portal e as comunicações com membros.
• Inclua family relationships se sua plataforma suportar. Identificadores familiares nos ajudam a reconstruir lares.
• Se tiver custom fields no outro sistema, exporte-os também — você pode mapear para campos para campos personalizados do TimelyChurch depois da importação.
• Não se preocupe com ordem ou capitalização das colunas. O TimelyChurch normaliza ambos.

Salve o arquivo como .csv (codificação UTF-8 se sua plataforma oferecer).

Dica: Se tiver mais de um CSV (pessoas + famílias + doações), importe pessoas primeiro. Doações e outros módulos vêm depois.

Etapa 2: Baixe o Modelo do TimelyChurch (Opcional)

Se estiver começando de uma planilha e quiser saber exatamente quais colunas esperamos, baixe nosso modelo:

1. Na barra lateral, abra People.
2. Clique em Add Person ▾, depois Import from File.
3. Na janela Import People, clique em Download template.
4. Abra o arquivo no Excel, Numbers ou Google Sheets.

O modelo tem estas colunas:

Apenas first_name e last_name são obrigatórios. Todo o resto é opcional, mas útil.

Etapa 3: Envie Seu CSV

1. Na barra lateral, abra People.
2. Clique em Add Person ▾, depois Import from File. A janela Import People abre.
3. Arraste seu CSV para a área de upload ou clique em Click to upload e selecione seu arquivo. Aceitamos arquivos .csv (ou .txt) de até 10MB.
4. Decida se mantém Skip duplicates marcado (recomendado — ativado por padrão).
5. Clique em Import People.

O TimelyChurch irá:

1. Detectar automaticamente o formato de origem analisando os cabeçalhos das colunas (sem mapeamento manual de campos).
2. Mapear campos automaticamente com base na origem detectada.
3. Criar registros de Person no diretório.
4. Criar registros de Family quando identificadores familiares estiverem presentes.
5. Ignorar duplicatas se uma pessoa com e-mail ou nome correspondente já existir (configurável).

Etapa 4: Revise o Resumo da Importação

Quando a importação terminar, uma mensagem de confirmação aparece no topo da página People:

Detected Planning Center format. 247 people imported successfully. 38 families created. 4 duplicates skipped.

Ou, se algumas linhas não puderam ser lidas:

47 people imported successfully. 3 rows skipped due to errors.

O resumo informa:

• O formato de origem detectado (para você confirmar que correspondemos corretamente à sua plataforma).
• Quantas pessoas foram criadas.
• Quantas famílias foram reconstruídas.
• Quantas duplicatas foram ignoradas (pessoas existentes com e-mail ou nome correspondente).
• Quantas linhas tiveram erros (dados malformados, campos obrigatórios ausentes).

Formatos Detectados Automaticamente

O serviço de importação do TimelyChurch pode detectar e mapear automaticamente campos destes formatos:

A janela de importação destaca algumas das fontes mais comuns como pílulas, mas o detector automático reconhece todas as plataformas da tabela acima. Se sua plataforma não estiver listada, o detector generic ainda faz um bom trabalho correspondendo nomes comuns de cabeçalho como First Name, Last Name, Email, Phone, Address, City, State, Zip etc.

Dicas para uma Importação Tranquila

Execute um teste pequeno primeiro. Antes de importar toda a congregação, tente uma exportação de teste com 5-10 linhas. Isso detecta problemas como formatos de data errados ou caracteres especiais antes de afetar 500 registros.

E-mail é seu aliado. O e-mail é a primeira coisa que verificamos para duplicatas, e é o que alimenta o login do portal. Certifique-se de que sua exportação tenha e-mails sempre que possível.

Papéis familiares ajudam. Se sua exportação incluir uma coluna como Family Role (Primary, Spouse, Child, Other) ou Family Position, usamos isso para conectar corretamente os relacionamentos familiares. Sem isso, agrupamos por sobrenome + endereço como alternativa.

Formatos de data importam. Datas de nascimento devem ser YYYY-MM-DD (1990-05-15). Se sua exportação usar MM/DD/YYYY, isso geralmente ainda funciona, mas 1990-05-15 é à prova de falhas.

Campos personalizados podem vir depois. Se o sistema antigo tinha campos personalizados (habilidades de voluntário, datas de batismo etc.), não tente encaixar na importação na importação padrão. Traga as pessoas primeiro, depois crie campos personalizados em Church Settings → Custom Fields e atualize os registros (manualmente ou via segunda importação).

Solução de Problemas

O resumo diz "0 imported" com linhas ignoradas. Verifique os cabeçalhos das colunas. O problema mais comum é colunas first_name / last_name ausentes ou com erro de digitação — essas duas são obrigatórias. Se sua exportação usar First e Last (sem sublinhado), renomeie-as.

Duplicatas inesperadas foram ignoradas. O TimelyChurch marca duplicatas primeiro por correspondência de e-mail, depois por nome + sobrenome. Se duas pessoas reais compartilham um e-mail (por exemplo, um casal com um endereço), a segunda será ignorada. Reimporte-as manualmente com e-mails separados. Você também pode desmarcar Skip duplicates antes de importar se quiser trazer todas as linhas.

Registros de família não foram criados. A criação de famílias precisa de um identificador familiar explícito (como family_id ou Household Name) ou sobrenome + endereço correspondentes. Se ambos estiverem ausentes, as famílias não serão reconstruídas — você precisará criar manualmente manualmente ou reexportar com uma coluna de lar incluída.

O formato errado foi detectado. Raro, mas possível se seu CSV tiver cabeçalhos incomuns. Salve novamente a exportação usando os nomes de coluna do modelo TimelyChurch. A detecção automática é uma conveniência, não um requisito.

Caracteres especiais aparecem quebrados (José vira Jos?). Salve seu CSV em codificação UTF-8 em vez de Latin-1 / ANSI. A maioria dos aplicativos de planilha modernos usa UTF-8 por padrão; Excel mais antigo pode precisar da opção explícita "Save as CSV UTF-8".

Migrando Mais do Que Pessoas

Esta página cobre pessoas e famílias. Para outros módulos:

• Histórico de doações — entre em contato com o suporte. Podemos ingerir dados históricos de doações sob solicitação, especialmente se você estiver migrando de uma plataforma principal.
• Eventos / calendário — exporte um arquivo ICS (iCalendar) da plataforma antiga; na página Events você pode importá-lo para trazer seu calendário. (O calendário fica dentro de Events no TimelyChurch.)
• Grupos, turmas, presença, lições — normalmente reconstruídos manualmente no TimelyChurch. A maioria das igrejas usa a migração como chance de organizar.

Dica: Muitas igrejas migram durante um mês de baixa atividade (dezembro ou verão) para que o novo sistema tenha um período tranquilo para se estabilizar antes das operações dominicais de pico retomarem.

Guias Específicos por Plataforma (Em Breve)

Estamos trabalhando em guias passo a passo detalhados para as plataformas mais comuns:

• Planning Center → TimelyChurch
• Breeze ChMS → TimelyChurch
• Pushpay / Church Community Builder → TimelyChurch
• Church Windows → TimelyChurch

Até que esses guias estejam disponíveis, a importação CSV genérica descrita acima atenderá à grande maioria dos casos de migração. Se tiver dificuldade, entre em contato com o suporte e ajudaremos.

Artigos Relacionados

• Checklist de Início Rápido — inclui "Add Your People" como Etapa 4
• Configurações da Igreja — campos personalizados e exportação
• Login com Magic Link para Membros — como membros importados obtêm acesso ao portal