Exportar leads

Você precisa de dados em planilha pra análise no Excel, importar em outro sistema, fazer backup, ou submeter pra auditoria. O Syncro permite exportar leads em CSV ou XLSX, com filtros aplicados (mesmos da listagem). Esse artigo cobre as 2 rotas de exportação, formato dos arquivos e limites.

Pré-requisitos

• Permissão admin, manager ou viewer (todos exportam, mas viewers exportam só seus leads).
• Pelo menos 1 lead no sistema.

2 caminhos de exportação

Caminho 1 — Listagem /contatos (CSV)

1. Vá em /contatos.
2. Aplique filtros (busca, etapa, source, data, tag).
3. Clique no botão Exportar (canto superior direito).
4. Sistema gera CSV com leads filtrados.
5. Download imediato (leads-{aaaa-mm-dd}.csv).

Caminho 2 — Kanban /crm (XLSX)

1. Vá em /crm.
2. Aplique filtros (responsável, origem, tag, período).
3. Clique no botão Exportar (ícone planilha).
4. Sistema gera XLSX (Excel nativo) com leads do Kanban filtrado.
5. Download (leads-kanban-{aaaa-mm-dd}.xlsx).

Filtros aplicados

Exportação respeita todos os filtros ativos na tela. Filtros disponíveis:

Em /contatos

• Busca — text search em nome, e-mail, telefone.
• Etapa — leads em etapa específica.
• Origem (source) — manual, whatsapp, formulario, website, api, etc.
• Data de criação — date_from / date_to.
• Tag — leads com tag específica.
• Pipeline — pipeline específico.

Em /crm (Kanban)

• Responsável — leads atribuídos a user específico.
• Origem — mesma do /contatos.
• Tag — uma tag.
• Período — Hoje / Esta semana / Este mês / Últimos 30 dias.
• Pipeline — selecionado no header.

Colunas exportadas

Limites de role

Viewer

• Vê só leads atribuídos a si OU em departamentos onde está.
• Exporta apenas o que vê.

Manager

• Vê leads de departamentos seus + atribuídos.
• Se can_see_all_conversations=true, vê tudo.
• Exporta o que vê.

Admin

• Vê tudo do tenant.
• Exporta tudo.

Veja Permissões de visibilidade.

Tamanho do arquivo

Limite prático

Sem limite hard-coded de quantidade. Mas:

• Até 5.000 leads: rápido (<5s).
• 5k-20k: pode demorar 10-30s. Browser pode sugerir "wait".
• 20k+: considere filtrar por período pra exportar em pedaços (Q1, Q2, etc).

Formato

• CSV: leve, qualquer editor abre. Encoding UTF-8 BOM pra acentos no Excel.
• XLSX: nativo Excel, formatação preservada (números, datas).

Custom fields

⚠️ Atenção: a exportação default não inclui custom fields automaticamente. Apenas as colunas core listadas acima.

Pra exportar com custom fields:

• Use API REST v1 (GET /api/v1/leads) com ?include=custom_fields.
• Resposta JSON tem custom_fields array. Converta pra CSV programaticamente.

Veja API e Webhooks.

UTMs e tracking

Coluna utm_campaign é exportada direto. Outras UTMs (utm_source, utm_medium, utm_term, utm_content) não estão na exportação default.

Pra essas, use API REST v1 ou peça suporte pra exportação custom.

Re-importar exportação

Você pode re-importar o CSV exportado de volta? Sim, com cuidado:

1. Vá em /contatos/importar.
2. Selecione o CSV.
3. Mapeamento automático tenta bater colunas pelo nome.
4. Confirma pra criar leads.

⚠️ Atenção: re-importar cria leads novos — não atualiza os existentes (a menos que use modo upsert no mapping).

Veja Importar contatos via CSV.

Backup periódico

Boa prática: exporte mensalmente pra ter snapshot.

• 1º do mês → exportar tudo (sem filtros).
• Salve em pasta com data: backup-2026-04-30.xlsx.
• Se Syncro tiver problema (raro), tem fallback offline.

Compliance LGPD

Pra atender solicitação de portabilidade (LGPD):

1. Filtrar leads do solicitante (busca por nome/e-mail/CPF).
2. Exportar.
3. Entregar arquivo pro titular.

Pra anonimizar após solicitação:

• Edite leads em /contatos/{id} pra remover dados pessoais.
• Ou delete via DELETE no Kanban.

Sistema mantém audit log.

Casos práticos

Análise no Excel

• Exporta CSV.
• Abre no Excel.
• Usa tabela dinâmica pra agrupar por origem/etapa/responsável.
• Cria gráfico custom.

Importar em outro CRM

• Exporta CSV.
• Mapeia colunas pro novo sistema.
• Importa.
• ⚠️ UTMs/tags podem não bater entre sistemas — revise.

Auditoria fiscal

• Exporta vendas (filtre etapa "Ganho") do período Q4.
• Salva em pasta de auditoria.
• Compara com nota fiscal emitida.

Backup mensal

• Exporta tudo todo dia 1º.
• Salva em Google Drive / Dropbox.
• Mantém 12 meses pra comparação.

Erros comuns

"Botão Exportar não aparece"

• Verifique seu role — se é viewer com 0 leads visíveis, pode não aparecer.
• Atualize página (F5).

"Download começa mas falha no meio"

• Conexão lenta + lots de leads → timeout.
• Aplique filtro mais restritivo (período menor) e exporte em pedaços.

"Excel quebra os acentos no CSV"

• Sistema usa UTF-8 BOM — Excel deveria reconhecer.
• Se não, abra no Excel via Dados → De Texto/CSV → Codificação UTF-8.

"XLSX abriu vazio no Excel"

• Versão antiga do Excel (2003-) não suporta XLSX. Use Excel 2010+ ou LibreOffice.
• Verifique tamanho do arquivo — se 0 bytes, exportação falhou. Re-exporte.

"Faltou campo X na exportação"

Custom fields não vão por default. Use API ou peça suporte.

Próximos passos

• Pra ver dados em tempo real, veja Dashboard overview.
• Pra importar dados de volta, veja Importar contatos via CSV.
• Pra integrações programáticas, veja API e Webhooks.

Artigos relacionados

• Importar contatos via CSV
• Dashboard overview
• Relatório de vendas
• API REST v1