Los registros de actividad del agente son registros que se crean cada vez que cambia el estado del widget. Puede ser desde el acceso al widget, la recepción de una notificación de llamada de deltacast o la aceptación de una llamada, entre otros estados. Cada actividad crea un objeto nuevo. Consulta el siguiente modelo para verificar qué campos pueden contener PII:
[
{
"id": 0,
"agent_id": 0,
"whodunnit": {
"id": 0,
"name": "string",
"last_name": "string",
"first_name": "string",
"agent_number": "string",
"avatar_url": "string"
},
"status": {
"id": 0,
"name": "string",
"color": "string"
},
"started_at": "2018-06-06T21:12:24.766Z",
"ended_at": "2018-06-06T21:12:24.766Z",
"duration": 0,
"activity": "login",
"call_id": 0,
"chat_id": 0
}
]
En la siguiente tabla, se incluye un resumen de cada actividad que puede generar un registro de actividad.
| Actividad | Descripción |
|---|---|
| chat_picked_up | Evento que ocurre cuando un agente recoge a otro agente |
| chat_pick_up_attempt | Evento que ocurre cuando un agente intenta convertirse en el agente que responde |
| chat_notification_offered | Evento que ocurre cuando un usuario final solicita una sesión de chat y se envía una notificación a los agentes asignados a esa cola. |
| call_notification_offered | Evento que ocurre cuando un usuario final llama y se le ofrece al agente una notificación de llamada de transmisión simultánea o de transmisión delta. |
| call_pick_up_attempt | Es el evento que ocurre cuando un agente intenta responder una llamada de multicast o deltacast. |
| call_picked_up | Es el evento que ocurre cuando un agente responde una llamada de multicast o deltacast. |
| deltacast_call_notification_offered | Evento que indica que un usuario final llamó a una fila con transmisión simultánea en la que, luego, se transmite una llamada de Deltacast a un agente de esa fila. |
| deltacast_call_pick_up_attempt | Evento que ocurre cuando un agente intenta responder una llamada de deltacsted |
| deltacast_call_picked_up | Evento que ocurre cuando un agente responde correctamente una llamada transmitida con deltacast. |
| deltacast_call_missed | Evento que ocurre cuando un agente no responde su llamada de deltacast |
| multicast_call_notification_offered | Evento que indica que un usuario final llamó a una cola con Multicast en la que, luego, se transmite una llamada de Multicast a los agentes de esa cola |
| multicast_call_pick_up_attempt | Evento que ocurre cuando un agente intenta responder una llamada de multidifusión |
| multicast_call_picked_up | Evento que ocurre cuando un agente responde una llamada de transmisión múltiple |
| call_outbound_dialing | Evento que ocurre cuando un agente usa el teclado de marcado en el widget para llamar a un usuario final. |
| user_status_changed | Evento que ocurre cuando un agente cambia el estado en el que se encuentra su widget |
| acceder | Evento que se produce cuando un agente cierra sesión en el widget |
| salida | Evento que ocurre cuando un agente accede al widget |
Registros de actividad del agente
| Parámetro | Obligatorio | Tipo de datos | Definición |
|---|---|---|---|
| sort_column | FALSO | String | Ordena la respuesta según cualquier campo del objeto de respuesta. |
| sort_direction | FALSO | ASC o DESC | Indica la dirección de la clasificación, ya sea ascendente o descendente. |
| página | FALSO | String | Se combina con per para indicar qué página de registros. Por ejemplo, si per se establece en 200 y page en 2, la respuesta contendrá los registros del 201 al 400, ya que la página 1 contendrá del 1 al 200. |
| por | FALSO | String | Se empareja con la página para indicar cuántos registros se incluirían en una página de registros. Por ejemplo, si per se establece en 200 y page en 2, la respuesta contendrá los registros del 201 al 400, ya que la página 1 contendrá del 1 al 200. |
| started_at[from] | FALSO | Hora en UTC | Crea un límite inferior del campo started at. Todos los registros devueltos serán posteriores al valor ingresado. |
| started_at[to] | FALSO | Hora en UTC | Crea un límite superior del campo started at. Todos los registros devueltos serán anteriores al valor ingresado. |
| ended_at[from] | FALSO | Hora en UTC | Crea un límite inferior del campo ended at. Todos los registros devueltos serán posteriores al valor ingresado. |
| ended_at[to] | FALSO | Hora en UTC | Crea un límite superior del campo ended at. Todos los registros devueltos serán anteriores al valor ingresado. |
| duration[from] | FALSO | Número | Crea un límite inferior del campo de duración. Todos los registros devueltos serán posteriores al valor ingresado. |
| duration[to] | FALSO | Número | Crea un límite superior del campo de duración. Todos los registros devueltos serán anteriores al valor ingresado. |
| id[] | FALSO | Array[String] | Es un array de cadenas. Es el ID de los registros que se buscarán y devolverán. |
| agent_id[] | FALSO | Array[String] | Filtra la respuesta por ID de agente. |
| activity[] | FALSO | Array[String] | Filtra los registros según la tarea o actividad que completó el agente. Los valores posibles son: login, logout, call_outbound_dialing, deltacast_call_notification_offered, deltacast_call_pick_up_attempt, deltacast_call_picked_up, deltacast_call_projected, deltacast_call_missed, deltacast_call_bounced, multicast_call_notification_offered, multicast_call_pick_up_attempt, multicast_call_picked_up, user_status_changed, chat_notification_offered, chat_pick_up_attempt, chat_picked_up |
| whodunnit_id[] | FALSO | Array[String] | Filtra la respuesta por ID de agente. Whodunnit es un subconjunto del objeto agent y usa el mismo agent_id como clave primaria. |
| call_id[] | FALSO | Array[String] | Filtra los registros según los IDs de llamadas ingresados. |
| chat_id[] | FALSO | Array[String] | Filtra los registros según los IDs de chat ingresados. |
Endpoint:
Method: GET
Type:
URL: https://{{subdomain}}.{{domain}}/manager/api/v1/agent_activity_logs
Más ejemplos de solicitudes y respuestas:
Ejemplo de solicitud: Ejemplo de registros de actividad del agente
Cuerpo: Ninguno
Ejemplo de respuesta: Ejemplo de registros de actividad del agente
[
{
"id": 190578,
"agent_id": 118,
"status": {
"id": -10,
"name": "Offline",
"color": "grey",
},
"started_at": "2017-12-22T00:54:18.000Z",
"ended_at": null,
"duration": 0,
"call_id": null,
"chat_id": null,
"activity": "logout",
"whodunnit": null
},
{
"id": 199548,
"agent_id": 118,
"status": {
"id": -10,
"name": "Offline",
"color": "grey",
},
"started_at": "2018-01-09T22:54:26.000Z",
"ended_at": null,
"duration": 0,
"call_id": null,
"chat_id": null,
"activity": "logout",
"whodunnit": null
},
{
"id": 190577,
"agent_id": 118,
"status": {
"id": -10,
"name": "Offline",
"color": "grey",
},
"started_at": "2017-12-22T00:54:18.000Z",
"ended_at": "2018-01-08T22:54:22.000Z",
"duration": 1548004,
"call_id": null,
"chat_id": null,
"activity": "user_status_changed",
"whodunnit": null
},
{
"id": 199547,
"agent_id": 118,
"status": {
"id": -10,
"name": "Offline",
"color": "grey",
},
"started_at": "2018-01-09T22:54:26.000Z",
"ended_at": null,
"duration": 0,
"call_id": null,
"chat_id": null,
"activity": "user_status_changed",
"whodunnit": null
},
{
"id": 190270,
"agent_id": 118,
"status": {
"id": -1,
"name": "Unavailable",
"color": "red",
},
"started_at": "2017-12-21T21:34:14.000Z",
"ended_at": "2017-12-22T00:54:18.000Z",
"duration": 12004,
"call_id": null,
"chat_id": null,
"activity": "user_status_changed",
"whodunnit": null
},
{
"id": 198036,
"agent_id": 118,
"status": {
"id": -1,
"name": "Unavailable",
"color": "red",
},
"started_at": "2018-01-08T22:54:22.000Z",
"ended_at": "2018-01-09T22:54:26.000Z",
"duration": 86404,
"call_id": null,
"chat_id": null,
"activity": "user_status_changed",
"whodunnit": null
},
{
"id": 22249,
"agent_id": 129,
"status": {
"id": -10,
"name": "Offline",
"color": "grey",
},
"started_at": "2017-06-19T18:34:39.000Z",
"ended_at": null,
"duration": 0,
"call_id": null,
"chat_id": null,
"activity": "login",
"whodunnit": null
}
]
Código de estado: 200