L'adaptateur d'agent peut utiliser l'API postMessage() du navigateur pour envoyer des événements à l'iFrame parent. Ces événements peuvent être utilisés par JavaScript dans votre iFrame parent et servir à effectuer diverses actions dans votre implémentation CRM personnalisée. Pour ce faire, votre application doit écouter l'MessageEvent dans la fenêtre parente. En fonction des événements, votre application peut déclencher des actions, comme l'ouverture d'un onglet de ticket pour un ID de session spécifique. L'adaptateur d'appel et l'adaptateur de chat comportent des événements spécifiques qui peuvent être utilisés pour améliorer les fonctionnalités du CRM.
Contact Center AI Platform est compatible avec les événements d'assistant de tâches virtuelles suivants :
L'Assistant de tâches virtuel a rejoint la réunion
Assistant de tâches virtuel à gauche
Variables de session personnalisées de l'assistant de tâches virtuel reçues
Pour obtenir la liste complète des événements de post liés aux adaptateurs d'agent, consultez Adaptateurs d'agent.
L'Assistant de tâches virtuel a rejoint la réunion
Cet événement est transmis lorsque l'assistant de tâches virtuel rejoint une session.
Champs de données
call_id: identifiant d'une session vocale (SVI).chat_id: identifiant d'une session de chat Web ou mobile.campaign_id: identifiant d'un appel de campagne.campaign_name: nom de la campagne.virtual_agent_id: identifiant d'un assistant de tâches virtuel.virtual_agent_name: nom de l'assistant de tâches virtuelles.participant_id: identifiant du participant pour l'assistant de tâches virtuel.queue_id: identifiant de la file d'attente à partir de laquelle la session a été lancée. Cet identifiant n'est inclus que lorsque la session provient d'une file d'attente.queue_path: chemin d'accès de la file d'attente à partir de laquelle la session a été lancée. Cet identifiant n'est inclus que lorsque la session provient d'une file d'attente.queue_language_id: langue de la file d'attente à partir de laquelle la session a été lancée. Cet identifiant n'est inclus que lorsque la session provient d'une file d'attente.session_type: type de session (par exemple, messagerie entrante via le chat Web).conversation_id: identifiant des sessions d'agent virtuel qui utilisent des profils de conversation.session_id: identifiant des sessions d'agent virtuel qui n'utilisent pas de profils de conversation.timestamp: date et heure d'un événement.data_parameters: variables configurées dans le portail CCAI Platform et envoyées à l'assistant virtuel de tâches.
Exemple de charge utile
{
"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"
}
}
}
Assistant de tâches virtuel à gauche
Cet événement est transmis lorsque l'assistant de tâches virtuelles quitte la session.
Champs de données
call_id: identifiant d'une session vocale (SVI).chat_id: identifiant d'une session de chat Web ou mobile.campaign_id: identifiant d'un appel de campagne.campaign_name: nom de la campagne.virtual_agent_id: identifiant d'un assistant de tâches virtuel.virtual_agent_name: nom de l'assistant de tâches virtuelles.participant_id: identifiant du participant pour l'assistant de tâches virtuel.queue_id: identifiant de la file d'attente à partir de laquelle la session a été lancée. Cet identifiant n'est inclus que lorsque la session provient d'une file d'attente.queue_path: chemin d'accès de la file d'attente à partir de laquelle la session a été lancée. Cet identifiant n'est inclus que lorsque la session provient d'une file d'attente.queue_language_id: langue de la file d'attente à partir de laquelle la session a été lancée. Cet identifiant n'est inclus que lorsque la session provient d'une file d'attente.session_type: type de session (par exemple, messagerie entrante via le chat Web).conversation_id: identifiant des sessions d'agent virtuel qui utilisent des profils de conversation.session_id: identifiant des sessions d'agent virtuel qui n'utilisent pas de profils de conversation.timestamp: date et heure d'un événement.finish_reason: motif de fin de la session d'agent virtuel.data_parameters: variables configurées dans le portail CCAI Platform et envoyées à l'assistant virtuel de tâches.captured_variables: variables de session capturées par l'assistant de tâches virtuel.
Exemple de charge utile
{
"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"
}
]
}
}
Variables de session de l'Assistant de tâches virtuel reçues
Cette valeur est transmise lorsque l'assistant de tâches virtuel envoie une charge utile de variable de session personnalisée.
Champs de données
call_id: identifiant d'une session vocale (SVI).chat_id: identifiant d'une session de chat Web ou mobile.campaign_id: identifiant d'un appel de campagne.campaign_name: nom de la campagne.virtual_agent_id: identifiant d'un assistant de tâches virtuel.virtual_agent_name: nom de l'assistant de tâches virtuelles.queue_id: identifiant de la file d'attente à partir de laquelle la session a été lancée. Cet identifiant n'est inclus que lorsque la session provient d'une file d'attente.queue_path: chemin d'accès de la file d'attente à partir de laquelle la session a été lancée. Cet identifiant n'est inclus que lorsque la session provient d'une file d'attente.queue_language_id: langue de la file d'attente à partir de laquelle la session a été lancée. Cet identifiant n'est inclus que lorsque la session provient d'une file d'attente.session_type: type de session (par exemple, messagerie entrante via le chat Web).conversation_id: identifiant des sessions d'agent virtuel qui utilisent des profils de conversation.session_id: identifiant des sessions d'agent virtuel qui n'utilisent pas de profils de conversation.timestamp: date et heure d'un événement.data_parameters: variables configurées dans le portail CCAI Platform et envoyées à l'assistant virtuel de tâches.captured_variables: variables de session capturées par l'assistant de tâches virtuel.
Exemple de charge utile
{
"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"
}
]
}
}
Charge utile Dialogflow pour les variables de session personnalisées
La charge utile de la variable de session personnalisée Dialogflow est compatible avec les événements de post-assistant de tâches virtuelles.
Les propriétés disponibles dans la charge utile de la variable de session client sont les suivantes :
capture_type:event: indique que les valeurs renvoyées dans la charge utile de la variable de session client doivent être transmises dans les événements de publication de l'assistant virtuel.capture_type:agent: indique que les valeurs renvoyées dans la charge utile de la variable de session client doivent être transmises à l'adaptateur d'agent.capture_type:comment: indique que les valeurs renvoyées dans la charge utile de la variable de session client doivent être transmises à l'enregistrement CRM sous forme de commentaire.invisible_to_adapter_events. Les valeurs des clés spécifiées dans cette propriété doivent être exclues des événements de post de l'assistant de tâches virtuelles.
Exemple de charge utile
{
"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"
]
}
}
}