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

# Tabelas do Sistema

> Tabelas virtuais que espelham dados nativos do Brainchat — Contatos, Conversas e Envios de Formulário.

# 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

| Tabela                   | Fonte real           | Conteúdo                                                                     |
| ------------------------ | -------------------- | ---------------------------------------------------------------------------- |
| **Contatos**             | `contacts`           | Todos os contatos da instância (nome, telefone, e-mail, origem, tags, etc.)  |
| **Conversas**            | `chat_conversations` | Histórico de conversas (status, atribuição, datas, primeira/última mensagem) |
| **Envios de Formulário** | `lead_submissions`   | Cada submissão de formulário de captura                                      |

***

## Características

| Característica   | Comportamento                                             |
| ---------------- | --------------------------------------------------------- |
| **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](/dados/dashboards-modelos).

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

<Warning>
  Tabelas do sistema **não aceitam edição direta**. Para alterar um contato ou conversa, use as telas dedicadas (Contatos, Live Chat).
</Warning>

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

***

## Próximo passo

<Card title="Visão geral de Dashboards" icon="chart-line" href="/dados/dashboards">
  Aprenda a transformar suas tabelas em dashboards visuais.
</Card>