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.
Data Warehouse
Treble pone a disposición un Data Warehouse que te permite consultar directamente tus datos operacionales con SQL. Esto te da la flexibilidad de construir reportes personalizados, conectar herramientas de BI y analizar tus datos sin depender del equipo de Treble.El acceso al Data Warehouse está disponible únicamente para empresas que soliciten el onboarding. Si estás interesado, contacta a tu Account Manager o escríbenos a soporte para iniciar el proceso.
¿Qué puedes consultar?
- Historial de conversaciones atendidas por tus agentes
- Mensajes enviados y recibidos en cada conversación
- Transferencias entre agentes
- Disponibilidad y tiempos de conexión de agentes
- Productividad diaria por agente
- Detalle y métricas de envíos de campañas outbound
- Sesiones inbound y outbound
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 | client_analytics |
| Usuario | Proporcionado por Treble |
| Contraseña | Proporcionada por Treble |
clickhouse-client, o conectar directamente desde Google Sheets, Metabase, Looker u otra herramienta de BI.
Seguridad y Límites
- Datos seguros: Tus datos están protegidos por políticas de privacidad. Solo tu compañía puede acceder a la información de tu cuenta.
- Solo lectura: Tu usuario no puede modificar, crear ni eliminar datos.
- Límites de protección: Las consultas tienen un tiempo máximo de 30 segundos y límites de filas y memoria para garantizar la estabilidad del sistema.
Frecuencia de Actualización
- Los datos tienen un retraso máximo de 3 horas respecto a la operación en tiempo real.
- Las tablas contienen datos de los últimos 3 meses.
- Algunas tablas (dimensiones de agentes, equipos, tags) pueden tener una frecuencia de actualización mayor, cercana a los 10 minutos.
Buenas Prácticas
Para escribir consultas eficientes y aprovechar al máximo la estructura columnar de ClickHouse, revisa la guía de Optimización de Consultas.Tablas Disponibles
Tablas de hechos (facts)
Contienen los eventos y transacciones de tu operación.| Tabla | ¿Qué responde? | Granularidad |
|---|---|---|
fact_conversations | ¿Cuántas conversaciones se atendieron? ¿Por quién? ¿Cuánto duraron? | 1 fila por conversación |
fact_agent_messages | ¿Qué se dijo en cada conversación? ¿Quién envió cada mensaje? | 1 fila por mensaje |
fact_redirections | ¿Cuántas transferencias hubo? ¿De quién a quién? | 1 fila por transferencia |
fact_agent_status_changes | ¿Cuándo se conectaron y desconectaron los agentes? | 1 fila por cambio de estado |
fact_agent_daily | ¿Cuál fue la productividad de cada agente por día? | 1 fila por agente por día |
fact_sessions | ¿Cuántas sesiones tuvo la campaña? ¿Inbound o outbound? | 1 fila por sesión |
fact_deployment_status | ¿Cuál fue el resultado de cada envío outbound? | 1 fila por envío |
fact_deployment_daily | ¿Cuántos envíos por campaña por día? ¿Tasa de entrega y respuesta? | 1 fila por campaña por día |
fact_hsm_responses | ¿Qué respondieron los usuarios a las plantillas HSM? | 1 fila por respuesta |
fact_target_events | ¿Qué objetivos de conversión se cumplieron? (Próximamente) | 1 fila por objetivo cumplido |
Tablas de dimensiones (dims)
Contienen información de referencia que puedes cruzar con las tablas de hechos.| Tabla | Descripción |
|---|---|
dim_agents | Agentes: nombre, email, estado activo/inactivo |
dim_tags | Colas o tags de asignación |
dim_teams | Equipos de trabajo |
dim_hsm | Plantillas HSM (templates de WhatsApp) |
dim_agent_tags | Relación agente ↔ tag ↔ equipo |