> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brainchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar CSV/Excel

> Suba um arquivo e o Brainchat infere automaticamente os tipos de coluna e cria a tabela.

Se você já tem os dados em uma planilha, a importação cria a tabela completa em poucos cliques. O Brainchat detecta automaticamente o tipo de cada coluna (boolean, CPF, CNPJ, e-mail, URL, telefone, moeda, número, data) com base nos valores.

***

## Formatos aceitos

| Formato | Extensão |
| - | - |
| CSV (separado por vírgula ou ponto-e-vírgula) | `.csv` |
| Excel | `.xlsx` |

A primeira linha do arquivo é considerada o **cabeçalho** (nome das colunas).

***

## Passo a passo

**1. Iniciar importação**

Em **Tabelas**, clique em **Nova Tabela → Importar CSV/Excel**.

**2. Subir arquivo**

Arraste o arquivo ou clique para selecionar. O Brainchat lê o arquivo no navegador (sem upload imediato) e mostra um preview das primeiras linhas.

**3. Revisar schema inferido**

Para cada coluna detectada, o sistema sugere:

* **Nome** (slug gerado a partir do cabeçalho)
* **Tipo inferido** — você pode trocar manualmente se quiser
* **Obrigatória** e **pesquisável** — marque se aplicável

### Inferência automática de tipos

O Brainchat analisa até 50 amostras por coluna e usa os seguintes padrões:

| Tipo detectado | Critério |
| - | - |
| **Boolean** | Valores como `true`, `false`, `sim`, `não`, `1`, `0` |
| **CPF** | 11 dígitos ou `xxx.xxx.xxx-xx` |
| **CNPJ** | 14 dígitos ou `xx.xxx.xxx/xxxx-xx` |
| **E-mail** | Padrão `usuario@dominio.tld` |
| **URL** | Começa com `http://` ou `https://` |
| **Telefone** | 10–13 dígitos, aceita `+`, `()`, `-` |
| **Moeda** | Prefixo `R$`, `$` ou `USD` |
| **Número** | Convertível para `Number` |
| **Data** | `AAAA-MM-DD` ou `DD/MM/AAAA` |
| **Hora** | `HH:MM` ou `HH:MM:SS` |
| **Texto** | Padrão (qualquer outro caso) |

O critério de detecção é **80% das amostras** corresponderem ao padrão.

**4. Configurar nome e ID**

* Defina o **nome da tabela** e a **descrição**
* Escolha a **coluna de ID** (ou ative `auto_id` para gerar automaticamente)
* Defina **label** e **value**

**5. Importar**

Confirme. O Brainchat cria a tabela e insere todos os registros. O progresso aparece em tempo real.

***

## Atualizar uma tabela existente via CSV

Você também pode importar um CSV em uma tabela já existente para:

* **Adicionar novos registros** ao final
* **Atualizar registros existentes** (com base em uma coluna-chave que você escolhe — geralmente o ID)

Para importar numa tabela que já existe, use **Baixar modelo desta tabela** (um .xlsx com as colunas da tabela), preencha e envie. No diálogo, ligue cada **Coluna do arquivo** a uma **Coluna da tabela** e escolha a **Coluna-chave (para identificar registros existentes)**. Para cada linha, o resumo mostra se ela vai **Criar**, **Atualizar** ou **Ignorar**. Se algo estiver errado, nada é gravado: corrija o arquivo e envie de novo.

***

## Limites

* Tamanho máximo do arquivo: **10 MB**
* Recomendado: até **50 mil linhas** por importação
* Para volumes maiores, importe em lotes ou use a [API genérica](https://docs.brainchat.app/insights/tabelas/api.md)

***

## Próximo passo

> [card] [Conectar via API](https://docs.brainchat.app/insights/tabelas/api.md)
>
> Para dados que mudam com frequência, conecte uma fonte automática.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.