Questa pagina descrive i dati degli eventi della sessione di chiamata che Contact Center AI Platform (CCAI Platform) può esportare nell'applicazione di gestione della qualità (QM). Per saperne di più sull'integrazione di CCAI Platform con l'applicazione QM, consulta Integrazione di QM, SIPREC e WFM.
Per i dati sugli eventi della sessione di chat, vedi Dati sugli eventi della sessione di chat QM.
Eventi e trigger della sessione di chiamata
Alcuni eventi della sessione di chiamata attivano l'esportazione dei dati della sessione di chiamata nell'applicazione QM. Questa sezione elenca i tipi di eventi di chiamata e le azioni che attivano ciascuno di essi. Include anche un esempio di payload dell'evento di sessione per ciascun tipo di evento di sessione.
L'agente accede
Questo evento viene attivato dalle seguenti azioni:
Un agente accede all'adattatore dell'agente utilizzando il portale Contact Center AI Platform.
Un agente accede all'adattatore dell'agente utilizzando un CRM.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "AgentState",
"item" : {
"ParticipantID" : "1234",
"Email" : "some.email@domain.com",
"State" : "login"
}
}
L'agente esce
Questo evento viene attivato dalle seguenti azioni:
Un agente esce dall'adattatore dell'agente utilizzando il portale Contact Center AI Platform.
Un agente esegue la disconnessione dall'adattatore agente utilizzando un CRM.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "AgentState",
"item" : {
"ParticipantID" : "1234",
"Email" : "some.email@domain.com",
"State" : "logout"
}
}
La chiamata in entrata viene proiettata
Questo evento viene attivato quando un utente finale effettua una chiamata al contact center e la chiamata viene inoltrata a un agente.
Questo evento si applica solo quando la chiamata viene proiettata per deltacast. Le proiezioni multicast non attivano eventi. Solo la prima proiezione deltacast per la chiamata in un gruppo a cascata attiva un evento.
Questo evento include le proiezioni delle chiamate ricevute tramite trasferimenti, reindirizzamenti e deviazioni delle chiamate.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "ringing",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "ringing"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
Risposta alla chiamata in entrata
Questo evento viene attivato quando un agente risponde a una chiamata proiettata.
Questo evento si applica quando la chiamata riceve risposta da un agente per le proiezioni deltacast o multicast. Questo evento si applica alle chiamate ricevute e risposte tramite reindirizzamenti e deviazioni delle chiamate.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
La chiamata in uscita sta squillando
Questo evento viene attivato dalle seguenti azioni:
Un agente compone un nuovo numero per una chiamata in uscita e la chiamata squilla per un utente finale.
Un agente compone una chiamata di aggiunta di un partecipante e la chiamata squilla per una terza parte.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "e9dd62bb",
"State" : "dialing",
"Direction" : "outgoing",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
},
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
La chiamata in uscita riceve risposta
Questo evento viene attivato dalle seguenti azioni:
Un utente finale risponde a una chiamata in uscita.
Una terza parte risponde a una chiamata di aggiunta di partecipanti.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "e9dd62bb",
"State" : "connected",
"Direction" : "outgoing",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
},
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
La chiamata viene messa in attesa
Questo evento viene attivato dalle seguenti azioni:
Un agente mette in attesa un utente finale.
Un agente mette in attesa una terza parte.
Il seguente esempio di codice mostra il payload dell'evento:
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "held",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "held"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
La chiamata viene rimossa dall'attesa
Questo evento viene attivato dalle seguenti azioni:
Un agente rimuove un utente finale dalla sospensione.
Un agente rimuove una terza parte dalla sospensione.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
Il trasferimento a freddo viene avviato e accettato
Questo evento viene attivato dalle seguenti azioni:
Un agente effettua una chiamata di trasferimento a freddo a un altro agente e il trasferimento viene accettato.
Un agente effettua una chiamata di trasferimento a freddo a un'altra coda e il trasferimento viene accettato da un agente di quella coda.
Un agente invita un altro agente a una conferenza telefonica e quest'ultimo accetta e partecipa alla conferenza telefonica.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "transferred",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "4321",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
Il trasferimento a caldo viene avviato e accettato
Questo evento viene attivato dalle seguenti azioni:
Un agente effettua una chiamata di trasferimento a caldo a un altro agente e il trasferimento viene accettato.
Un agente effettua una chiamata di trasferimento a caldo a un'altra coda e il trasferimento viene accettato da un agente di quella coda.
Un agente invita un altro agente a una conferenza telefonica e l'altro accetta e partecipa alla conferenza telefonica.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "conferenced",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
},
{
"ParticipantID" : "4321",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
L'agente abbandona una conferenza telefonica
Questo evento viene attivato quando un agente in una conferenza telefonica abbandona la conferenza telefonica senza terminarla.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "participantDisconnect",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "disconnected"
},
{
"ParticipantID" : "4321",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
La chiamata è disattivata
Questo evento viene attivato dalle seguenti azioni:
Un agente disattiva l'audio di una chiamata.
Un agente disattiva l'audio degli altri partecipanti a una chiamata.
Questo evento si applica a tutte le chiamate.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,\
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "muted"
},
{
"ParticipantID" : "4321",
"Type" : "agent",
"State" : "muted"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
L'audio della chiamata è stato riattivato
Questo evento viene attivato dalle seguenti azioni:
Un agente riattiva l'audio di una chiamata.
Un agente riattiva l'audio degli altri partecipanti a una chiamata.
Questo evento si applica a tutte le chiamate.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "unmuted"
},
{
"ParticipantID" : "4321",
"Type" : "agent",
"State" : "unmuted"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
La chiamata è stata oscurata
Questo evento viene attivato quando un agente oscura una chiamata.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "redacted"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "redacted"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
La chiamata non è modificata
Questo evento viene attivato quando un agente ripristina una chiamata.
Il seguente esempio di codice mostra il payload dell'evento:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "unredacted"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "unredacted"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
La chiamata è terminata
Questo evento viene attivato dalle seguenti azioni:
Un utente finale termina una chiamata.
Un agente termina una chiamata.
Questo evento si applica a tutte le chiamate.
Il seguente esempio di codice mostra il payload dell'evento di chiamata in entrata:
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "disconnected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "disconnected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "disconnected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
Il seguente esempio di codice mostra il payload dell'evento di chiamata in uscita:
{
"type" : "CallState",
"item" : {
"CallID" : "e9dd62bb",
"State" : "disconnected",
"Direction" : "outgoing",
"Initiator" : "1234",
"Participants" :
[
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "disconnected"
},
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "disconnected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
Campi evento sessione di chiamata
Le tabelle seguenti descrivono i campi nei dati di sessione che Contact Center AI Platform esporta nell'applicazione QM.
Campi generali
| Nome campo | Valori consentiti | Descrizione | Effetto |
|---|---|---|---|
type |
|
Il tipo di evento del payload JSON complessivo. |
|
|
L'oggetto con le informazioni sull'evento. |
Campi dello stato dell'agente
| Nome campo | Valori | Descrizione | Comportamento |
|---|---|---|---|
|
Un ID agente |
Disponibile nell'oggetto L'identificatore dell'agente nel sistema Contact Center AI Platform. |
|
|
Un indirizzo email |
Disponibile nell'oggetto L'indirizzo email dell'agente. |
|
|
|
Disponibile nell'oggetto Lo stato dell'agente al momento dell'evento. |
|
Campi dello stato di chiamata
| Nome campo | Valori | Descrizione | Comportamento |
|---|---|---|---|
|
L'ID chiamata |
Disponibile nell'oggetto L'identificatore della sessione di chiamata nel sistema Contact Center AI Platform. |
|
|
|
Disponibile nell'oggetto Lo stato attuale della sessione di chiamata. |
|
|
|
Disponibile nell'oggetto La direzione della sessione di chiamata dal punto di vista del contact center. |
|
|
|
Disponibile nell'oggetto L'identificatore della parte che inizializza lo stato della chiamata. |
|
|
Un percorso di ID coda |
Disponibile nell'oggetto Il percorso della coda seguito dall'utente finale prima di raggiungere il primo agente della chiamata. Questo valore viene creato utilizzando gli ID coda della coda a cui è stata eseguita la navigazione. |
Questa opzione si applica solo alle chiamate in arrivo. |
|
Un percorso di nomi di code |
Disponibile nell'oggetto Il percorso della coda seguito dall'utente finale prima di raggiungere il primo agente della chiamata. Questo valore viene creato utilizzando i nomi delle code della coda a cui è stata eseguita la navigazione. |
Questa opzione si applica solo alle chiamate in arrivo. |
|
Il codice lingua |
Disponibile nell'oggetto Il codice lingua della lingua selezionata dall'utente finale. |
Questa opzione si applica solo alle chiamate in arrivo. |
|
L'ID coda |
Disponibile nell'oggetto L'UUID della coda a cui arriva la chiamata. |
Questo vale solo per le chiamate in arrivo e le chiamate trasferite in coda. |
|
Un valore booleano |
Disponibile nell'oggetto Indica se la registrazione delle chiamate è consentita per la chiamata specifica |
|
|
intestazioni personalizzate |
Disponibile nell'oggetto Questo campo viene utilizzato per trasmettere dati personalizzati come le intestazioni SIP |
|
|
Questo oggetto è nidificato nell'oggetto Un oggetto contenente le informazioni del partecipante alla chiamata. |
||
|
|
Disponibile nell'oggetto L'identificatore del partecipante alla chiamata. |
Passa il valore del campo ID nell'oggetto
Passa il valore del campo
Trasmette il numero di telefono dell'utente finale, se disponibile. In caso contrario, passa il valore del campo
Trasmette il numero di telefono della terza parte, se disponibile. Altrimenti, passa il valore: |
|
|
Disponibile nell'oggetto Il tipo di partecipante alla chiamata. |
|
|
|
Disponibile nell'oggetto Lo stato attuale del partecipante nella conferenza telefonica. |
|
|
|
Disponibile nell'oggetto L'identificatore dei contenuti multimediali della sessione di chiamata dell'operatore. |
|