> ## 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
> Consulta tus datos de Treble casi en tiempo real con SQL — historia completa, mayor detalle y un contrato de nombres estable.
# Analytics Warehouse
El Analytics Warehouse es la nueva generación de la plataforma de datos de Treble. Te da acceso SQL directo a tus datos operacionales con **frescura casi en tiempo real**, **historia completa** y varios datasets que antes no estaban disponibles — incluyendo la traza completa de mensajes de cada conversación y el recorrido nodo a nodo de cada flujo.
El Analytics Warehouse reemplaza al Data Warehouse anterior (`client_analytics`), que ahora está **deprecado**. Ambos permanecen disponibles durante el periodo de migración. Si estás migrando queries existentes, comienza por la [Guía de Migración](/es/docs/data-warehouse-v2/migration-guide).
## ¿Qué hay de nuevo?
| | Warehouse anterior | Analytics Warehouse |
| ------------------------------ | ------------------ | ----------------------------------- |
| **Frescura** | Hasta 3 horas | **\~15 minutos** |
| **Historia** | Últimos 3 meses | **Historia completa** |
| **Mensajes de conversaciones** | No disponible | Traza completa, mensaje a mensaje |
| **Recorrido por el flujo** | No disponible | Paso a paso, incluyendo pasos de IA |
| **Variables de sesión** | No disponible | Disponible |
| **Atribución de anuncios** | No disponible | Anuncio Click-to-WhatsApp → sesión |
| **Sincronización incremental** | No soportada | Watermark `synced_at` en cada fila |
## Conexión
Una vez habilitado el acceso, recibirás credenciales para conectarte:
| Parámetro | Valor |
| ----------------- | ------------------------------------ |
| **Host** | Proporcionado por Treble |
| **Puerto** | `8443` (HTTPS) / `9440` (Native TLS) |
| **Base de datos** | `treble_client_analytics` |
| **Usuario** | Proporcionado por Treble |
| **Contraseña** | Proporcionada por Treble |
Puedes usar cualquier cliente compatible con ClickHouse: DBeaver, DataGrip, `clickhouse-client`, o conectar directamente desde Metabase, Looker, Power BI, Google Sheets u otra herramienta de BI.
El acceso está disponible para empresas que soliciten el onboarding. Contacta a tu Account Manager o a soporte para iniciar el proceso.
## El contrato de datos
Tres promesas definen cómo se comporta el warehouse. Entenderlas te ahorrará tiempo:
1. **Los datos son casi en tiempo real.** Las sesiones, mensajes y envíos de campaña nuevos aparecen a los pocos minutos de ocurrir.
2. **Hoy es provisional; la historia es definitiva.** Los datos operacionales siguen cambiando mientras están en curso — un envío de campaña que está "en proceso" a las 10:00 puede estar "entregado" a las 11:00, tanto en Treble como en tu warehouse. Las cifras de cualquier día **se consolidan por completo dentro de 48 horas**, y el warehouse se autocorrige continuamente (cada 30 minutos) durante esa ventana. Los datos históricos más allá de esa ventana son inmutables.
3. **Cada fila te dice cuándo llegó.** Todas las tablas exponen una columna `synced_at`: el momento en que la fila (o su última corrección) fue escrita. Esto habilita la [sincronización incremental](/es/docs/data-warehouse-v2/incremental-sync) confiable hacia tus propios sistemas.
## Glosario de nombres
El warehouse usa un mismo vocabulario consistente en todas las tablas:
| Término | Significado |
| ----------------------- | ------------------------------------------------------------------------------------ |
| `poll_id` / `poll_name` | Un flujo conversacional (lo que construyes en el editor de flujos de Treble). |
| `session_id` | Una ejecución de un flujo por un usuario — una conversación. |
| `direction` | `INBOUND` si el usuario inició la conversación, `OUTBOUND` si la inició una campaña. |
| `agent_conversation_id` | Una conversación atendida en el espacio de trabajo de agentes (Sales). |
| `treble_id` | La identidad telefónica del contacto: código de país + celular. |
| `synced_at` | Cuándo se escribió o corrigió por última vez esta fila en el warehouse. |
## Seguridad y límites
* **Seguridad a nivel de fila:** tus credenciales solo pueden ver las filas de tu empresa — lo garantiza la base de datos en cada tabla y en cada consulta.
* **Solo lectura:** tu usuario no puede modificar, crear ni eliminar nada.
* **Límites de protección:** las consultas tienen un tope de ejecución de 30 segundos y límites de filas y memoria que mantienen la plataforma estable para todos. Revisa [Optimización de Consultas](/es/docs/data-warehouse-v2/query-optimization) para mantenerte holgadamente dentro de ellos.
## Tablas disponibles
### Flujos Conversacionales
Todo lo que ocurre dentro de tus flujos automatizados.
| Tabla | Granularidad | ¿Qué contiene? |
| ------------------------------------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------ |
| [`fact_treble_sessions`](/es/docs/data-warehouse-v2/fact-treble-sessions) | 1 fila por flujo conversacional | Cada ejecución de un flujo, inbound y outbound |
| [`fact_treble_session_messages`](/es/docs/data-warehouse-v2/fact-treble-session-messages) | 1 fila por mensaje | La traza completa de la conversación |
| [`fact_treble_session_nodes`](/es/docs/data-warehouse-v2/fact-treble-session-nodes) | 1 fila por paso interactivo | El recorrido por el flujo — preguntas, pasos de IA, WhatsApp Flows |
| [`fact_treble_session_variables`](/es/docs/data-warehouse-v2/fact-treble-session-variables) | 1 fila por variable | Variables capturadas durante cada flujo |
### Campañas
Envíos outbound y cómo interactúan los usuarios con ellos.
| Tabla | Granularidad | ¿Qué contiene? |
| ----------------------------------------------------------------------- | -------------------------- | -------------------------------------------------------------------- |
| [`fact_campaign_sends`](/es/docs/data-warehouse-v2/fact-campaign-sends) | 1 fila por envío | Cada mensaje outbound de campaña, con el detalle completo de entrega |
| [`fact_campaign_daily`](/es/docs/data-warehouse-v2/fact-campaign-daily) | 1 fila por campaña por día | Agregado diario de entregas |
| [`fact_hsm_responses`](/es/docs/data-warehouse-v2/fact-hsm-responses) | 1 fila por respuesta | Respuestas dadas a las plantillas HSM |
### Espacio de Trabajo de Agentes
Operación de agentes humanos: conversaciones, mensajes, transferencias, disponibilidad, productividad.
| Tabla | Granularidad | ¿Qué contiene? |
| --------------------------------------------------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------ |
| [`fact_agent_conversations`](/es/docs/data-warehouse-v2/fact-agent-conversations) | 1 fila por conversación de agente | Conversaciones atendidas en el espacio de trabajo de agentes |
| [`fact_agent_conversation_messages`](/es/docs/data-warehouse-v2/fact-agent-conversation-messages) | 1 fila por mensaje | Mensajes dentro de las conversaciones de agente |
| [`fact_agent_conversation_transfers`](/es/docs/data-warehouse-v2/fact-agent-conversation-transfers) | 1 fila por transferencia | Transferencias entre agentes |
| [`fact_agent_status_changes`](/es/docs/data-warehouse-v2/fact-agent-status-changes) | 1 fila por cambio | Historial de disponibilidad de los agentes |
| [`fact_agent_daily`](/es/docs/data-warehouse-v2/fact-agent-daily) | 1 fila por agente por día | Productividad diaria por agente |
### Conversiones y Atribución
De dónde vienen las conversaciones y qué logran.
| Tabla | Granularidad | ¿Qué contiene? |
| ----------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------- |
| [`fact_target_events`](/es/docs/data-warehouse-v2/fact-target-events) | 1 fila por evento | Eventos de conversión/objetivo disparados en los flujos |
| [`fact_ad_sessions`](/es/docs/data-warehouse-v2/fact-ad-sessions) | 1 fila por sesión atribuida a un anuncio | Atribución de anuncios Click-to-WhatsApp |
| [`fact_whatsapp_link_events`](/es/docs/data-warehouse-v2/fact-whatsapp-link-events) | 1 fila por evento | Clics en links de WhatsApp e inicios de conversación |
### Dimensiones — catálogos para enriquecer
Agentes, tags, equipos, plantillas HSM, asignaciones agente-tag, flujos (polls), canales de WhatsApp y nodos de flujo (incluyendo la configuración de agentes de IA). Consulta [Dimensiones](/es/docs/data-warehouse-v2/dimensions).