I log delle attività degli agenti sono record creati ogni volta che lo stato del widget è cambiato. Può trattarsi dell'accesso al widget, della ricezione di una notifica di chiamata Deltacast o dell'accettazione di una chiamata, tra gli altri stati. Ogni attività crea un nuovo oggetto. Consulta il seguente modello per verificare quali campi potrebbero contenere 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,
"wfm_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
}
]
La tabella seguente contiene un riepilogo di ogni attività che può comportare la creazione di un log delle attività.
| Attività | Descrizione |
|---|---|
| chat_picked_up | Evento che si verifica quando un agente prende un agente |
| chat_pick_up_attempt | Evento che si verifica quando un agente tenta di diventare l'agente che risponde |
| chat_notification_offered | Evento che si verifica quando un utente finale richiede una sessione di chat e viene inviata una notifica agli agenti assegnati a quella coda. |
| call_notification_offered | Evento che si verifica quando un utente finale chiama e all'agente viene offerta una notifica di chiamata multicast o deltacast. |
| call_pick_up_attempt | Evento che si verifica quando un agente tenta di rispondere a una chiamata multicast o deltacast. |
| call_picked_up | Evento che si verifica quando un agente risponde a una chiamata multicast o deltacast. |
| deltacast_call_notification_offered | Evento che indica che un utente finale ha chiamato una coda con multicast in cui una chiamata deltacast viene poi trasmessa a un agente in quella coda. |
| deltacast_call_pick_up_attempt | Evento che si verifica quando un agente tenta di rispondere a una chiamata deltacsted |
| deltacast_call_picked_up | Evento che si verifica quando un agente risponde correttamente a una chiamata deltacast. |
| deltacast_call_missed | Evento che si verifica quando un agente non risponde alla chiamata di delta cast |
| multicast_call_notification_offered | Evento che indica che un utente finale ha chiamato una coda con multicast in cui una chiamata multicast viene poi trasmessa agli agenti della coda |
| multicast_call_pick_up_attempt | Evento che si verifica quando un agente tenta di rispondere a una chiamata multicast |
| multicast_call_picked_up | Evento che si verifica quando una chiamata multicast ha ricevuto risposta da un agente |
| call_outbound_dialing | Evento che si verifica quando un agente utilizza il tastierino nel widget per chiamare un utente finale. |
| user_status_changed | Evento che si verifica quando un agente cambia lo stato del widget |
| accedi | Evento che si verifica quando un agente esce dal widget |
| esci | Evento che si verifica quando un agente accede al widget |
Log delle attività dell'agente
| Parametro | Obbligatorio | Tipo di dati | Definizione |
|---|---|---|---|
| sort_column | FALSE | Stringa | Ordina la risposta in base a qualsiasi campo dell'oggetto risposta. |
| sort_direction | FALSE | ASC o DESC | Indica la direzione dell'ordinamento, crescente o decrescente |
| pagina | FALSE | Stringa | Coppie con per per indicare la pagina dei record. Ad esempio, se per è impostato su 200 e page è 2, la risposta conterrà i record 201-400, poiché la pagina 1 conterrà i record 1-200. |
| per | FALSE | Stringa | Coppie con la pagina per annotare quanti record verranno inclusi in una pagina di record. Ad esempio, se per è impostato su 200 e page è 2, la risposta conterrà i record da 201 a 400, poiché la pagina 1 conterrà i record da 1 a 200. |
| started_at[from] | FALSE | Ora in UTC | crea un limite inferiore del campo Iniziato il. Tutti i record restituiti saranno successivi al valore inserito. |
| started_at[to] | FALSE | Ora in UTC | crea un limite superiore del campo Inizio. Tutti i record restituiti saranno precedenti al valore inserito. |
| ended_at[from] | FALSE | Ora in UTC | crea un limite inferiore del campo Terminato il. Tutti i record restituiti saranno successivi al valore inserito. |
| ended_at[to] | FALSE | Ora in UTC | crea un limite superiore del campo Termina alle. Tutti i record restituiti saranno precedenti al valore inserito. |
| duration[from] | FALSE | Numero | crea un limite inferiore del campo della durata. Tutti i record restituiti saranno successivi al valore inserito. |
| duration[to] | FALSE | Numero | crea un limite superiore del campo della durata. Tutti i record restituiti saranno precedenti al valore inserito. |
| id[] | FALSE | Array[Stringa] | Array[Strings]. ID dei record da cercare e restituire |
| agent_id[] | FALSE | Array[Stringa] | Filtra la risposta per ID agente |
| activity[] | FALSE | Array[Stringa] | filtra i record in base all'attività/al task completato dall'agente. I valori possibili sono: 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[] | FALSE | Array[Stringa] | Filtra la risposta in base all'ID agente. Whodunnit è un sottoinsieme dell'oggetto agente e utilizza lo stesso agent_id come chiave primaria |
| call_id[] | FALSE | Array[Stringa] | Filtra i record in base agli ID chiamata inseriti |
| chat_id[] | FALSE | Array[Stringa] | Filtra i record in base agli ID chat inseriti |
Endpoint:
Method: GET
Type:
URL: https://{{subdomain}}.{{domain}}/manager/api/v1/agent_activity_logs
Altri esempi di richieste/risposte:
Richiesta di esempio: esempio di log delle attività dell'agente
Body: None
Esempio di risposta: esempio di log delle attività dell'agente
[
{
"id": 190578,
"agent_id": 118,
"status": {
"id": -10,
"name": "Offline",
"color": "grey",
"wfm_id": 36
},
"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",
"wfm_id": 36
},
"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",
"wfm_id": 36
},
"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",
"wfm_id": 36
},
"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",
"wfm_id": 12
},
"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",
"wfm_id": 12
},
"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",
"wfm_id": 36
},
"started_at": "2017-06-19T18:34:39.000Z",
"ended_at": null,
"duration": 0,
"call_id": null,
"chat_id": null,
"activity": "login",
"whodunnit": null
}
]
Codice di stato: 200