Der Agent-Adapter kann die postMessage()-API des Browsers verwenden, um Ereignisse an den übergeordneten iFrame zu senden. Diese Ereignisse können von JavaScript in Ihrem übergeordneten iFrame genutzt werden, um verschiedene Aktionen in Ihrer benutzerdefinierten CRM-Implementierung auszuführen. Dazu muss Ihre Anwendung im übergeordneten Fenster auf das MessageEvent warten. Anhand der Ereignisse kann Ihre Anwendung Aktionen auslösen, z. B. das Öffnen eines Ticket-Tabs für eine bestimmte Sitzungs-ID. Sowohl der Anruf- als auch der Chat-Adapter haben bestimmte Ereignisse, die zur Verbesserung der CRM-Funktionen verwendet werden können.
Die Contact Center AI Platform unterstützt die folgenden Ereignisse für virtuelle Assistenten:
Virtueller Taskassistent ist beigetreten
Virtueller Aufgabenassistent verbleibend
Benutzerdefinierte Sitzungsvariablen für den virtuellen Aufgabenassistenten empfangen
Eine vollständige Liste der Post-Ereignisse im Zusammenhang mit Agent-Adaptern finden Sie unter Agent-Adapter.
Virtueller Taskassistent ist beigetreten
Dieses Ereignis wird übergeben, wenn der virtuelle Aufgabenassistent einer Sitzung beitritt.
Datenfelder
call_id: Die Kennung für eine Sprach- (IVR-)Sitzung.chat_id: Die Kennung für eine Web- oder mobile Chatsitzung.campaign_id: Die Kennung für einen Kampagnenanruf.campaign_name: Der Name der Kampagne.virtual_agent_id: Die Kennung für einen virtuellen Aufgabenassistenten.virtual_agent_name: Der Name des virtuellen Assistenten.participant_id: Die Teilnehmer-ID für den virtuellen Aufgabenassistenten.queue_id: Die Kennung für die Warteschlange, aus der die Sitzung stammt. Diese Kennung ist nur enthalten, wenn die Sitzung aus einer Warteschlange stammt.queue_path: Der Pfad der Warteschlange, aus der die Sitzung stammt. Diese Kennung wird nur angegeben, wenn die Sitzung aus einer Warteschlange stammt.queue_language_id: Die Sprache der Warteschlange, aus der die Sitzung stammt. Diese Kennung ist nur enthalten, wenn die Sitzung aus einer Warteschlange stammt.session_type: Der Sitzungstyp, z. B. eingehende Nachrichten über den Webchat.conversation_id: Die Kennung für Sitzungen mit virtuellen Agenten, in denen Konversationsprofile verwendet werden.session_id: Die Kennung für Sitzungen mit virtuellen Kundenservicemitarbeitern, in denen keine Unterhaltungsprofile verwendet werden.timestamp: Das Datum und die Uhrzeit eines Ereignisses.data_parameters: Die im CCAI Platform-Portal konfigurierten und an den virtuellen Kundenservicemitarbeiter gesendeten Variablen.
Beispiel für Nutzlast
{
"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"
}
}
}
Virtueller Aufgabenassistent verbleibend
Dieses Ereignis wird übergeben, wenn der virtuelle Aufgabenassistent die Sitzung verlässt.
Datenfelder
call_id: Die Kennung für eine Sprach- (IVR-)Sitzung.chat_id: Die Kennung für eine Web- oder mobile Chatsitzung.campaign_id: Die Kennung für einen Kampagnenanruf.campaign_name: Der Name der Kampagne.virtual_agent_id: Die Kennung für einen virtuellen Aufgabenassistenten.virtual_agent_name: Der Name des virtuellen Assistenten.participant_id: Die Teilnehmer-ID für den virtuellen Aufgabenassistenten.queue_id: Die Kennung für die Warteschlange, aus der die Sitzung stammt. Diese Kennung ist nur enthalten, wenn die Sitzung aus einer Warteschlange stammt.queue_path: Der Pfad der Warteschlange, aus der die Sitzung stammt. Diese Kennung wird nur angegeben, wenn die Sitzung aus einer Warteschlange stammt.queue_language_id: Die Sprache der Warteschlange, aus der die Sitzung stammt. Diese Kennung wird nur angegeben, wenn die Sitzung aus einer Warteschlange stammt.session_type: Der Sitzungstyp, z. B. eingehende Nachrichten über den Webchat.conversation_id: Die Kennung für Sitzungen mit virtuellen Agenten, in denen Konversationsprofile verwendet werden.session_id: Die Kennung für Sitzungen mit virtuellen Kundenservicemitarbeitern, in denen keine Unterhaltungsprofile verwendet werden.timestamp: Das Datum und die Uhrzeit eines Ereignisses.finish_reason: Der Grund für das Ende der Sitzung des virtuellen Kundenservicemitarbeiters.data_parameters: Die im CCAI Platform-Portal konfigurierten und an den virtuellen Kundenservicemitarbeiter gesendeten Variablen.captured_variables: Die Sitzungsvariablen, die vom virtuellen Aufgabenassistenten erfasst werden.
Beispiel für Nutzlast
{
"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"
}
]
}
}
Variablen für virtuelle Aufgabenassistenten-Sitzungen empfangen
Dieser Wert wird übergeben, wenn der virtuelle Aufgabenassistent eine benutzerdefinierte Nutzlast für Sitzungsvariablen sendet.
Datenfelder
call_id: Die Kennung für eine Sprach- (IVR-)Sitzung.chat_id: Die Kennung für eine Web- oder mobile Chatsitzung.campaign_id: Die Kennung für einen Kampagnenanruf.campaign_name: Der Name der Kampagne.virtual_agent_id: Die Kennung für einen virtuellen Aufgabenassistenten.virtual_agent_name: Der Name des virtuellen Assistenten.queue_id: Die Kennung für die Warteschlange, aus der die Sitzung stammt. Diese Kennung ist nur enthalten, wenn die Sitzung aus einer Warteschlange stammt.queue_path: Der Pfad der Warteschlange, aus der die Sitzung stammt. Diese Kennung wird nur angegeben, wenn die Sitzung aus einer Warteschlange stammt.queue_language_id: Die Sprache der Warteschlange, aus der die Sitzung stammt. Diese Kennung ist nur enthalten, wenn die Sitzung aus einer Warteschlange stammt.session_type: Der Sitzungstyp, z. B. eingehende Nachrichten über den Webchat.conversation_id: Die Kennung für Sitzungen mit virtuellen Agenten, in denen Konversationsprofile verwendet werden.session_id: Die Kennung für Sitzungen mit virtuellen Kundenservicemitarbeitern, in denen keine Unterhaltungsprofile verwendet werden.timestamp: Das Datum und die Uhrzeit eines Ereignisses.data_parameters: Die im CCAI Platform-Portal konfigurierten und an den virtuellen Kundenservicemitarbeiter gesendeten Variablen.captured_variables: Die Sitzungsvariablen, die vom virtuellen Aufgabenassistenten erfasst werden.
Beispiel für Nutzlast
{
"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"
}
]
}
}
Dialogflow-Nutzlast für benutzerdefinierte Sitzungsvariablen
Die Nutzlast für benutzerdefinierte Dialogflow-Sitzungsvariablen unterstützt Post-Ereignisse für virtuelle Assistenten.
Die in der Nutzlast der Kundensitzungsvariable verfügbaren Properties sind:
capture_type:event: Gibt an, dass die in der Nutzlast der Kundensitzungsvariable zurückgegebenen Werte in den Post-Events des virtuellen Kundenservicemitarbeiters übergeben werden müssen.capture_type:agent: Gibt an, dass die in der Nutzlast der Kundensitzungsvariable zurückgegebenen Werte an den Agent-Adapter übergeben werden müssen.capture_type:comment: Gibt an, dass die in der Nutzlast der Kundensitzungsvariable zurückgegebenen Werte als Kommentar in den CRM-Datensatz eingefügt werden müssen.invisible_to_adapter_events: Die Werte der in dieser Eigenschaft angegebenen Schlüssel müssen aus den Post-Ereignissen des virtuellen Kundenservicemitarbeiters ausgeschlossen werden.
Beispiel für Nutzlast
{
"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"
]
}
}
}