Codici dei motivi e stati

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:

Motivi della mancata risposta

Motivi degli errori di Chat

È possibile visualizzare i seguenti codici dei motivi di errore:

  • Nel report standard Cronologia chiamate individuali.

  • Nelle dashboard per Chiamate e Chat completate.

  • 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.