Table of Contents

DIALOGS

Esta API permite acceder al detalle de los diálogos registrados en las conversaciones de la plataforma. Con esta, obtienes visibilidad sobre cada mensaje o interacción dentro de un diálogo: quién lo emitió (bot, cliente, agente o consultor), la intención detectada, el canal utilizado y los metadatos técnicos asociados (motor cognitivo, nivel de confianza, servidor, entre otros).

Note

Este reporte no permite ser consultado por un período mayor a 90 días.

POST {{ly_endpoint}}/api/LynnReporting/ExecuteReport/{{ly_tenant}}/9306395D-F645-4597-9563-78DF67836192
Request
(Body JSON)		 
{
        "startDate" : "2026-05-01 00:00:00",
        "endDate" : "2026-07-01 23:59:00",
        "lastDocument" : ""
}
Response 
{
    "isValid": true,
    "errors": [],
    "executionTime": 405.2451,
    "idReport": "9306395d-f645-4597-9563-78df67836192",
    "nameVisualization": "Dialogues",
    "totalDocument": 102,
    "pageCount": 0,
    "lastDocument": "XXXXXXXXXXXXXXX",
    "requestCharge": 123.92,
    "result": [
        {
            "secuenceType": 1,
            "part": 0,
            "currentIntent": "Inicio",
            "previousIntent": null,
            "confidence": 1,
            "text": "¡Bienvenido al chat de e-Contact!👋.",
            "options": "",
            "cognitiveEngine": "Unknown",
            "minConfidence": 0.20000000298023224,
            "isOnChat": false,
            "conversationId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
            "partName": "Nombre de la parte",
            "header": "",
            "criteria": "uid",
            "criteriaValue": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
            "url": null,
            "fileName": null,
            "attempt": 1,
            "entityConcreteId": -1,
            "subLevel": "text",
            "service": 1,
            "footer": null,
            "type": null,
            "label": null,
            "chatEngine": null,
            "division": 1,
            "sessionId": "XXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
            "channelId": 20,
            "dialogueGroups": 0,
            "iterations": 0,
            "serverEnvironment": "production",
            "serverName": "LYNN-LATAM-PRODUCTION-BR-BROKER-9-SB-DEV8",
            "id": "sequence_i_XXXXXXXX-XXXX-XXXX-XXXX-xxxxxxxxxxxx_id_XXXXXXXX-XXXX-xxxx-xxxx-XXXXXXXXXXXX",
            "tenantId": 2258,
            "date": "2026-05-02T07:47:07.6145764+00:00",
            "channelName": "Chat"
        }
    ]
}

cURL

curl --location '{{ly_endpoint}}/api/LynnReporting/ExecuteReport/{{ly_tenant}}/9306395D-F645-4597-9563-78DF67836192' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{var_token}}' \
--data '{
    "startDate" : "{{startDate}}",
    "endDate" : "{{endDate}}",
}'

Parámetros de Ruta (Path Parameters)

Parámetro Descripción
ly_endpoint Url base, de acuerdo al ambiente:
Production: premium-production.lynn.cx
ly_tenant Identificador del tenant
ly_reportId ID del reporte a ejecutar
9306395D-F645-4597-9563-78DF67836192

Parámetros de Entrada

Campo Tipo Requerido Descripción
startDate string (date-time) ✅ Fecha y hora de inicio en formato yyyy-MM-dd HH:mm:ss
endDate string (date-time) ✅ Fecha y hora de término en el mismo formato
lastDocument string Opcional Identificador del último documento recibido en una consulta anterior, usado para paginar resultados. Se envía vacío o se omite en la primera consulta.

Parámetros de result de Salida

Campo Tipo Descripción
secuenceType integer 1: Diálogo normal.
2: Diálogo que contiene una evaluación cognitiva.
3: Diálogo que contiene un archivo.
4: Diálogo de autenticación B2C.
5: Diálogo formateado para canales como WhatsApp.
part integer 0: Bot.
1: Cliente.
2: Agente.
4: Consultor.
currentIntent string Intención (intent) actual detectada en el diálogo.
previousIntent string o null Intención (intent) previa detectada, si existe.
confidence number Nivel de confianza de la intención detectada (0 a 1).
text string Texto del mensaje enviado o mostrado en el diálogo.
options string Opciones asociadas al mensaje, si corresponde.
cognitiveEngine string Motor cognitivo utilizado para el procesamiento del mensaje.
minConfidence number Umbral mínimo de confianza configurado para la intención.
isOnChat boolean Indica si el mensaje se originó dentro del chat.
conversationId string Identificador único de la conversación (UUID).
partName string Nombre descriptivo de la parte del flujo.
header string Encabezado del mensaje, si corresponde.
criteria string Tipo de criterio utilizado para identificar al contacto.
criteriaValue string Valor del criterio utilizado para identificar al contacto.
url string o null URL asociada al mensaje, si corresponde.
fileName string o null Nombre del archivo asociado al mensaje, si corresponde.
attempt integer Número de intento del mensaje o interacción.
entityConcreteId integer Identificador de la entidad concreta asociada (-1 si no aplica).
subLevel string Subnivel o tipo de contenido del mensaje (text o menu).
service integer Identificador del servicio asociado.
footer string o null Pie del mensaje, si corresponde.
type string o null Tipo de mensaje, si corresponde.
label string o null Etiqueta asociada al mensaje, si corresponde.
chatEngine string o null Motor de chat utilizado, si corresponde.
division integer Identificador de la división asociada.
sessionId string Identificador único de la sesión (UUID).
channelId integer ID numérico del canal de contacto utilizado.
dialogueGroups integer Cantidad de grupos de diálogo asociados.
iterations integer Cantidad de iteraciones del diálogo.
serverEnvironment string Entorno del servidor que procesó el mensaje (ej. production).
serverName string Nombre del servidor que procesó el mensaje.
id string Identificador único del registro de secuencia.
tenantId integer Identificador único del tenant.
date string (date-time) Fecha y hora del mensaje.
channelName string Nombre del canal de contacto (ej. Chat).