Skip to main content

​
Tabelas do Sistema

As Tabelas do Sistema são tabelas virtuais que existem dentro do ecossistema de tabelas customizadas, mas leem dados de outras fontes do Brainchat (contatos, conversas, envios). São criadas automaticamente quando uma instância é provisionada.

​
Tabelas disponíveis

TabelaFonte realConteúdo
ContatoscontactsTodos os contatos da instância (nome, telefone, e-mail, origem, tags, etc.)
Conversaschat_conversationsHistórico de conversas (status, atribuição, datas, primeira/última mensagem)
Envios de Formuláriolead_submissionsCada submissão de formulário de captura

​
Características

CaracterísticaComportamento
Editáveis?❌ Não — você não adiciona/remove registros pela interface
Excluíveis?❌ Não — são parte da infraestrutura
Schema fixo?✅ Sim — colunas seguem o modelo nativo
Atualizadas?✅ Sim — em tempo real, refletem o estado atual
Quota?✅ Sim — mostram contagem real no card
Essas tabelas aparecem na seção “Tabelas do Sistema” da página de Tabelas.

​
Casos de uso

​
1. Fonte de dashboards

Use as tabelas do sistema para construir dashboards sem precisar duplicar dados:
  • KPI de total de contatos
  • Evolução de novos contatos por dia/semana/mês
  • Ranking de contatos por número de conversas
  • Distribuição por origem (UTM, formulário, importação)
O modelo pronto “Visão Geral de Contatos” já vem configurado usando essas tabelas — veja Modelos prontos de dashboard.

​
2. Conhecimento para o Agente de IA

Marque tabelas do sistema como fonte consultável do Agente de IA. Exemplo:
  • “Quem são os 10 últimos contatos cadastrados?”
  • “Quantas conversas estão abertas hoje?”
  • “Mostre o histórico do contato com telefone X”
O agente consulta a tabela em tempo real durante a conversa.

​
3. Filtros e segmentações

Use as colunas das tabelas do sistema em filtros de dashboards: created_at, source, utm_campaign, is_archived, etc.

​
Limites e diferenças

Tabelas do sistema não aceitam edição direta. Para alterar um contato ou conversa, use as telas dedicadas (Contatos, Live Chat).
Embora não sejam editáveis, tabelas do sistema podem ser referenciadas por colunas de Conexão em tabelas customizadas. Ex: criar uma tabela “Pedidos” com uma coluna que conecta cada pedido a um contato existente.

​
Próximo passo

Visão geral de Dashboards

Aprenda a transformar suas tabelas em dashboards visuais.