Visão geral
Exporte os dados do seu espaço de trabalho para CSV para backups, relatórios ou migração. Casos de uso:- Backups regulares — mantenha cópias dos seus dados
- Relatórios externos — analise os dados no Excel, Google Sheets ou em ferramentas de BI
- Migração — mova dados para outro sistema
- Atualizações em massa — exporte, edite e reimporte para atualizar registros
O Que Você Precisa Saber
Limites de Exportação
- Máximo de 20,000 registros por exportação
- Apenas as colunas visíveis são exportadas
- Apenas os registros filtrados são exportados (com base na sua visualização atual)
Para exportações maiores (20,000+ registros), use filtros para exportar em lotes ou use a API.
Permissões
Você precisa da permissão “Export CSV” para exportar dados. Entre em contato com o administrador do seu espaço de trabalho se você não tiver essa opção.Etapa 1: Navegue até o Objeto
Vá para o objeto que você deseja exportar:- Pessoas — para contatos
- Empresas — para organizações
- Oportunidades — para negócios
- Objetos personalizados — qualquer objeto que você criou
Etapa 2: Configure Sua Visualização
Importante: A exportação inclui apenas o que está visível na sua visualização atual.Adicionar/Remover Colunas
- Clique em Opções → Campos (ou no + no final das colunas)
- Marque os campos que você deseja exportar
- Desmarque os campos de que você não precisa
Filtrar Registros (Opcional)
Se você precisa apenas de um subconjunto de dados:- Clique em Filtrar
- Adicione condições de filtro (ex.: “Data de criação > 1 de janeiro de 2024”)
- Somente os registros correspondentes serão exportados
Ordenar Registros (Opcional)
- Clique no cabeçalho de uma coluna para ordenar
- A exportação seguirá sua ordem de classificação
Crie uma visualização dedicada para exportação. Salve uma visualização configurada especificamente para exportações para que você não precise reconfigurar a cada vez.
Etapa 3: Exporte os Dados
- Clique no ícone ⋮ no canto superior direito da tabela
- Selecione Exportar visualização
- Escolha onde salvar o arquivo CSV
- Aguarde a conclusão do download
O Que É Exportado
| Incluído | Não incluído |
|---|---|
| Todas as colunas visíveis | Colunas ocultas |
| Registros que correspondem aos filtros atuais | Registros excluídos pelos filtros |
| Valores de campos personalizados | Campos que não estão na visualização |
| IDs dos registros | Anexos de arquivo |
| IDs de relacionamento | Imagens |
Campos de Relação
IDs de relacionamento são exportados apenas no lado “muitos” de um relacionamento:- Exportação de Pessoas inclui uma coluna
companyId(relação Pessoas → Empresa) - Exportação de Empresas NÃO inclui
peopleIds(Empresas é o lado “um”)
Exportação para Finalidades Específicas
Para Backups
- Crie uma visualização com todos os campos visíveis
- Remova todos os filtros para incluir todos os registros
- Exporte cada tipo de objeto separadamente
- Armazene as exportações em um local seguro
- Defina um lembrete recorrente (semanal/mensal)
Para Relatórios Externos
- Inclua apenas os campos necessários para a análise
- Aplique filtros para focar nos dados relevantes
- Considere ordenar pelo campo que você analisará
Para Atualizações em Massa
- Exporte os registros que você deseja atualizar
- Inclua o identificador único (
email,domainouid) - Edite o arquivo exportado
- Reimporte para atualizar os registros Veja: Como Atualizar Registros Existentes
Para Migração
Se você está exportando para migrar para outro sistema:- Exporte cada objeto separadamente — Pessoas, Empresas, Oportunidades, etc.
- Inclua campos de ID — eles ajudam a manter os relacionamentos
- Documente os mapeamentos de campos — observe como os campos do Twenty se mapeiam para o seu sistema de destino
Como Lidar com Conjuntos de Dados Grandes (20,000+ Registros)
O limite de exportação é de 20,000 registros. Para conjuntos de dados maiores:Opção 1: Exportar em Lotes
- Adicione um filtro (por exemplo, intervalos de “Data de criação”)
- Exporte o primeiro lote
- Altere o filtro
- Exporte o próximo lote
- Combine os arquivos na sua planilha
- Por intervalo de datas (janeiro, fevereiro, março…)
- Por responsável (Membro da equipe A, Membro da equipe B…)
- Por status (Ativo, Inativo…)
Opção 2: Usar a API
A API não tem limite de registros:- Obtenha sua chave de API em Configurações → Desenvolvedores
- Use a API GraphQL para consultar registros
- Processe os resultados no seu aplicativo
Dicas e Boas Práticas
Crie Visualizações de Exportação
Salve visualizações configuradas especificamente para exportações:- Configure colunas e filtros
- Clique em Opções da visualização → Salvar como nova visualização
- Nomeie como “Export - [Finalidade]“
Proteja Suas Exportações
Arquivos exportados podem conter dados sensíveis:- Armazene em locais seguros
- Exclua exportações antigas quando não forem mais necessárias
- Tenha cuidado ao compartilhar arquivos de exportação
Verifique Antes de Exportar
As colunas corretas estão visíveis
Os filtros estão configurados corretamente (ou removidos para exportação completa)
Você tem permissão de Exportação
Perguntas frequentes
Por que algumas colunas estão ausentes na minha exportação?
Por que algumas colunas estão ausentes na minha exportação?
Apenas as colunas visíveis são exportadas. Adicione as colunas necessárias em Opções → Campos antes de exportar.
Por que minha exportação não tem todos os registros?
Por que minha exportação não tem todos os registros?
Verifique seus filtros. A exportação inclui apenas registros que correspondem aos filtros da sua visualização atual. Remova os filtros para exportar todos os registros.
Posso exportar mais de 20,000 registros?
Posso exportar mais de 20,000 registros?
Não em uma única exportação. Use filtros para exportar em lotes ou use a API para conjuntos de dados maiores.
Qual é o formato do arquivo de exportação?
Qual é o formato do arquivo de exportação?
CSV (valores separados por vírgula). Abre no Excel, Google Sheets ou qualquer aplicativo de planilha.
Os IDs de relacionamento são incluídos?
Os IDs de relacionamento são incluídos?
Sim, mas apenas no lado “muitos” dos relacionamentos. Por exemplo, uma exportação de Pessoas inclui
companyId, mas uma exportação de Empresas não inclui IDs de pessoas.Posso automatizar exportações?
Posso automatizar exportações?
Não diretamente pela interface. Use a API para criar fluxos de trabalho de exportação automatizados.
Próximos Passos
- Como Atualizar Registros Existentes — edite e reimporte sua exportação
- Como Importar Dados via API — para conjuntos de dados grandes
- Documentação da API — crie fluxos de trabalho de exportação personalizados