Der Agent-Adapter kann die postMessage() -API des Browsers verwenden, um Ereignisse an den übergeordneten iFrame zu senden. Diese Ereignisse können von JavaScript im übergeordneten iFrame genutzt werden, um verschiedene Aktionen in Ihrer benutzerdefinierten CRM-Implementierung auszuführen. Dazu muss Ihre Anwendung auf das MessageEvent im übergeordneten Fenster 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, mit denen die CRM-Funktionen verbessert werden können.
Die Contact Center AI Platform unterstützt die folgenden Ereignisse für virtuelle Aufgabenassistenten:
Virtueller Aufgabenassistent beigetreten
Virtueller Aufgabenassistent hat die Sitzung verlassen
Benutzerdefinierte Sitzungsvariablen für virtuellen Aufgabenassistenten empfangen
Eine vollständige Liste der Post-Ereignisse im Zusammenhang mit Agent-Adaptern finden Sie unter Agent Adaptern.
Virtueller Aufgabenassistent beigetreten
Dieses Ereignis wird übergeben, wenn der virtuelle Aufgabenassistent einer Sitzung beitritt.
Datenfelder
call_id: Die Kennung für eine Sprachsitzung (IVR).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 Aufgabenassistenten.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 ist nur enthalten, 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 Kundenservicemitarbeitern, die Konversationsprofile verwenden.session_id: Die Kennung für Sitzungen mit virtuellen Kundenservicemitarbeitern, die keine Konversationsprofile verwenden.timestamp: Datum und Uhrzeit eines Ereignisses.data_parameters: Die im CCAI Platform-Portal konfigurierten Variablen, die an den virtuellen Aufgabenassistenten gesendet werden.
Beispiel für die 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 hat die Sitzung verlassen
Dieses Ereignis wird übergeben, wenn der virtuelle Aufgabenassistent die Sitzung verlässt.
Datenfelder
call_id: Die Kennung für eine Sprachsitzung (IVR).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 Aufgabenassistenten.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 ist nur enthalten, 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 Kundenservicemitarbeitern, die Konversationsprofile verwenden.session_id: Die Kennung für Sitzungen mit virtuellen Kundenservicemitarbeitern, die keine Konversationsprofile verwenden.timestamp: Datum und Uhrzeit eines Ereignisses.finish_reason: Der Grund für das Ende der Sitzung mit dem virtuellen Kundenservicemitarbeiter.data_parameters: Die im CCAI Platform-Portal konfigurierten Variablen, die an den virtuellen Aufgabenassistenten gesendet werden.captured_variables: Die Sitzungsvariablen, die vom virtuellen Aufgabenassistenten erfasst wurden.
Beispiel für die 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"
}
]
}
}
Sitzungsvariablen für virtuellen Aufgabenassistenten empfangen
Dieses Ereignis wird übergeben, wenn der virtuelle Aufgabenassistent eine benutzerdefinierte Nutzlast für Sitzungsvariablen sendet.
Datenfelder
call_id: Die Kennung für eine Sprachsitzung (IVR).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 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 ist nur enthalten, 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 Kundenservicemitarbeitern, die Konversationsprofile verwenden.session_id: Die Kennung für Sitzungen mit virtuellen Kundenservicemitarbeitern, die keine Konversationsprofile verwenden.timestamp: Datum und Uhrzeit eines Ereignisses.data_parameters: Die im CCAI Platform-Portal konfigurierten Variablen, die an den virtuellen Aufgabenassistenten gesendet werden.captured_variables: Die Sitzungsvariablen, die vom virtuellen Aufgabenassistenten erfasst wurden.
Beispiel für die 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 Dialogflow-Nutzlast für benutzerdefinierte Sitzungsvariablen unterstützt Post-Ereignisse für virtuelle Aufgabenassistenten.
Die in der Nutzlast für Sitzungsvariablen für Kunden verfügbaren Attribute sind:
capture_type:event: Gibt an, dass die in der Nutzlast für Sitzungsvariablen für Kunden zurückgegebenen Werte in den Post-Ereignissen für virtuelle Aufgabenassistenten übergeben werden müssen.capture_type:agent: Gibt an, dass die in der Nutzlast für Sitzungsvariablen für Kunden zurückgegebenen Werte an den Agent-Adapter übergeben werden müssen.capture_type:comment: Gibt an, dass die in der Nutzlast für Sitzungsvariablen für Kunden zurückgegebenen Werte als Kommentar an den CRM-Eintrag übergeben werden müssen.invisible_to_adapter_events: Die Werte der in diesem Attribut angegebenen Schlüssel müssen aus den Post-Ereignissen für virtuelle Aufgabenassistenten ausgeschlossen werden.
Beispiel für die 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"
]
}
}
}