> ## 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.

# Criar tabela manualmente

> Defina o schema da tabela do zero e adicione registros diretamente pela interface.

A criação manual é ideal quando você sabe exatamente quais colunas precisa e vai inserir os dados pelo painel ou via formulário.

***

## Passo a passo

**1. Abrir Tabelas**

Acesse **Insights → Tabelas** e clique em **Nova Tabela → Criar manualmente**.

**2. Definir nome e descrição**

* **Nome** — identificação curta da tabela (ex: "Catálogo de Produtos")
* **Descrição** — usada pelo Agente de IA para entender quando consultar a tabela. Capriche aqui.

Exemplo de boa descrição:

> "Lista oficial de produtos disponíveis para venda, com SKU, preço, estoque e descrição detalhada."

**3. Adicionar colunas**

Clique em **Adicionar coluna** para cada campo que a tabela terá:

* **Nome da coluna** — em português normal (ex: "Preço de venda")
* **Tipo** — escolha entre os [21 tipos disponíveis](https://docs.brainchat.app/insights/tabelas/colunas.md)
* **Obrigatória** — marque se o campo não pode ficar vazio
* **Pesquisável** — marque se quer que esse campo entre na busca textual

> [!TIP]
>
> Use o ícone de arrastar (⋮⋮) para reordenar as colunas. A ordem aqui é a ordem em que aparecem no grid.

**4. Escolher a coluna de ID**

Defina como cada registro será identificado de forma única:

* **Gerar ID automaticamente** — adicione uma coluna do tipo `auto_id`. O sistema gera o ID. Use quando você não tem um identificador próprio.
* **Manual** — escolha uma coluna existente (ex: SKU, código). Use quando seus registros já têm um identificador único.

**5. Configurar Label e Value**

Defina quais colunas serão usadas como **label** (texto exibido) e **value** (valor enviado em integrações).

Exemplo: numa tabela de unidades, label = "Nome da unidade" e value = "código da unidade".

**6. Privacidade**

* **Privada** — acessível apenas pelo painel e pela API autenticada
* **Pública** — pode ser consultada externamente sem autenticação

> [!WARNING]
>
> Não marque como Pública tabelas que contenham dados sensíveis de clientes (CPF, e-mails, telefones).

**7. Salvar e adicionar registros**

Após salvar, a tabela abre o **grid de registros**. Clique em **Novo Registro** para começar a popular os dados, ou edite cada célula direto na tela.

***

## Gerenciar registros

![Tabela Contatos CRM com Novo Registro, Editar, Importar, busca, Colunas e Adicionar filtro](https://mintcdn.com/stegia/gqRqm3rIoPM4XJCc/images/insights/tabela-registros.png?fit=max\&auto=format\&n=gqRqm3rIoPM4XJCc\&q=85\&s=f8f2ce565825a9ec06e18eac8cfe8da8)

Registros de uma tabela, com busca, colunas e filtros

No grid da tabela você pode:

* **Adicionar** registros um a um
* **Editar** células diretamente (basta clicar)
* **Excluir** um ou vários registros
* **Buscar** texto em colunas marcadas como pesquisáveis
* **Filtrar** por qualquer coluna
* **Ordenar** por qualquer coluna
* **Exportar** para CSV

***

## Editar schema depois

Você pode adicionar, remover ou renomear colunas a qualquer momento clicando em **Configurar tabela** no menu da tabela. Mudanças preservam os dados existentes — colunas removidas mantêm os valores no banco mas deixam de aparecer no grid.

> [!TIP]
>
> Mudar o **tipo** de uma coluna que já tem dados pode causar perda de informação. Faça um backup (exportar CSV) antes.

***

## Próximo passo

> [card] [Importar via CSV/Excel](https://docs.brainchat.app/insights/tabelas/importar-csv.md)
>
> Tem dados em planilha? Suba o arquivo e o Brainchat cria o schema automaticamente.


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