Table of Contents

AGENTS CONNECTION TIMES

El reporte Agents Connection Times permite consultar el detalle de conexión y desconexión de los agentes dentro de un rango de fechas determinado. Por cada agente y día, el reporte entrega la primera y última hora de conexión/desconexión, así como el tiempo acumulado en cada estado (Ready, Not Ready) y en los distintos motivos de desconexión automática registrados por el sistema.

Este reporte es útil para analizar la disponibilidad y el comportamiento de conexión de los agentes, identificar desconexiones no controladas (por ejemplo, pérdida de ping) y medir tiempos efectivos de disponibilidad por jornada.

GET {{ly_endpoint}}/api/LynnReporting/ExecuteReport/{{ly_tenant}}/{{ly_reportId}}
Request
(Body JSON)		 
{
        "startDate" : "2026-06-01 00:00:00",
        "endDate" : "2026-06-04 23:59:00",
        "lastDocument" : ""
}
Response 
{
    "isValid": true,
    "executionTime": 63.742,
    "idReport": "94607720-c91c-4dfe-a39f-fdd069cfe585",
    "nameVisualization": "Connection times",
    "totalDocument": 0,
    "pageCount": 0,
    "lastDocument": "",
    "requestCharge": 13.57,
    "result": [
        {
            "Date": "04-06-2026",
            "AgentName": "Camila",
            "AgentID": 1413,
            "LastConnectedAt": "04-06-2026 09:01:52",
            "LastDisconnectedAt": "04-06-2026 09:42:04",
            "FistConnectedAt": "04-06-2026 09:01:52",
            "FistDisconnectedAt": "04-06-2026 09:42:04",
            "Not Ready": "2m 1s",
            "Lynn logs off agent 'Camila' for lack of consecutive ping.": "0s",
            "Agent 'Camila' lost the ping for more than 60 seconds.": "2m 0s",
            "Ready": "38m 11s"
        },
        {
            "Date": "03-06-2026",
            "AgentName": "Camila",
            "AgentID": 1413,
            "LastConnectedAt": "03-06-2026 09:36:40",
            "LastDisconnectedAt": "03-06-2026 13:04:30",
            "FistConnectedAt": "03-06-2026 09:36:40",
            "FistDisconnectedAt": "03-06-2026 13:04:30",
            "Not Ready": "2m 0s",
            "Lynn logs off agent 'Camila' for lack of consecutive ping.": "0s",
            "Agent 'Camila' lost the ping for more than 60 seconds.": "2m 0s",
            "Ready": "3h 25m 49s"
        }
    ],
    "errors": [
        "Ok"
    ]
}

cURL

curl --location '{{ly_endpoint}}/api/LynnReporting/ExecuteReport/{{ly_tenant}}/{{ly_reportId}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{var_token}}' \
--data '{
    "startDate" : "2026-06-01 00:00:00",
    "endDate" : "2026-06-04 23:59:00",
    "size" : 1000,
    "lastDocument" : ""
}'

Parámetros de Ruta (Path Parameters)

Parámetro Descripción
ly_endpoint Url base, de acuerdo al ambiente:
Production: https://premium-production.lynn.cx
ly_tenant Identificador del tenant
ly_reportId ID del reporte a ejecutar
94607720-c91c-4dfe-a39f-fdd069cfe585

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.

Campos de result de Salida

Campo Tipo Descripción
Date string (date) Fecha del registro (formato DD-MM-YYYY).
AgentName string Nombre del agente.
AgentID number Identificador único del agente.
LastConnectedAt string (date-time) Fecha y hora de la última conexión del agente.
LastDisconnectedAt string (date-time) Fecha y hora de la última desconexión del agente.
FistConnectedAt string (date-time) Fecha y hora de la primera conexión del agente.
FistDisconnectedAt string (date-time) Fecha y hora de la primera desconexión del agente.
Not Ready string (duración hh:mm:ss) Tiempo acumulado en estado "No disponible".
Ready string (duración hh:mm:ss) Tiempo acumulado en estado "Disponible".
Lynn logs off agent '{AgentName}' for lack of consecutive ping. string (duración hh:mm:ss) Tiempo acumulado bajo este motivo de desconexión automática por falta de ping consecutivo.
Agent '{AgentName}' lost the ping for more than 60 seconds. string (duración hh:mm:ss) Tiempo acumulado bajo este motivo, por pérdida de ping superior a 60 segundos.