> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Analytics Warehouse
> Consulte seus dados da Treble quase em tempo real com SQL — histórico completo, mais detalhe e um contrato de nomenclatura estável.
# Analytics Warehouse
O Analytics Warehouse é a nova geração da plataforma de dados da Treble. Ele te dá acesso SQL direto aos seus dados operacionais com **atualização quase em tempo real**, **histórico completo** e vários datasets que nunca estiveram disponíveis antes — incluindo o rastro completo de mensagens de cada conversa e o percurso nó a nó de cada fluxo.
O Analytics Warehouse substitui o Data Warehouse anterior (`client_analytics`), que agora está **descontinuado**. Ambos permanecem disponíveis durante o período de migração. Se você está migrando queries existentes, comece pelo [Guia de Migração](/pt/docs/data-warehouse-v2/migration-guide).
## O que há de novo
| | Warehouse anterior | Analytics Warehouse |
| ----------------------------- | ------------------ | ------------------------------------- |
| **Atualização** | Até 3 horas | **\~15 minutos** |
| **Histórico** | Últimos 3 meses | **Histórico completo** |
| **Mensagens das conversas** | Não disponível | Rastro completo, mensagem a mensagem |
| **Percurso pelo fluxo** | Não disponível | Etapa a etapa, incluindo etapas de IA |
| **Variáveis de sessão** | Não disponível | Disponível |
| **Atribuição de anúncios** | Não disponível | Anúncio Click-to-WhatsApp → sessão |
| **Sincronização incremental** | Não suportada | Watermark `synced_at` em cada linha |
## Conexão
Uma vez habilitado o acesso, você receberá credenciais para se conectar:
| Parâmetro | Valor |
| ------------------ | ------------------------------------ |
| **Host** | Fornecido pela Treble |
| **Porta** | `8443` (HTTPS) / `9440` (Native TLS) |
| **Banco de dados** | `treble_client_analytics` |
| **Usuário** | Fornecido pela Treble |
| **Senha** | Fornecida pela Treble |
Você pode usar qualquer cliente compatível com ClickHouse: DBeaver, DataGrip, `clickhouse-client`, ou conectar diretamente a partir de Metabase, Looker, Power BI, Google Sheets ou outra ferramenta de BI.
O acesso está disponível para empresas que solicitarem o onboarding. Entre em contato com seu Account Manager ou com o suporte para iniciar o processo.
## O contrato de dados
Três promessas definem como o warehouse se comporta. Entendê-las vai te poupar tempo:
1. **Os dados são quase em tempo real.** Novas sessões, mensagens e envios de campanha aparecem minutos depois de acontecerem.
2. **Hoje é provisório; o histórico é definitivo.** Os dados operacionais continuam mudando enquanto estão em andamento — um envio de campanha que está "em processamento" às 10:00 pode estar "entregue" às 11:00, tanto na Treble quanto no seu warehouse. Os números de qualquer dia **se consolidam completamente em até 48 horas**, e o warehouse se autocorrige continuamente (a cada 30 minutos) durante essa janela. Os dados históricos além dessa janela são imutáveis.
3. **Cada linha te diz quando chegou.** Todas as tabelas expõem uma coluna `synced_at`: o momento em que a linha (ou sua correção mais recente) foi gravada. É isso que viabiliza a [sincronização incremental](/pt/docs/data-warehouse-v2/incremental-sync) confiável para os seus próprios sistemas.
## Glossário de nomenclatura
O warehouse usa um vocabulário consistente em todas as tabelas:
| Termo | Significado |
| ----------------------- | ---------------------------------------------------------------------------- |
| `poll_id` / `poll_name` | Um fluxo conversacional (o que você constrói no editor de fluxos da Treble). |
| `session_id` | Uma execução de um fluxo por um usuário — uma conversa. |
| `direction` | `INBOUND` se o usuário iniciou a conversa, `OUTBOUND` se foi uma campanha. |
| `agent_conversation_id` | Uma conversa atendida no workspace de agentes (Sales). |
| `treble_id` | A identidade telefônica do contato: código do país + celular. |
| `synced_at` | Quando esta linha foi gravada ou corrigida pela última vez no warehouse. |
## Segurança e limites
* **Segurança em nível de linha:** suas credenciais só conseguem ver as linhas da sua empresa — garantido pelo banco de dados em todas as tabelas, em todas as consultas.
* **Somente leitura:** seu usuário não pode modificar, criar nem excluir nada.
* **Limites de proteção:** as consultas têm um tempo máximo de execução de 30 segundos e limites de linhas e memória que mantêm a plataforma estável para todos. Consulte [Otimização de Consultas](/pt/docs/data-warehouse-v2/query-optimization) para saber como se manter bem dentro deles.
## Tabelas disponíveis
### Fluxos de Conversa
Tudo o que acontece dentro dos seus fluxos automatizados.
| Tabela | Granularidade | O que contém |
| ------------------------------------------------------------------------------------------- | ----------------------------- | --------------------------------------------------------------- |
| [`fact_treble_sessions`](/pt/docs/data-warehouse-v2/fact-treble-sessions) | 1 linha por fluxo de conversa | Cada execução de fluxo, inbound e outbound |
| [`fact_treble_session_messages`](/pt/docs/data-warehouse-v2/fact-treble-session-messages) | 1 linha por mensagem | O rastro completo da conversa |
| [`fact_treble_session_nodes`](/pt/docs/data-warehouse-v2/fact-treble-session-nodes) | 1 linha por etapa interativa | O percurso pelo fluxo — perguntas, etapas de IA, WhatsApp Flows |
| [`fact_treble_session_variables`](/pt/docs/data-warehouse-v2/fact-treble-session-variables) | 1 linha por variável | Variáveis capturadas durante cada fluxo |
### Campanhas
Envios outbound e como os usuários interagem com eles.
| Tabela | Granularidade | O que contém |
| ----------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------------------- |
| [`fact_campaign_sends`](/pt/docs/data-warehouse-v2/fact-campaign-sends) | 1 linha por envio | Cada mensagem outbound de campanha, com todo o detalhe de entrega |
| [`fact_campaign_daily`](/pt/docs/data-warehouse-v2/fact-campaign-daily) | 1 linha por campanha por dia | Consolidado diário de entregas |
| [`fact_hsm_responses`](/pt/docs/data-warehouse-v2/fact-hsm-responses) | 1 linha por resposta | Respostas dadas aos templates HSM |
### Workspace de Agentes
Operações com agentes humanos: conversas, mensagens, transferências, disponibilidade, produtividade.
| Tabela | Granularidade | O que contém |
| --------------------------------------------------------------------------------------------------- | ------------------------------ | ------------------------------------------- |
| [`fact_agent_conversations`](/pt/docs/data-warehouse-v2/fact-agent-conversations) | 1 linha por conversa de agente | Conversas atendidas no workspace de agentes |
| [`fact_agent_conversation_messages`](/pt/docs/data-warehouse-v2/fact-agent-conversation-messages) | 1 linha por mensagem | Mensagens dentro das conversas de agentes |
| [`fact_agent_conversation_transfers`](/pt/docs/data-warehouse-v2/fact-agent-conversation-transfers) | 1 linha por transferência | Transferências entre agentes |
| [`fact_agent_status_changes`](/pt/docs/data-warehouse-v2/fact-agent-status-changes) | 1 linha por mudança | Histórico de disponibilidade dos agentes |
| [`fact_agent_daily`](/pt/docs/data-warehouse-v2/fact-agent-daily) | 1 linha por agente por dia | Produtividade diária dos agentes |
### Conversões e Atribuição
De onde vêm as conversas e o que elas alcançam.
| Tabela | Granularidade | O que contém |
| ----------------------------------------------------------------------------------- | -------------------------------------- | --------------------------------------------------- |
| [`fact_target_events`](/pt/docs/data-warehouse-v2/fact-target-events) | 1 linha por evento | Eventos de conversão/objetivo disparados nos fluxos |
| [`fact_ad_sessions`](/pt/docs/data-warehouse-v2/fact-ad-sessions) | 1 linha por sessão atribuída a anúncio | Atribuição de anúncios Click-to-WhatsApp |
| [`fact_whatsapp_link_events`](/pt/docs/data-warehouse-v2/fact-whatsapp-link-events) | 1 linha por evento | Cliques em links de WhatsApp e inícios de conversa |
### Dimensões — catálogos para enriquecimento
Agentes, tags, equipes, templates HSM, atribuições agente-tag, fluxos, canais de WhatsApp e nós de fluxo (incluindo a configuração de agentes de IA). Consulte [Dimensões](/pt/docs/data-warehouse-v2/dimensions).