SESSIONS

Esta API permite acceder al detalle de todas las sesiones registradas en la plataforma, independientemente del canal o el flujo de origen. Con esta, obtienes visibilidad sobre cada sesión: el canal utilizado, los tiempos de inicio y finalización, la duración de la interacción y el criterio empleado para identificar al contacto. En caso de que la sesión provenga de una campaña de salida (Outbound), se incluye además la referencia al registro de campaña asociado (campaignRecordId, campaignRecordCreationDate).

Note

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

POST {{ly_endpoint}}/api/LynnReporting/ExecuteReport/{{ly_tenant}}/59435eb3-3e0f-4005-8bb5-48432da6364d

Request
(Body JSON)

{
        "startDate" : "2026-05-01 00:00:00",
        "endDate" : "2026-07-01 23:59:00",
        "lastDocument" : ""
}

Response

{
    "isValid": true,
    "errors": [],
    "executionTime": 547.6673,
    "idReport": "59435eb3-3e0f-4005-8bb5-48432da6364d",
    "nameVisualization": "Sessions",
    "totalDocument": 25,
    "pageCount": 0,
    "lastDocument": null,
    "requestCharge": 159.38,
    "result": [
        {
            "tenantId": 0000,
            "sessionId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
            "created": "2026-06-09T19:31:46.4323688Z",
            "finished": "2026-06-09T19:32:03.0729434Z",
            "criteria": "rut",
            "criteriaValue": "unknown",
            "channelId": 20,
            "channelName": "Chat",
            "channelIcon": "",
            "channelService": 1,
            "division": 1,
            "interactionTimeSeconds": 16.6405746,
            "campaignRecordId": null,
            "campaignRecordCreationDate": null
        }
    ]
}

cURL

curl --location '{{ly_endpoint}}/api/LynnReporting/ExecuteReport/{{ly_tenant}}/59435EB3-3E0F-4005-8BB5-48432DA6364D' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{var_token}}' \
--data '{
    "startDate" : "{{startDate}}",
    "endDate" : "{{endDate}}",
    "size" : 1000
}'

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 `59435EB3-3E0F-4005-8BB5-48432DA6364D`

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
`tenantId`	`integer`	Identificador único del tenant.
`sessionId`	`string`	Identificador único de la sesión (UUID).
`created`	`string` (`date-time`)	Fecha y hora de creación de la sesión.
`finished`	`string` (`date-time`)	Fecha y hora de finalización de la sesión.
`criteria`	`string`	Tipo de criterio utilizado para identificar al contacto (ej. `rut`).
`criteriaValue`	`string`	Valor del criterio utilizado (ej. `unknown` cuando no se identificó al contacto).
`channelId`	`integer`	ID numérico del canal de contacto utilizado.
`channelName`	`string`	Nombre del canal de contacto.
`channelIcon`	`string`	Fragmento HTML con el ícono representativo del canal.
`channelService`	`integer`	Identificador del servicio asociado al canal.
`division`	`integer`	Identificador de la división asociada a la sesión.
`interactionTimeSeconds`	`number`	Duración de la interacción, en segundos (con decimales).
`campaignRecordId`	`string` o `null`	Identificador del registro de campaña asociado a la sesión, si corresponde.
`campaignRecordCreationDate`	`string` (`date-time`) o `null`	Fecha y hora de creación del registro de campaña asociado, si corresponde.