Usuarios autorizados: Administradores.
La misión: Aprende todos los campos disponibles, tipos de datos y valores posibles al crear reportes personalizados con la fuente de datos "Mensajes de inbox" en el Constructor de Reportes de Escala.
Esta guía te enseñará a usar cada uno de los más de 30 campos disponibles en la fuente de datos Mensajes de inbox, incluyendo qué tipo de dato tiene cada campo, qué valores puedes esperar y cómo utilizarlos para crear reportes útiles.
¿Cómo acceder al constructor de reportes?
Para crear un reporte personalizado sobre mensajes del inbox:
- Ve a Reportes en el menú lateral izquierdo.
- Haz clic en la pestaña Reportes.
- Haz clic en + Nuevo reporte.
- Selecciona + Crear desde cero.
- En Fuentes de datos, selecciona Mensajes de inbox.
📸 Screenshot 1: Constructor de Reportes con "Mensajes de inbox" seleccionado como fuente de datos.
Entidades de datos disponibles
Al seleccionar "Mensajes de inbox" como fuente de datos, verás tres categorías de campos en el panel izquierdo:
| Categoría | Descripción |
|---|
| Métricas predeterminadas | Métricas agregadas integradas, como conteos y valores calculados. |
| Mensaje | Todas las propiedades del mensaje: remitente, destinatario, estado de entrega, timestamps, canal, tipo de contenido, etc. |
| Mensaje referenciado | Propiedades del mensaje original al que se está respondiendo (útil para rastrear hilos de conversación). |
📸 Screenshot 2: Panel lateral mostrando las tres categorías de datos.
Tipos de datos en el constructor
Cada campo tiene un ícono que indica su tipo de dato. Esto determina cómo puedes usarlo en el reporte:
| Ícono | Tipo | Uso en reportes |
|---|
| # | Numérico | Se usa en el Eje Y (mediciones), métricas y valores KPI. |
| Aa | Texto (String) | Se usa en el Eje X (agrupación), filtros y columnas de tabla. |
| 📅 | Fecha/Hora | Se usa para agrupación temporal, análisis de tendencias y filtros de fecha. |
⚠️ Importante: Varios campos que funcionan como booleanos (sí/no) están almacenados como tipo Aa Texto. Sus valores son las cadenas "True" y "False" en inglés. Al crear filtros, debes usar estos valores exactos.
Referencia completa de campos
Métricas predeterminadas
| Campo | Tipo | Descripción |
|---|
| Métrica calculada | # | Métrica personalizada que puedes definir con fórmulas. |
| Cantidad total | # | Conteo agregado de mensajes según los filtros que apliques. |
Mensaje — Identificación y enrutamiento
| Campo | Tipo | Valores posibles | Descripción |
|---|
| Fecha y hora | 📅 | Timestamps | Cuándo se creó o envió el mensaje. |
| Id del mensaje | Aa | IDs únicos | Identificador único del mensaje. |
| Cuenta | Aa | Nombres de cuenta | La cuenta de Escala a la que pertenece. |
| Canal | Aa | Whatsapp API, inbox.channelNames.wab_api | Plataforma de mensajería. Puede mostrar la clave del sistema. |
| Id de conversación | Aa | IDs únicos | Agrupa mensajes en hilos de conversación. |
| Orígen | Aa | Entrante, Saliente | Entrante = contacto envió. Saliente = tu equipo envió. |
Mensaje — Personas y asignación
| Campo | Tipo | Descripción |
|---|
| Id de recipiente | Aa | ID interno de la persona que recibe el mensaje. |
| Dueño | Aa | Agente o usuario asignado a la conversación. |
| Remitente | Aa | Quién envió el mensaje (número o nombre). |
| Destiatario | Aa | Quién recibió el mensaje. |
| Nombre del recipiente | Aa | Nombre legible del destinatario. |
| Id del contacto | Aa | Enlaza el mensaje con un registro de contacto del CRM. |
Pipeline de estado de entrega
Estos campos representan cada etapa del proceso de entrega. Aunque aparecen como tipo Aa Texto, funcionan como booleanos:
| Campo | Tipo | Valores | Descripción |
|---|
| Enviado | Aa (bool) | "True" / "False" | ¿Se envió el mensaje exitosamente? |
| Entregado | Aa (bool) | "True" / "False" | ¿Se entregó al dispositivo del destinatario? |
| Leído | Aa (bool) | "True" / "False" | ¿Fue leído por el destinatario? |
| Respondido | Aa (bool) | "True" / "False" | ¿Recibió una respuesta? |
| Error | Aa (bool) | "True" / "False" | ¿Ocurrió un error de entrega? |
Embudo de entrega:
Enviado
→
Entregado
→
Leído
→
Respondido
💡 Tip: Usa la visualización tipo Embudo para analizar la tasa de conversión en cada etapa del pipeline.
Timestamps de cambio de estado
| Campo | Tipo | Descripción |
|---|
| Fecha de leído | 📅 | Timestamp exacto de cuándo se leyó el mensaje. |
| Fecha de respondido | 📅 | Timestamp exacto de cuándo se recibió la respuesta. |
Tipo de mensaje y contenido
El campo Tipo de mensaje clasifica el formato del contenido:
| Valor | Descripción |
|---|
Texto | Mensaje de texto plano. Es el tipo más común. |
Plantilla | Mensaje de plantilla pre-aprobada de WhatsApp (HSM). Se usa para iniciar conversaciones fuera de la ventana de 24 horas. |
Audio | Nota de voz o archivo de audio enviado en la conversación. |
Imágen | Imagen o foto adjunta al mensaje. |
unsupported | Tipo de mensaje no visualizable a través de la API de Meta/WhatsApp Business. Generalmente corresponde a mensajes con desaparición automática (mensajes temporales), mensajes de vista única, u otros formatos que la API no puede procesar. |
Localización | Ubicación GPS compartida por el contacto o el agente. |
⚠️ Sobre el valor "unsupported": Este valor aparece cuando el contacto envía un tipo de contenido que la API de WhatsApp Business de Meta no puede entregar a sistemas de terceros. Los casos más comunes son: mensajes con desaparición activada, mensajes de vista única, y formatos multimedia no soportados por la API.
Métricas de rendimiento
| Campo | Tipo | Descripción |
|---|
| Tiempo de respuesta (s) | # | Tiempo de respuesta en segundos — el único campo numérico nativo. Ideal para medir rendimiento de agentes y cumplimiento de SLA. |
Flags de primera respuesta
| Campo | Tipo | Valores | Descripción |
|---|
| Es primera respuesta | Aa (bool) | "True" / "False" | ¿Es la primera respuesta en la conversación? |
| Es primera respuesta automática | Aa (bool) | "True" / "False" | ¿Fue enviada por una automatización? |
| Es primera respuesta de usuario | Aa (bool) | "True" / "False" | ¿Fue enviada por un agente humano? |
Respuesta rápida y plantillas
| Campo | Tipo | Descripción |
|---|
| Texto de respuesta seleccionada | Aa | Contenido del botón de respuesta rápida seleccionado. |
| Título de respuesta seleccionada | Aa | Etiqueta del botón de respuesta rápida. |
| Plantilla | Aa | Nombre de la plantilla de WhatsApp utilizada. |
Atribución y automatización
| Campo | Tipo | Descripción |
|---|
| Id de anuncio | Aa | Enlaza con un anuncio de Meta si la conversación vino de click-to-WhatsApp. |
| Automatización | Aa | Nombre del flujo de automatización que activó el mensaje. |
| Id de acción de automatización | Aa | ID del paso específico dentro de la automatización. |
Mensaje referenciado
Campos del mensaje original al que se responde. Útil para rastrear cadenas de respuestas.
| Campo | Tipo | Descripción |
|---|
| Id del mensaje | Aa | ID del mensaje padre/original. |
| Automatización | Aa | Automatización vinculada al mensaje original. |
| Id de acción de automatización | Aa | ID de acción del mensaje original. |
| Plantilla | Aa | Plantilla utilizada en el mensaje original. |
Tipos de visualización disponibles
| Tipo | Mejor para |
|---|
| Barras | Comparar cantidades entre categorías (ej. mensajes por canal). |
| Líneas | Tendencias en el tiempo (ej. volumen diario de mensajes). |
| Tabla | Desgloses detallados con números exactos. |
| Pastel | Distribución proporcional (ej. % por tipo de mensaje). |
| Indicador | Seguimiento de un KPI individual (ej. tiempo promedio de respuesta). |
| Métrica | Resaltar un número clave (ej. total de mensajes enviados). |
| Embudo | Conversión por etapas (Enviado → Entregado → Leído → Respondido). |
Ideas prácticas de reportes
| Reporte | Visual | Eje X (Agrupar) | Eje Y (Medir) |
|---|
| Embudo de entrega | Embudo | Enviado / Entregado / Leído | Cantidad total |
| Tiempo de respuesta por agente | Barras | Dueño | Tiempo de respuesta (prom) |
| Volumen en el tiempo | Líneas | Fecha y hora | Cantidad total |
| Entrante vs Saliente | Pastel | Orígen | Cantidad total |
| Tipos de mensaje | Pastel | Tipo de mensaje | Cantidad total |
| Rendimiento de plantillas | Tabla | Plantilla | Entregado, Leído |
| Conversaciones de anuncios | Barras | Id de anuncio | Cantidad total |
Notas importantes
⚠️ Campos booleanos almacenados como texto: Los campos Enviado, Entregado, Leído, Respondido, Error y los flags de primera respuesta usan los valores "True" o "False" (en inglés, sin traducir). Al crear filtros, debes usar estos valores exactos.
- Los valores de Canal pueden incluir claves del sistema — por ejemplo
inbox.channelNames.wab_api además del nombre legible Whatsapp API. - El valor
unsupported en Tipo de mensaje — corresponde a mensajes no visualizables vía la API de Meta, como mensajes con desaparición activada, mensajes de vista única u otros formatos no soportados. - Tiempo de respuesta es la única métrica numérica nativa — todos los demás insights provienen de contar o agrupar campos de texto.
- Los valores exactos de la plataforma no se traducen —
True, False, Whatsapp API, unsupported, Entrante, Saliente son valores literales del sistema.
¿Estás listo para crear tu primer reporte personalizado?