Visión general
El Report Builder V2 permite analizar y exportar datos de campos personalizados de contacto en CloudChat, cruzando esa información con datos de las conversaciones.
Paso a paso
1. Acceder al Report Builder V2
En la barra lateral, entra en la pestaña "Relatórios" (Informes) y haz clic en el último elemento — "Construtor de Relatórios V2" (Report Builder V2).
2. Crear un nuevo informe
En la página inicial, haz clic en "Novo" (Nuevo) en la esquina superior derecha. Verás el catálogo completo de tablas disponibles en CloudChat.
3. Seleccionar la tabla correcta
Para analizar campos personalizados de contacto, selecciona la tabla CloudChat Conversations — la primera opción de conversaciones de la lista.
No selecciones la segunda opción de conversaciones. No tiene asociación directa con los datos de las conversaciones y sirve para otro tipo de análisis.
4. Seleccionar las columnas
Con la tabla abierta, selecciona las columnas que desees. Recomendamos incluir:
-
Conversation ID — identificador único de cada conversación
-
Created At — fecha en que se inició la conversación
5. Aplicar filtro de periodo
Para optimizar el rendimiento y trabajar con datos más recientes, aplica un filtro de periodo en la columna Created At. Se recomienda usar los últimos 90 días.
6. Agregar el campo de campos personalizados de contacto
En el área de columnas, busca "contact" y selecciona Contact Custom Fields.
Este campo tiene formato de diccionario:
-
La clave es el identificador del campo personalizado
-
El valor es el contenido almacenado
Una conversación puede tener múltiples campos personalizados, lo que resulta en varios pares clave-valor. Ejemplo:
{"customAttribute1": "valor_x", "customAttribute2": "valor_y"}
7. Usar el agente de IA para extraer el campo deseado
Haz clic en el ícono de estrellas (✨) para abrir el agente de IA. Copia el prompt de abajo, reemplaza los dos campos destacados y pégalo en el agente:
Genera una nueva columna a partir del campo Contact Custom Fields.
El campo Contact Custom Fields es un campo de tipo texto (varchar) que puede almacenar múltiples campos personalizados del contacto asociado a esa conversación, en un formato similar a un diccionario, con esta estructura: {"clave1": "valor1", "clave2": "valor2"}. Haz un breve análisis de los valores posibles en esa columna para tener más contexto.
Debes generar una nueva columna llamada <<INSERTA AQUÍ EL NOMBRE DE LA COLUMNA DESEADA>> con los valores del campo/clave <<INSERTA AQUÍ LA CLAVE DESEADA>>.
Contexto adicional:
#Estás trabajando en una base Redshift
#No debes utilizar la función JSON_VALUE ni intentar convertir el campo al tipo JSON. El usuario ya aclaró que la columna, a pesar de estar almacenada en un formato similar a un diccionario, es de tipo texto, así que no tendrás éxito con funciones de JSON
#Algunas veces los valores del diccionario están encapsulados por comillas dobles "valor" y otras veces por comillas simples ''. Verifica si eso ocurre y, en caso de confirmarse, asegúrate de que se trate correctamente
Reemplaza:
-
<<INSERTA AQUÍ EL NOMBRE DE LA COLUMNA DESEADA>>→ el nombre que quieres dar a la nueva columna (ej.:campo_customizado_1) -
<<INSERTA AQUÍ LA CLAVE DESEADA>>→ la clave exacta tal como aparece en los datos (ej.:customAttribute1)
Después de ajustar el prompt, envíalo al agente y espera el procesamiento.
8. Visualizar y exportar los resultados
Con el análisis concluido, tendrás una tabla con los datos procesados. A partir de ahí es posible:
Exportar los datos: haz clic en el ícono de descarga para hacer análisis externos.
Crear gráficos en el propio constructor:
-
Elimina las columnas que no se usarán en la visualización
-
Agrega una agregación (ej.: conteo distinto de conversaciones por valor del campo)
-
Haz clic en "Gráfico" y configura los ejes:
-
Eje X: campo personalizado
-
Eje Y: conteo de conversaciones
-
9. Guardar como dashboard
En la esquina superior derecha, haz clic en + Dashboard para transformar el análisis en un dashboard y guárdalo en la carpeta de tu empresa en la pestaña "Panel de ClaudIA/Centro". Así cualquier persona de tu equipo puede reutilizar el informe en cualquier momento sin necesidad de recrearlo desde cero.