Inicio Informes y datos | Métricas, exportaciones y Constructor Explicación de las tablas y columnas del Constructor de Reportes (Report Builder) — Tópicos ClaudIA y Cloud Chat

Explicación de las tablas y columnas del Constructor de Reportes (Report Builder) — Tópicos ClaudIA y Cloud Chat

Última actualización el Jul 22, 2026

Cuándo usar

  • Estás armando un reporte en los nuevos reportes y necesitas entender qué tablas y columnas están disponibles en los tópicos ClaudIA y Cloud Chat

  • Quieres entender qué significa cada campo antes de usarlo en un análisis

  • Necesitas identificar la tabla correcta para un análisis específico (conversaciones, mensajes, CSAT, campañas, métricas de agentes y equipos)

Sobre este artículo

Referencia rápida de las tablas y columnas del nuevo módulo de reportes, organizadas por tópico:

  • Tópico ClaudIA — datos de las conversaciones atendidas por ClaudIA (IA): conversaciones, mensajes, respuestas generadas, feedbacks de auditoría, CSAT y contenidos de la base de conocimiento

  • Tópico Cloud Chat — datos operativos de Cloud Chat: conversaciones, primeras respuestas, CSAT, tags, contactos, envíos activos (campañas) y métricas diarias de agentes y equipos

Las columnas terminadas en Sk son claves internas para relacionar las tablas entre sí — no se listan abajo. La columna Etl Updated At, presente en varias tablas, indica la última actualización del registro en el data lake.

Tópico ClaudIA

1. claudia_conversation

Tabla principal de las conversaciones atendidas por ClaudIA. Cada fila es una conversación.

Columna Descripción
Cloudchat Id ID (UUID) de la conversación en ClaudIA — es el enlace con la columna Conversation Uuid de Cloud Chat
Helpdesk Id ID del ticket en el helpdesk integrado (ej.: Zendesk)
Creation Date / Update Date / Close Date Fechas de creación, actualización y cierre
Status Class Estado de la conversación
Is N2 Flag Si la conversación fue escalada a atención humana (N2)
Resolution Level Class Nivel en el que se resolvió la conversación (N1 = IA, N2 = humano)
Conversation Id ID interno de la conversación
Project Name Proyecto (cliente) al que pertenece la conversación
Application Identifier Class Canal/aplicación de origen de la conversación
Low Confidence Count Value Respuestas con baja confianza en la conversación
Enlightenment Question Count Value Preguntas de aclaración hechas por la IA
Resolution Retries Count Value Intentos de resolución
Problem Resolved Question Sent Count Value Cuántas veces la IA preguntó si el problema fue resuelto
Unanswered Ticket Escalator Count Value Escalamientos por falta de respuesta del cliente
Activeintent Class Intención activa identificada en la conversación
Active Flow Id / Active Flow Session Id Flujo (Eddie) activo y sesión del flujo
Problem Solved Flag Si el cliente confirmó que el problema fue resuelto
Resolution Reason Motivo de resolución/cierre
Resolution Reason Refined Motivo de resolución refinado (versión normalizada)
Tag Name Tag asignada a la conversación
Ab Key Name Clave del test A/B en el que participó la conversación
Gencx Value Nota GenCX — evaluación automática de la calidad de la experiencia
Gencx Reasoning Text Justificación de la nota GenCX
Frustration Score Value / Frustration Class Score y clasificación de frustración del cliente
Frustration Reasoning Text Justificación de la clasificación de frustración
Frustration Score Update Date Cuándo se actualizó el score de frustración
Has Rate Limit Error Flag Si hubo un error de límite de solicitudes en la conversación

2. claudia_messages

Todos los mensajes intercambiados en las conversaciones de ClaudIA.

Columna Descripción
Message Id ID del mensaje
Project Name Proyecto (cliente)
Cloudchat Id Conversación a la que pertenece el mensaje
Sender Role Quién lo envió (cliente, IA o agente)
Content Text Contenido del mensaje
Send At Fecha y hora de envío
Private Flag Si es una nota privada (no visible para el cliente)
Message Type Tipo del mensaje
Originated From Answer / Originated From Action Respuesta o acción que originó el mensaje
Originated From Enlightenment Limit Flag Si fue originado por el límite de preguntas de aclaración
Originated From User Query Pregunta del cliente que originó el mensaje
Originated From Class Clasificación del origen
Media Class Tipo de medio (texto, imagen, audio, etc.)

3. claudia_prompt_revision

Cada fila es una respuesta generada por la IA — útil para analizar el comportamiento de ClaudIA respuesta por respuesta.

Columna Descripción
Prompt Revision Id ID de la respuesta generada
Cloudchat Id Conversación a la que pertenece la respuesta
Project Name Proyecto (cliente)
Application Identifier Canal/aplicación de origen
Response Action Class Acción decidida por la IA (responder, escalar, retener, etc.)
Enlightenment Limit Reached Flag Si se alcanzó el límite de preguntas de aclaración
Originated From User Query Pregunta del cliente que originó la respuesta
Response Class Clasificación de la respuesta
Created At / Updated At Creación y actualización
Response Raw Final Answer Respuesta final generada por la IA
Conversation Active Flow Id / Conversation Active Session Id Flujo (Eddie) y sesión activos en el momento de la respuesta
Response Bot Flow Id / Response Bot Session Id Flujo y sesión accionados por la respuesta
Response Used Content Id Contenido principal de la base de conocimiento usado en la respuesta
Response Used Content Id 1/2/3 Demás contenidos considerados en la respuesta
Clarification Content Id 1/2/3 Contenidos usados en preguntas de aclaración
Response Model Reasoning Razonamiento del modelo al generar la respuesta
Response Error Message Mensaje de error, cuando la generación falló
Frustration Score / Frustration Label / Frustration Reasoning Text Frustración del cliente en el momento de la respuesta

4. claudia_conversation_feedback

Feedbacks de auditoría de las conversaciones de ClaudIA (evaluaciones de calidad).

Columna Descripción
Conversation Feedback Id ID del feedback
Cloudchat Id Conversación evaluada
Project Name Proyecto (cliente)
Client Problem Solved Flag Si el evaluador consideró el problema resuelto
General Feedback Text Feedback general sobre la conversación
Error Impact Value Impacto del error identificado (nota)
Conversation Properly Closed Flag Si la conversación se cerró correctamente
Conversation Should Scaled To N2 Flag Si debería haber sido escalada a N2
Conversation Should Resolved N1 Flag Si debería haber sido resuelta en el N1
Is Tag Correct Flag / Right Tag Name Si la tag es correcta y la tag sugerida
Created By Autor del feedback
Created At / Updated At Creación y actualización

5. claudia_csat

Respuestas de CSAT de las conversaciones atendidas por ClaudIA.

Columna Descripción
Csat Id ID de la encuesta
Project Name Proyecto (cliente)
Cloudchat Id Conversación asociada
Helpdesk Id Ticket en el helpdesk integrado
Csat Raw Value Valor bruto de la respuesta del cliente
Csat Value Nota numérica
Comment Text Comentario del cliente
Creation Date / Collect Date Creación de la encuesta y recolección de la respuesta

6. claudia_contents

Contenidos de la base de conocimiento de ClaudIA.

Columna Descripción
Content Id ID del contenido
Project Name Proyecto (cliente)
Content Title / Content Text / Content Response Text Título, texto y respuesta del contenido
Tag Name Tag aplicada cuando se usa el contenido
Is N2 Flag Si el contenido dirige la conversación a N2
Topic Name Tópico del contenido
Content Type Tipo del contenido
Flow Id Flujo (Eddie) accionado por el contenido, cuando aplica
Source Metadata Class Origen del contenido
Draft Flag / Disabled Flag / Excluded Flag Si está en borrador, desactivado o excluido
Created At / Updated At Creación y actualización

Tópico Cloud Chat

7. cloud_chat_conversations

Tabla principal de las conversaciones de Cloud Chat. Cada fila es una conversación (ticket), ya con métricas de tiempo y volumen consolidadas.

Columna Descripción
Conversation Id ID interno de la conversación
Conversation Display Id ID que aparece en la URL de la conversación (ej.: .../app/accounts/1/conversations/{conversation_display_id})
Conversation Uuid ID (UUID) de la conversación — es el enlace con la columna Cloudchat Id del tópico ClaudIA
Account Id / Account Name Cuenta asociada
Customer Id / Instance Id IDs del ambiente (tenant)
Inbox Id / Inbox Name Bandeja de entrada (canal)
Team Id / Team Name Equipo asignado
Assignee Id / Assignee Name / Assignee Email Agente responsable
Agent Type Tipo del agente (humano o IA)
Ai Agent Flag Si la conversación fue atendida por un agente de IA
Contact Id / Contact Inbox Id Contacto asociado
Campaign Id Campaña que originó la conversación, cuando aplica
Status Code Estado (abierta, resuelta, pendiente, pospuesta)
Priority Code Prioridad de la conversación
Tags List Lista de tags de la conversación
Csat Value Nota de CSAT de la conversación
Csat Sent Flag / Csat Responded Flag Si el CSAT fue enviado y respondido
Csat Response Submitted At Cuándo se respondió el CSAT
Created At / Updated At Creación y actualización
Client First Message At Primer mensaje del cliente
First Reply Created At Primera respuesta al cliente
Time To First Response Seconds/Minutes Tiempo hasta la primera respuesta
Waiting Since Date Desde cuándo aguarda respuesta
Snoozed Until Date Hasta cuándo está pospuesta
Contact/Agent/Assignee Last Seen At Últimas visualizaciones
Last Activity At Última actividad en la conversación
Proactively Initiated Flag Si fue iniciada proactivamente (envío activo)
Resolved Flag Si fue resuelta
Resolved At / Resolved At Date Cuándo fue resuelta
Is Conversation Recontact Flag Si es un recontacto (el cliente volvió en hasta 24h)
Minutes To Solve / Working Minutes To Solve Tiempo hasta la resolución (corrido y hábil)
Minutes Waiting / Working Minutes Waiting Tiempo aguardando respuesta (corrido y hábil)
Minutes In Service / Working Minutes In Service Tiempo en atención (corrido y hábil)
Messages Sent/Received In Conversation Mensajes enviados por la atención y recibidos del cliente
Contact Custom Fields / Conversation Custom Fields Campos personalizados del contacto y de la conversación

8. cloud_chat_conversations_first_reply_metrics

Métricas de primera respuesta por conversación, incluida la primera respuesta humana tras el handover de la IA.

Columna Descripción
Conversation Id / Conversation Display Id IDs de la conversación
Customer Id / Instance Id / Account Id IDs de ambiente y cuenta
Inbox Id / Inbox Name Bandeja de entrada (canal)
Assigned Team Id / Assigned Team Name Equipo asignado
Conversation Created At Creación de la conversación
Client First Message At Primer mensaje del cliente
First Reply Created At Primera respuesta al cliente (IA o humano)
First Responder Id/Name/Type Quién dio la primera respuesta y si fue IA o humano
Time To First Response Seconds/Minutes Tiempo hasta la primera respuesta
Human Handoff At Cuándo la conversación fue transferida de la IA a humano
Human First Reply Created At Primera respuesta humana
First Human Responder Id/Name Primer agente humano en responder
Time To First Human Response After Handoff Seconds/Minutes Tiempo entre el handover y la primera respuesta humana

9. cloud_chat_csat

Respuestas de CSAT de las conversaciones de Cloud Chat, ya enriquecidas con agente, equipo, bandeja y contacto.

Columna Descripción
Conversation Id / Conversation Display Id IDs de la conversación
Customer Id / Instance Id / Account Id IDs de ambiente y cuenta
Conversation Created At Creación de la conversación
Response Submitted At Cuándo el cliente respondió la encuesta
Csat Value Nota del cliente
Feedback Message Comentario del cliente
Tags List Tags de la conversación
Assigned Agent Id / Assigned Agent Name Agente asignado
Inbox Id / Inbox Name Bandeja de entrada (canal)
Team Id / Team Name Equipo asignado
Contact Id/Name/Phone Number Contacto que respondió

10. cloud_chat_conversations_tags

Tags aplicadas por conversación — cada fila es una tag aplicada a una conversación.

Columna Descripción
Conversation Id / Conversation Display Id IDs de la conversación
Customer Id / Instance Id / Account Id IDs de ambiente y cuenta
Conversation Created At Creación de la conversación
Tag Name Nombre de la tag aplicada
Tagged At Cuándo se aplicó la tag
Assignee Name / Inbox Name / Team Name Agente, bandeja y equipo de la conversación

11. cloud_chat_conversations_custom_fields

Campos personalizados (custom fields) por conversación — cada fila es un campo de una conversación. Complementa la columna Conversation Custom Fields de la tabla cloud_chat_conversations (ítem 7), que trae los campos como un blob único: aquí cada uno es una fila, lista para filtrar y pivotar.

Columna Descripción
Conversation Id / Conversation Display Id IDs de la conversación
Customer Id / Instance Id / Account Id IDs de ambiente y cuenta
Conversation Created At Creación de la conversación
Conversation Custom Field Name Nombre del campo personalizado
Conversation Custom Field Value Valor completado en el campo
Custom Field Updated At Cuándo se actualizó por última vez el valor del campo
Custom Attribute Id ID de la definición del campo personalizado en Cloud Chat
Assignee Name / Inbox Name / Team Name Agente, bandeja y equipo de la conversación

12. cloud_chat_tags

Catálogo de tags registradas en la cuenta.

Columna Descripción
Tag Id ID de la tag
Customer Id / Instance Id / Account Id IDs de ambiente y cuenta
Tag Name / Tag Description Nombre y descripción de la tag
Created At / Updated At Creación y actualización

13. cloud_chat_contacts

Contactos (clientes finales) registrados en Cloud Chat.

Columna Descripción
Contact Id ID del contacto
Customer Id / Instance Id / Account Id IDs de ambiente y cuenta
Contact Name / Middle Name / Last Name Nombre del contacto
Contact Email / Contact Phone Number Correo electrónico y teléfono
Identifier ID externo del contacto (ej.: ID en tu sistema)
Contact Type Tipo del contacto
Location / Country Code Ubicación
Additional Attributes / Custom Attributes Atributos adicionales y personalizados
Blocked Flag Si el contacto está bloqueado
Last Activity At Última actividad
Created At / Updated At Creación y actualización

14. cloud_chat_outbound_events

Eventos de envíos activos (campañas y envíos proactivos) — cada fila es un envío a un contacto, con el rastro completo de entrega.

Columna Descripción
Customer Id ID del ambiente (tenant)
Conversation Id / Conversation Display Id Conversación generada por el envío
Inbox Id / Inbox Name Bandeja de entrada (canal) del envío
Campaign Id / Campaign Name Campaña que originó el envío
Campaign Audience Name Audiencia de la campaña
Outbound Source Type Origen del envío (campaña, API, envío unitario)
Created At Creación del evento
Message Sent Flag / Sent At Si el envío se efectuó y cuándo
Message Received Flag / Received At Confirmación de entrega al dispositivo y cuándo
Message Read Flag / Read At Recibo de lectura y cuándo
Message Replied Flag / Replied At Si el destinatario respondió y cuándo
Error Code / Error Category Código y categoría del error, cuando el envío falla

15. cloud_chat_outbound_events_funnel_chart

Vista agregada de los envíos activos en formato de embudo (enviado → recibido → leído → respondido), lista para gráficos.

Columna Descripción
Customer Id ID del ambiente (tenant)
Event Created At Fecha del evento
Campaign Name / Campaign Audience Name Campaña y audiencia
Inbox Name Bandeja de entrada (canal)
Stage Name Etapa del embudo (enviado, recibido, leído, respondido)
Event Count Cantidad de eventos en la etapa

16. cloud_chat_agent_metrics

Métricas diarias consolidadas por agente — una fila por agente por día.

Columna Descripción
Agent Id / Agent Name Agente
Customer Id ID del ambiente (tenant)
Metric Date Fecha de referencia de las métricas
Tickets Created Assigned Tickets creados asignados al agente en el día
Tickets Resolved Assigned Tickets resueltos por el agente en el día
Sum (Working) Minutes To Solve Suma de los tiempos de resolución (corrido y hábil)
Sum (Working) Minutes In Service Suma de los tiempos en atención (corrido y hábil)
Sum (Working) Minutes Waiting Suma de los tiempos de espera (corrido y hábil)
Tickets Resolved With Recontact 24h Tickets resueltos en los que el cliente volvió en hasta 24h
Csat Responses / Csat Positive Responses Respuestas de CSAT recibidas y positivas
First Reply Tickets Count / Sum First Reply Minutes Tickets con la primera respuesta del agente y suma de los tiempos
First Reply After Handoff Tickets Count / Sum First Reply After Handoff Minutes Tickets con la primera respuesta humana después del handover de la IA y suma de los tiempos

Para calcular promedios (ej.: tiempo promedio de resolución), divide la columna de suma por el conteo correspondiente — ej.: Sum Minutes To Solve ÷ Tickets Resolved Assigned.

17. cloud_chat_team_metrics

La tabla es idéntica a cloud_chat_agent_metrics, con la siguiente diferencia:

Las métricas se agregan por equipo (Team Id / Team Name) en vez de por agente — una fila por equipo por día.

Cruzando ClaudIA y Cloud Chat

Las tablas de ambos tópicos se conectan por la conversación: Cloudchat Id (tópico ClaudIA) corresponde a Conversation Uuid (tópico Cloud Chat). La relación ya está configurada — al armar un análisis, basta combinar campos de ambos lados.

Observaciones