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

# Criar tabela manualmente

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

<Steps>
  <Step title="Abrir Tabelas">
    Acesse **Dados → Tabelas** (`/u/leads/tables`) e clique em **Nova Tabela → Manualmente**.
  </Step>

  <Step title="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."
  </Step>

  <Step title="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](/dados/tabelas-colunas)
    * **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.
    </Tip>
  </Step>

  <Step title="Escolher a coluna de ID">
    Defina como cada registro será identificado de forma única:

    * **ID automático (UUID)** — 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.
  </Step>

  <Step title="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".
  </Step>

  <Step title="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).
    </Warning>
  </Step>

  <Step title="Salvar e adicionar registros">
    Após salvar, a tabela abre o **grid de registros**. Clique em **Adicionar registro** para começar a popular os dados, ou edite cada célula direto na tela.
  </Step>
</Steps>

***

## Gerenciar registros

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.
</Tip>

***

## Próximo passo

<Card title="Importar via CSV/Excel" icon="file-arrow-up" href="/dados/tabelas-csv">
  Tem dados em planilha? Suba o arquivo e o Brainchat cria o schema automaticamente.
</Card>