L'adattatore dell'agente può utilizzare l'API postMessage() del browser per inviare eventi all'iFrame padre. Questi eventi possono essere utilizzati da JavaScript nell'iFrame padre e utilizzati per intraprendere varie azioni nell'implementazione CRM personalizzata. Per farlo, l'applicazione deve ascoltare il MessageEvent nella finestra principale. In base agli eventi, l'applicazione può attivare azioni come l'apertura di una scheda del ticket per un ID sessione specifico. Sia l'adattatore di chiamata sia l'adattatore di chat hanno eventi specifici che possono essere utilizzati per migliorare le funzionalità CRM.
Contact Center AI Platform supporta i seguenti eventi dell'assistente virtuale per le attività:
Assistente virtuale per le attività aggiunto
Assistente virtuale per le attività rimosso
Variabili di sessione personalizzate dell'assistente virtuale per le attività ricevute
Per un elenco completo degli eventi post relativi agli adattatori dell'agente, consulta Adattatori dell'agente.
Assistente virtuale per le attività aggiunto
Questo evento viene trasmesso quando l'assistente virtuale per le attività si unisce a una sessione.
Campi dati
call_id. L'identificatore di una sessione vocale (IVR).chat_id. L'identificatore di una sessione di chat web o mobile.campaign_id: l'identificatore di una chiamata della campagna.campaign_name: il nome della campagna.virtual_agent_id: l'identificatore di un assistente virtuale per le attività.virtual_agent_name: il nome dell'assistente virtuale per le attività.participant_id: l'identificatore del partecipante per l'assistente virtuale per le attività.queue_id: l'identificatore della coda da cui ha avuto origine la sessione. Questo identificatore è incluso solo quando la sessione ha origine da una coda.queue_path: il percorso della coda da cui ha avuto origine la sessione. Questo identificatore è incluso solo quando la sessione ha origine da una coda.queue_language_id: la lingua della coda da cui ha avuto origine la sessione. Questo identificatore è incluso solo quando la sessione ha origine da una coda.session_type: il tipo di sessione, ad esempio messaggi in entrata tramite chat web.conversation_id: l'identificatore delle sessioni dell'agente virtuale che utilizzano i profili di conversazione.session_id: l'identificatore delle sessioni dell'agente virtuale che non utilizzano i profili di conversazione.timestamp: la data e l'ora di un evento.data_parameters: le variabili configurate nel portale di Contact Center AI Platform e inviate all'assistente virtuale per le attività.
Esempio di payload
{
"type": "Task_VA_Joined",
"data": {
"chat_id": 103646,
"campaign_id": 1432,// omitted if not available
"campaign_name": "Survey Movie", // omitted if not available
"virtual_agent_id": 1,
"virtual_agent_name": "name",
"participant_id": 1,
"queue_id": 8469, // omitted if not available
"queue_path": "Developers / James", // omitted if not available
"queue_language_id": "en", // omitted if not available
"session_type": "Messaging Inbound (SMS)",
"conversation_id": "12345",
"session_id": "78534G4RT4284", // omitted if not available
"timestamp": "1727853575",
"data_parameters": {
"param1": "one",
"param2": "two"
}
}
}
Assistente virtuale per le attività rimosso
Questo evento viene trasmesso quando l'assistente virtuale per le attività lascia la sessione.
Campi dati
call_id. L'identificatore di una sessione vocale (IVR).chat_id. L'identificatore di una sessione di chat web o mobile.campaign_id: l'identificatore di una chiamata della campagna.campaign_name: il nome della campagna.virtual_agent_id: l'identificatore di un assistente virtuale per le attività.virtual_agent_name: il nome dell'assistente virtuale per le attività.participant_id: l'identificatore del partecipante per l'assistente virtuale per le attività.queue_id: l'identificatore della coda da cui ha avuto origine la sessione. Questo identificatore è incluso solo quando la sessione ha origine da una coda.queue_path: il percorso della coda da cui ha avuto origine la sessione. Questo identificatore è incluso solo quando la sessione ha origine da una coda.queue_language_id: la lingua della coda da cui ha avuto origine la sessione. Questo identificatore è incluso solo quando la sessione ha origine da una coda.session_type: il tipo di sessione, ad esempio messaggi in entrata tramite chat web.conversation_id: l'identificatore delle sessioni dell'agente virtuale che utilizzano i profili di conversazione.session_id: l'identificatore delle sessioni dell'agente virtuale che non utilizzano i profili di conversazione.timestamp: la data e l'ora di un evento.finish_reason: il motivo della fine della sessione dell'agente virtuale.data_parameters: le variabili configurate nel portale di Contact Center AI Platform e inviate all'assistente virtuale per le attività.captured_variables: le variabili di sessione acquisite dall'assistente virtuale per le attività.
Esempio di payload
{
"type": "Task_VA_Left",
"data": {
"chat_id": 103646,
"campaign_id": 1432, // omitted if not available
"campaign_name": "Survey Movie", // omitted if not available
"virtual_agent_id": 1,
"virtual_agent_name": "name",
"participant_id": 1,
"queue_id": 8469, // omitted if not available
"queue_path": "Developers / James", // omitted if not available
"queue_language_id": "en", // omitted if not available
"session_type": "Messaging Inbound (SMS)",
"conversation_id": "12345",
"session_id": "78534G4RT4284", // omitted if not available
"timestamp": "1727853575",
"finish_reason": "Task VA failed", // Finish reason passed when the VTA session ends
"data_parameters": {
"param1": "one",
"param2": "two"
},
"captured_variables": [
{
"intent_name": null,
"variables": {
"testkey": "testvalue"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp": "1727853575"
},
{
"intent_name": null,
"variables": {
"testkey2": "testvalue2"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp": "1727853575"
}
]
}
}
Variabili di sessione dell'assistente virtuale per le attività ricevute
Questo evento viene trasmesso quando l'assistente virtuale per le attività invia un payload di variabili di sessione personalizzate.
Campi dati
call_id. L'identificatore di una sessione vocale (IVR).chat_id. L'identificatore di una sessione di chat web o mobile.campaign_id: l'identificatore di una chiamata della campagna.campaign_name: il nome della campagna.virtual_agent_id: l'identificatore di un assistente virtuale per le attività.virtual_agent_name: il nome dell'assistente virtuale per le attività.queue_id: l'identificatore della coda da cui ha avuto origine la sessione. Questo identificatore è incluso solo quando la sessione ha origine da una coda.queue_path: il percorso della coda da cui ha avuto origine la sessione. Questo identificatore è incluso solo quando la sessione ha origine da una coda.queue_language_id: la lingua della coda da cui ha avuto origine la sessione. Questo identificatore è incluso solo quando la sessione ha origine da una coda.session_type: il tipo di sessione, ad esempio messaggi in entrata tramite chat web.conversation_id: l'identificatore delle sessioni dell'agente virtuale che utilizzano i profili di conversazione.session_id: l'identificatore delle sessioni dell'agente virtuale che non utilizzano i profili di conversazione.timestamp: la data e l'ora di un evento.data_parameters: le variabili configurate nel portale di Contact Center AI Platform e inviate all'assistente virtuale per le attività.captured_variables: le variabili di sessione acquisite dall'assistente virtuale per le attività.
Esempio di payload
{
"type": "Task_VA_Variables_Received",
"data": {
"chat_id": 103646,
"campaign_id": 1432, // omitted if not available
"campaign_name": "Survey Movie", // omitted if not available
"virtual_agent_id": 1,
"virtual_agent_name": "name",
"participant_id": 1,
"queue_id": 8469, // omitted if not available
"queue_path": "Developers / James", // omitted if not available
"queue_language_id": "en", // omitted if not available
"session_type": "Messaging Inbound (SMS)",
"conversation_id": "12345",
"session_id": "78534G4RT4284", // omitted if not available
"timestamp": "1727853575",
"data_parameters": {
"param1": "one",
"param2": "two"
},
"captured_variables": [
{
"intent_name": null,
"variables": {
"testkey_1": "testvalue"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp": "1727853575"
},
{
"intent_name": null,
"variables": {
"testkey_2": "testvalue2"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp" : "1727853575"
}
]
}
}
Payload di Dialogflow per le variabili di sessione personalizzate
Il payload di variabili di sessione personalizzate di Dialogflow supporta gli eventi post dell'assistente virtuale per le attività.
Le proprietà disponibili nel payload delle variabili di sessione del cliente includono le seguenti:
capture_type:event: indica che i valori restituiti nel payload delle variabili di sessione del cliente devono essere passati negli eventi post dell'assistente virtuale per le attività.capture_type:agent: indica che i valori restituiti nel payload delle variabili di sessione del cliente devono essere passati nell'adattatore dell'agente.capture_type:comment: indica che i valori restituiti nel payload delle variabili di sessione del cliente devono essere passati nel record CRM come commento.invisible_to_adapter_events. I valori delle chiavi specificate in questa proprietà devono essere esclusi dagli eventi post dell'assistente virtuale per le attività.
Esempio di payload
{
"ujet": {
"session_variable": {
"payload": {
"key_two": "$session.params.favfood",
"key_three": "$session.params.budget",
"key_one": "$session.params.location",
"key_four": "$session.params.startdate",
"key_five": "$session.params.enddate"
},
"capture_type": [
"comment",
"agent",
"event"
],
"capture_target": "payload",
"invisible_to_agent": [
"key_one",
"key_two"
],
"invisible_to_adapter_events": [
"key_three",
"key_two"
]
}
}
}