Reports — Endpoints & Query Parameters

Base URL: /ou/{orgId}/contacts Cada KPI card tiene un enlace "Abrir estos contactos en una nueva pestaña" que revela los parámetros exactos.

---

0. Date Picker & Query Parameters

La selección de período modifica createdAtFrom y createdAtTo en TODOS los endpoints:

Período	createdAtFrom	createdAtTo
Hoy	Hoy T{tzOffset}:00:00.000Z	Hoy+2 T{tzOffset-1}:59:59.999Z
7d	Hoy-7 T{tzOffset}:00:00.000Z	Hoy+1 T{tzOffset-1}:59:59.999Z
30d	Hoy-30 T{tzOffset}:00:00.000Z	Hoy+1 T{tzOffset-1}:59:59.999Z
90d	Hoy-90 T{tzOffset}:00:00.000Z	Hoy+1 T{tzOffset-1}:59:59.999Z
Fechas específicas	Fecha inicial T{tzOffset}:00:00.000Z	Fecha final+1 T{tzOffset-1}:59:59.999Z

{tzOffset} = offset de la zona horaria del workspace (ej.: 03 para UTC-3). El date picker modifica ÚNICAMENTE createdAtFrom/createdAtTo — todos los demás parámetros son fijos por KPI.

Ejemplo real (7d, UTC-3):createdAtFrom=2026-07-09T03:00:00.000Z&createdAtTo=2026-07-17T02:59:59.999Z

---

1. Pipelines Dashboard (/reports/pipelines)

1.1 Conversaciones (from=overview.conversations)

Qué mide: Total de conversaciones en el período, dividido en En curso (Abierto) y Cerradas. Query: contacts?createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.conversations

1.2 Contactos (from=overview.contacts)

Qué mide: Contactos únicos con conversaciones en el período. A diferencia de Conversaciones, cuenta cada contacto una sola vez. Query: contacts?createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.contacts

1.3 Tasa de Transferencia Humana (from=overview.humanTransfer)

Qué mide: % de conversaciones transferidas a humano (escaladas O calificadas). Query: contacts?forwardedType=escalated,qualified&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.humanTransfer

1.4 Calificadas (from=overview.qualified)

Qué mide: Subconjunto de transferencias — solo las calificadas (lead con interés real), sin las escaladas. Query: contacts?forwardedType=qualified&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.qualified

1.5 Objetivo Alcanzado (from=overview.goalAchieved)

Qué mide: Conversaciones que llegaron a las etapas finales del pipeline (ej.: venta cerrada). Query: contacts?pipelineStage={stageIds}&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.goalAchievedFijos: pipelineStage={stageIds} — IDs de las etapas consideradas "objetivo".

1.6 Mensajes Automáticos (from=overview.followups)

Qué mide: Follow-ups automáticos enviados y cuántos recibieron respuesta del lead. Query: contacts?hasAutomatedMessage=1&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.followupsFijos: hasAutomatedMessage=1

1.7 Conversaciones 24h

Qué mide: Total inbound/outbound en las últimas 24h. NO usa el date picker — siempre las últimas 24h.

Embudo de Conversaciones

Etapas: Total → Objetivo Alcanzado → No Transferidas → Transferencia Humana → Calificadas → Escaladas

---

2. Desempeño del Equipo (/reports/team)

KPI	Descripción
Asignadas al equipo	Conversaciones asignadas en el período
Por resolver	En espera de acción del equipo
Resueltas	Concluidas
Tiempo 1ª respuesta (24/7)	Media en minutos
Tiempo medio respuesta (24/7)	Media en minutos

Tabla de Miembros

Columna	Descripción
Miembro	Nombre
Horario	Ej.: 09:00-18:00 (días de la semana)
Asignadas / Por resolver / Resueltos / Trabajadas	Conteos
Templates	Templates usados
Fuera hr.	Atenciones fuera del horario
1ª resp. / Resp. med. / Resolución	Tiempos

---

3. Canales (/reports/channels)

KPI Card	from=	Params Adicionales
Conversaciones en canales	channels.conversations	channel={channelId}
Contactos	channels.contacts	channel={channelId}
Transf. Humanas	channels.humanTransfer	forwardedType=escalated,qualified&channel={channelId}
Calificadas	channels.qualified	forwardedType=qualified&channel={channelId}
Objetivo Alcanzado	channels.goalAchieved	pipelineStage={stageIds}&channel={channelId}
Msg Automáticos	channels.followups	hasAutomatedMessage=1&channel={channelId}

Métricas por Canal

Métrica	Descripción
Conversaciones	Total
No transferidas	Sin handoff
Transferencias humanas	Handoffs
Msg Enviados	Outbound
Msg Recibidos	Inbound

---

4. Calidad de la IA (/reports/audit)

KPI	Descripción
Conversaciones Auditadas	Total revisadas
Tasa de Finalización	% concluidas
Conversaciones No Auditadas	Pendientes

Desempeño por Variable (Rating 1-5★)

Variable	Descripción
Información Correcta	Precisión factual
Recorrido del Usuario	Adecuación al flujo
Tono y Estilo de la IA	Calidad del tono

Tabla de Auditoría

Columna	Descripción
Cliente	ID/teléfono
Auditor	IA o humano
Fecha de la Auditoría	Timestamp
Información Correcta	1-5★
Recorrido del Usuario	1-5★
Tono y Estilo de la IA	1-5★
Comentarios	Observaciones detalladas

Grounding (Mensajes Corregidos)

KPI	Meta
Mensajes corregidos	—
Total mensajes IA	—
Tasa de corrección	< 10%

---

5. Resumen de Query Parameters

Param	Tipo	Valores	Usado en
createdAtFrom	ISO 8601	{ISO}	Todos
createdAtTo	ISO 8601	{ISO}	Todos
from	string	overview.* / channels.*	Todos
forwardedType	string	escalated, qualified	humanTransfer, qualified
pipelineStage	CSV	{stageId1},{stageId2}	goalAchieved
hasAutomatedMessage	1	1	followups
channel	int	{channelId}	Channels report