Skip to main content

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

1

Abrir Tabelas

Acesse Dados → Tabelas (/u/leads/tables) e clique em Nova Tabela → 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
  • Obrigatória — marque se o campo não pode ficar vazio
  • Pesquisável — marque se quer que esse campo entre na busca textual
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:
  • 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.
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
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 Adicionar registro para começar a popular os dados, ou edite cada célula direto na tela.

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

Importar via CSV/Excel

Tem dados em planilha? Suba o arquivo e o Brainchat cria o schema automaticamente.