Questo documento descrive i codici e gli stati dei motivi delle chiamate e delle chat utilizzati nella piattaforma CCAI.
Stati di presenza
| Tempo disponibile | La somma del tempo in cui gli agenti erano inattivi e pronti a gestire un'interazione. |
| Ora di accesso | La somma del tempo in cui gli agenti hanno eseguito l'accesso. |
| Tempo di wrap up | La somma del tempo in cui gli agenti erano nello stato di wrap up dopo aver terminato un'interazione. |
| Pausa | La somma del tempo in cui gli agenti erano nello stato In pausa. |
| Tempo di inattività | La somma del tempo in cui gli agenti erano nello stato Inattivo. |
| Tempo di chiamata | La somma del tempo in cui gli agenti hanno gestito le chiamate. |
| In-chat Time | La somma del tempo in cui gli agenti hanno gestito le chat. |
| Ora dei pasti | La somma del tempo in cui gli agenti erano nello stato Pasto. |
| Ora della chiamata senza risposta | La somma del tempo in cui gli agenti erano nello stato Chiamata senza risposta. |
| Tempo di chat non utilizzato | La somma del tempo in cui gli agenti erano nello stato Chat senza risposta. |
| Tempo offline | La somma del tempo in cui gli agenti sono stati disconnessi. |
| Tempo per attività speciali | La somma del tempo in cui gli agenti sono stati nello stato Attività speciale. |
| Tempo non disponibile | La somma del tempo in cui gli agenti erano nello stato Non disponibile. |
| Tempo di mancata risposta | La somma del tempo in cui gli agenti sono stati nello stato Non risponde. |
Visualizza e identifica i codici motivo degli errori
Questa pagina può aiutarti a identificare:
È possibile visualizzare i seguenti codici dei motivi di errore:
Nel report standard Cronologia chiamate individuali.
Utilizzando l'API.
Motivi della mancata chiamata
| Codice | Nome metrica | Descrizione |
|---|---|---|
| nothing: 0 | Nessun errore - Chiamata | La somma delle chiamate che non hanno avuto esito negativo. |
| unknown: 10001 | Sconosciuto - Chiamata | La somma delle chiamate non riuscite per motivi sconosciuti. |
| expired: 11001 | Scaduto - Chiamata | La somma delle chiamate non riuscite a causa del timeout della connessione. |
| transfer_expired: 11002 | Trasferimento scaduto | La somma delle chiamate non riuscite a causa del timeout della connessione di trasferimento. |
| eu_canceled: 20001 | Annullato | La somma delle chiamate in cui l'utente finale ha riagganciato durante la connessione a un agente. |
| eu_rejected: 20002 | Rifiutato | La somma delle chiamate in uscita rifiutate dall'utente finale. |
| eu_abandoned: 20003 | Abbandonata | La somma delle chiamate abbandonate dall'utente finale durante l'attesa in coda. |
| eu_in_menu_abandoned: 20004 | Abbandono nel menu | La somma delle chiamate abbandonate dall'utente finale mentre si trovava nel menu IVR. |
| eu_repeated_voicemail: 20005 | Messaggio vocale ripetuto |
La somma delle chiamate non riuscite perché l'utente finale aveva già lasciato un messaggio vocale in attesa di risposta. Per ulteriori informazioni sulle impostazioni della segreteria, consulta Deviazione fuori orario per chiamate e chat. |
| eu_repeated_callback: 20006 | Richiamata ripetuta | La somma delle chiamate non andate a buon fine perché l'utente finale aveva già richiesto un richiamo. |
| eu_busy: 21001 | Occupato | La somma delle chiamate in uscita che hanno raggiunto l'utente finale in stato di occupato. |
| eu_wrong_number: 21002 | Numero errato | La somma delle chiamate in uscita effettuate a un numero di telefono non valido. |
| eu_no_answer: 21003 | Nessuna risposta | La somma delle chiamate in uscita a cui l'utente finale non ha risposto. |
| eu_noti_failed: 22001 | Notifica non riuscita | La somma delle chiamate che non sono state connesse all'agente perché quest'ultimo non ha attivato le notifiche del browser. |
| ag_canceled: 30001 | Agente annullato | La somma delle chiamate non riuscite durante la connessione all'agente. I possibili motivi includono la chiusura del browser da parte dell'agente o un errore di rete. |
| ag_hung_up_to_callback: 30002 | Stato della chiamata | L'agente umano riaggancia la chiamata a causa di problemi di audio o di rete, con l'intenzione di richiamare. |
| ag_ignored: 30002 | Agente ignorato | La somma delle chiamate a cui l'agente non ha risposto. |
| ag_mic_no_device: 31001 | Agente senza microfono | La somma delle chiamate non riuscite perché l'agente non disponeva di un microfono. |
| ag_mic_denied: 31002 | Accesso al microfono dell'agente negato | La somma delle chiamate non riuscite perché l'agente non ha attivato l'accesso al microfono. |
| ag_called_blocked_num 32002 | Chiamata agentica a numero bloccato | Il consumatore sta bloccando la chiamata. |
| Impossibile connettere la chiamata al numero di telefono composto 32003 | Timeout della connessione dell'agente | La somma delle chiamate che non sono state connesse perché il dispositivo dell'agente ha perso la connettività di rete o non è riuscito a registrarsi al server. |
| voip_twilio_error: 41001 | Errore VoIP | La somma delle chiamate non riuscite a causa di un problema del provider vocale. |
| voip_tokbox_error: 42001 | Errore VoIP | La somma delle chiamate non riuscite a causa di un problema con il fornitore di servizi vocali Tokbox. |
| voip_invalid_token: 43001 | Token VoIP non valido | La somma delle chiamate non riuscite perché il provider vocale ha fornito un token non valido. |
| voip_conn_general: 44001 | VOIP General | La somma delle chiamate non riuscite a causa di un problema generale del provider vocale. |
| voip_conn_timeout: 44002 | Timeout VOIP | La somma delle chiamate non riuscite a causa del timeout della connessione del provider vocale. |
| voip_conn_signal: 44003 | Segnale VoIP | La somma delle chiamate non riuscite a causa di una connessione scadente con il provider vocale. |
| voip_nexmo_error: 45001 | Errore VoIP | La somma delle chiamate non riuscite a causa di un problema con il provider vocale Nexmo. |
| stuck_due_to_api_error: 50001 | Blocco dovuto all'API | La somma delle chiamate non riuscite a causa di un problema dell'API. |
| group_deleted_no_substitute: 50002 | Gruppo eliminato - Chiamata | La somma delle chiamate non riuscite a causa dell'eliminazione di un gruppo di distribuzione a cascata senza alcuna alternativa disponibile. |
| menu_deleted: 50003 | Menu eliminato | La somma delle chiamate non riuscite perché la coda è stata eliminata dopo che l'utente finale era già entrato in coda. |
| direct_pstn_call_to_fallback_number: 60001 | Indirizzato al fallback | La somma delle chiamate indirizzate a un numero di riserva. |
Motivi dell'errore della chat
| Code | Nome metrica | Descrizione |
| nothing: 0 | Nessun errore - Chat | La somma delle chat che non hanno avuto esito negativo. |
| unknown: 1 | Sconosciuto - Chat | La somma delle chat non riuscite per motivi sconosciuti. |
| no_response: 2 | Nessuna risposta | La somma delle chat terminate perché l'utente finale non ha risposto. |
| expired: 3 | Scaduta - Chat | La somma delle chat non riuscite a causa del timeout della connessione. |
| after_hours: 4 | After Hours | La somma delle chat che hanno raggiunto una coda al di fuori dell'orario di apertura. |
| expired_menu_selection: 31 | Menu scaduto | La somma delle chat in cui gli utenti finali hanno selezionato una coda che non esisteva più. |
| end_user_opt_out: 41 | Disattivata | La somma delle chat in cui gli utenti finali hanno scelto di non essere registrati. |
| over_cap_email: 50001 | Email di sovracapacità | La somma delle chat in cui gli utenti finali hanno inviato un'email perché la coda era in stato di sovracapacità. |
| group_deleted_no_substitute: 60001 | Gruppo eliminato - Chat | La somma delle chat non riuscite a causa dell'eliminazione di un gruppo di distribuzione a cascata senza alternative disponibili. |
Dizionario dei dati: API di esempio e script di calcolo
Di seguito sono riportati alcuni script di esempio per l'API e i calcoli.
Script di calcolo e API di esempio
Questo è uno script di esempio che può essere eseguito per provare un paio di metriche di CCAI Platform presenti nella dashboard del portale di amministrazione. Mostra come è possibile recuperare e calcolare qualsiasi metrica.
L'esempio illustra la definizione di variabili, funzioni e script di calcolo per calcolare il volume totale e il livello di servizio.
Variabili
Array di chiamate: aggiungi un array di chiamate impostato sulla variabile callsArray.
Tipi di chiamata: un array di tutti i tipi di chiamata esistenti nella piattaforma CCAI.
//Puoi rimuovere elementi da questo array per testare le metriche di un solo tipo di chiamate, ad esempio:
Total hours: è una variabile delle ore totali. Calcola la differenza in ore in base ai parametri della richiesta.
SLA: viene calcolato utilizzando una soglia configurata nel portale dell'amministratore. Modifica la variabile con l'importo configurato. Questo esempio mostra uno SLA di 60 secondi, ad esempio:
Funzioni
Funzione di registrazione delle chiamate: //checkCallRecord è progettata per convalidare se un record di chiamata è nello stato corretto, non ha avuto esito negativo in un determinato modo e, in alcuni casi, se il valore di connessione è null;
Funzione del volume totale delle chiamate: getTotalVolumeOfCalls è progettata per restituire un volume totale di chiamate, ad esempio:
Funzione del livello di servizio: getServiceLevel è progettata per restituire il livello di servizio di un tipo di chiamata, ad esempio:
Script di calcolo
Script di calcolo di esempio.
Per il volume totale:
// TOTAL VOLUME SECTION
for(var i = 0; i\<call_type.length;i++){
var vol = getTotalVolumeOfCalls(callsArray,call_type\[i\]);
if(vol \> 0){
var volPerHour = Math.round(vol/total_hours\*10)/10
var stringToPrint = \"the per hour volume of \"+call_type\[i\]+\" is \"+
volPerHour.toString()
console.log(stringToPrint);
};
}
Per lo SLA:
// SLA SECTION
for(var i = 0;i\<call_type.length;i++){
var SLACalc =
(getServiceLevel(callsArray,call_type\[i\])/getTotalVolumeOfCalls(callsArray,call_type\[i\],false,\['eu_in_menu_abandoned'\]));
if (isNaN(SLACalc) == false){
var stringToPrint = \"the SLA of \"+call_type\[i\]+\" is \"+
SLACalc.toString();
console.log(stringToPrint);
} else {
var stringToPrint = \"the SLA of \"+call_type\[i\]+\" cannot be
calculated due to lack of volume\";
console.log(stringToPrint);
}
};
Definizioni degli stati della chat
Stati comuni della chat
| Stati di Chat | Descrizione |
| In coda | La chat è in coda e in attesa di un agente |
| Assegnata | La chat è assegnata a un agente |
| In corso | La chat è attiva con un agente e un utente finale |
| Terminato | Chat terminata correttamente (motivi della fine elencati di seguito) |
| Abbandonata | Chat annullata dall'utente finale prima dell'assegnazione a un agente |
| Deviata | La chat è stata annullata e deviata all'email di sovraccapacità |
| Non riuscito | Chat non riuscita (motivi dell'errore elencati) |
Stati di chat terminata
| Stati delle chat terminate | Descrizione |
|---|---|
| Terminato | Chat terminata correttamente senza ulteriori informazioni |
| Terminata: disconnessione da parte dell'agente | La chat è stata terminata, l'agente si è disconnesso |
| Finished: Disconnected By End User | Chat terminata, disconnessa dall'utente finale |
| Completata: nessun messaggio | La chat è terminata, non è stata ricevuta alcuna risposta |
| Terminato: nessun messaggio, disconnessione da parte dell'agente | La chat è stata terminata, non è stata ricevuta alcuna risposta e l'agente si è disconnesso |
| Finished: No Messages Disconnected By End User (Operazione completata: nessun messaggio disconnesso dall'utente finale) | La chat è stata terminata, non è stata ricevuta alcuna risposta e l'utente finale si è disconnesso |
| Timeout: Timeout By Agent With No Messages | La chat è scaduta e l'agente non ha mai inviato un messaggio durante la gestione della chat. Per le chat riassegnate da un agente virtuale, vengono conteggiati solo i messaggi dell'agente umano. |
| Timeout: Timeout By End User With No Messages | La chat è scaduta e l'utente finale non ha mai inviato un messaggio in nessun momento della chat, nemmeno all'agente virtuale prima di un'escalation. Se l'utente finale ha inviato almeno un messaggio in precedenza nella chat e poi non ha più risposto, la chat viene registrata come "Timeout: l'utente finale ha smesso di rispondere". |
| Timeout: l'agente ha smesso di rispondere | La chat è scaduta mentre l'ultimo messaggio senza risposta era dell'utente finale; l'agente aveva risposto in precedenza, ma poi ha smesso. |
| Timeout: l'utente finale ha smesso di rispondere | La chat è scaduta dopo che l'utente finale ha smesso di rispondere. L'utente finale ha inviato almeno un messaggio in precedenza nella chat, all'agente virtuale o all'agente, e poi non ha più risposto. |
Valori dei motivi di fine della chat (esportazione della chat in BigQuery)
| Valore | Definizione |
|---|---|
| 0 | Nessun motivo di fine specifico. Lo stato visualizzato ("Terminata" / "Terminata: disconnessione da parte dell'agente" / "Terminata: disconnessione da parte dell'utente finale") è determinato dalla colonna disconnected_by (0 = sconosciuto, 1 = agente, 2 = utente finale). |
| 1 | Nessuna risposta. Corrisponde agli stati "Terminato: nessun messaggio", combinati con disconnected_by come descritto in precedenza. |
| 2 | Timeout: Timeout By Agent With No Messages |
| 3 | Timeout: l'agente ha smesso di rispondere |
| 4 | Timeout: l'agente ha smesso di rispondere |
| 5 | Timeout: l'utente finale ha smesso di rispondere |
| 6 | L'utente finale ha disattivato le comunicazioni (ad esempio, ha risposto STOP via SMS) |
| 7 | Timeout del check-in del consumatore |
| 8 | Chat terminata dall'orchestrazione dell'API (risultato end_chat del punto di accesso diretto) |
Motivi dell'errore della chat
| Motivo dell'errore | Definizione |
|---|---|
| Non riuscito | Sessione di chat non riuscita per un motivo sconosciuto |
| Scaduto | La chat è scaduta in una coda e non è stata presa in carico da un agente |
Definizioni degli stati delle chiamate
Nel report sulla cronologia del rendimento delle chiamate possono essere visualizzati i seguenti stati delle chiamate.
| Stato della chiamata | Descrizione |
|---|---|
| Abbandonata | Una chiamata è in attesa nella coda e viene disconnessa dal chiamante prima di essere accettata da un agente. Sono esclusi gli abbandoni nel menu e gli abbandoni rapidi. |
| Occupato | L'utente finale era occupato |
| Annullato | L'utente finale ha annullato la chiamata |
| Completato | Una chiamata viene completata correttamente senza errori |
| Errore | La chiamata contiene un errore |
| Non riuscito | Una chiamata termina a causa di un errore. Include un motivo dell'errore per fornire un contesto più ampio. |
| Nessuna risposta | L'utente finale non ha risposto |
| Recuperato | Una chiamata non riuscita viene richiamata. La nuova chiamata è un elemento secondario della chiamata originale. Include se il callback viene completato senza errori. |