---
title: Importar/Exportar Dados
info: "Aprenda como importar e exportar dados."
image: /images/user-guide/import-export-data/cloud.png
sectionInfo: Descubra o Twenty, um CRM de código aberto.
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';

<Frame>
  <img src="/images/user-guide/import-export-data/cloud.png" alt="Header" />
</Frame>

## Importar Dados

- Você pode importar dados para qualquer objeto usando um arquivo .csv, .xlsx, ou .xls.
- Cada arquivo que você enviar deve conter **apenas um tipo de objeto** (por exemplo, somente registros de Pessoas).
- You can use the Import to **create or update records**.

### Baixe um arquivo de amostra para corresponder ao formato esperado.

1. Vá para uma visualização com o objeto que você está prestes a importar.
2. Clique no ícone `⋮` no canto superior direito e selecione `Importar registros`.
3. Clique em `Baixar arquivo de amostra`.

### Prepare seu csv

Abaixo estão alguns itens a verificar antes de enviar seu arquivo.

- Limite o número de registros a **10.000 por arquivo**.
- **Remova duplicados** do seu arquivo.
  - A unicidade em `Pessoas` é definida por padrão pelo `id` e o `email`. Você também tem a capacidade de definir campos personalizados de `Pessoas` como únicos ao configurar seu modelo de dados.
  - A unicidade em `Empresas` é definida por padrão pelo `id` e o `domínio`. Você também tem a capacidade de definir campos personalizados de `Empresas` como únicos ao configurar seu modelo de dados.
  - Para qualquer outro objeto, incluindo objetos personalizados, você tem a capacidade de definir alguns campos como únicos. Certifique-se de não incluir duplicados ao preparar seus arquivos.
- Recomendamos usar a sintaxe `https://dominio.com` ao enviar seus domínios, pois esta é a utilizada pelo nosso conector com a sua caixa de correio e calendário.
- Você pode **importar as relações entre objetos** fornecendo um dos campos únicos do registro associado.
  - Exemplo: Você quer anexar uma pessoa a uma empresa. Adicione uma coluna no arquivo contendo todos os registros de `Pessoas` que contenham o `id` da empresa -- ou seu `domínio`. Você poderá mapear este campo durante o envio do arquivo.
    <Warning>

**Nota importante:**

- As relações entre objetos no Twenty são "Um para Muitos". Isso significa que cada registro do objeto A pode ser anexado a vários registros do objeto B. Mas cada registro do objeto B pode pertencer a apenas um registro do objeto A.
  _Por exemplo, uma empresa pode ser anexada a várias pessoas. E uma pessoa pode pertencer a apenas uma empresa._

- Para carregar relações via a função de Importação, é necessário fornecer o `id` (ou qualquer outro campo único) do objeto anexado no arquivo que contém os registros do lado "Muitos" da relação.  
  _Por exemplo, você fornece o `id` ou `domínio` da empresa ao enviar registros de pessoas. Você não fornece o `id` (ou `email`) das pessoas ao enviar o arquivo com empresas._
  </Warning>

### Enviar seu arquivo

1. Vá para uma visualização com o objeto que você está prestes a importar.
2. Clique no ícone `⋮` no canto superior direito e selecione `Importar registros`.
3. Clique em `Selecionar arquivo`.
4. Valide o mapeamento dos campos.

- Você não precisa importar todos, pode escolher a opção "Não mapear".
- Para relações, é recomendado mapear apenas um dos campos únicos.
- Você pode precisar também mapear os valores dos seus campos de tipo de seleção e multi-seleção.

5. Clique em `Próximos Passos` e `Revisar as linhas com erros`. Células com problema são destacadas. **Você pode remover a linha ou atualizar a célula diretamente ali**.
6. Quando terminar, clique em `Confirmar`

<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}}/>

### Import FAQ

<details><summary>Vejo problemas de duplicados ao enviar meu arquivo, o que devo fazer?</summary>

Por favor, consulte a seção **Prepare seu csv** acima neste artigo, que contém diretrizes sobre o que será considerado um duplicado.

</details>

<details><summary>Posso importar relações entre objetos?</summary>

Sim, consulte a seção **Prepare seu csv** acima neste artigo, que contém uma seção sobre a importação de relações.

</details>

<details><summary>Posso atualizar registros existentes usando a função de Importação?</summary>

Sim, você pode atualizar registros existentes usando a função de Importação. Certifique-se de fornecer o id (ou qualquer outro campo único) ao reenviar seus registros.

</details>

<details><summary>Posso migrar o `id` das minhas outras ferramentas?</summary>

Sim. Você precisa criar um campo que você define como único em seu modelo de dados que conterá o `id` de suas outras ferramentas. Note que o nome `id` é protegido pois é usado para o id do Twenty.  
Se você quiser criar relações entre objetos usando este campo, consulte a seção **Prepare seu csv** acima neste artigo. Ela contém uma seção sobre a importação de relações.

</details>

## Exportar Dados

Você pode baixar dados da maioria dos seus objetos e até 20.000 registros por exportação.
Para exportar dados de um objeto:

1. Visite o índice do objeto.
2. Escolha a visualização para exportação de dados. Configure as colunas que você deseja baixar ocultando ou adicionando colunas e encontre os registros que você precisa filtrando sua visualização.
3. Acesse o painel lateral através do ícone `⋮` no canto superior direito.
4. Clique em `Exportar visualização`.
5. Selecione o local para salvar os dados CSV. Observe que a exportação pode demorar com um grande número de registros.

<VimeoEmbed videoId="926226303" title="Video demonstration" />

