El adaptador del agente puede usar la API de postMessage() del navegador para enviar eventos al iframe principal. JavaScript puede consumir estos eventos en tu iframe principal y usarlos para realizar varias acciones en tu implementación personalizada del CRM. Para ello, tu aplicación debe escuchar el evento MessageEvent en la ventana principal. Según los eventos, tu aplicación puede activar acciones, como abrir una pestaña de tickets para un ID de sesión específico. Tanto el adaptador de llamadas como el adaptador de chat tienen eventos específicos que se pueden usar para mejorar las capacidades del CRM.
Contact Center AI Platform admite los siguientes eventos del asistente de tareas virtuales:
Se unió el asistente de tareas virtual
Se fue el asistente de tareas virtual
Variables de sesión personalizadas del asistente de tareas virtual recibidas
Para obtener una lista completa de los eventos posteriores relacionados con los adaptadores de agentes, consulta Adaptadores de agentes.
Se unió el asistente de tareas virtual
Este evento se pasa cuando el asistente de tareas virtual se une a una sesión.
Campos de datos
call_id: Es el identificador de una sesión de voz (IVR).chat_id: Es el identificador de una sesión de chat web o móvil.campaign_id: Es el identificador de una llamada de campaña.campaign_name: Es el nombre de la campaña.virtual_agent_id: Es el identificador de un asistente de tareas virtual.virtual_agent_name: Es el nombre del asistente de tareas virtual.participant_id: Es el identificador del participante para el asistente de tareas virtual.queue_id: Es el identificador de la fila de la que se originó la sesión. Este identificador solo se incluye cuando la sesión se origina en una fila.queue_path: Es la ruta de acceso de la fila de la que se originó la sesión. Este identificador solo se incluye cuando la sesión se origina en una fila.queue_language_id: Es el idioma de la cola desde la que se originó la sesión. Este identificador solo se incluye cuando la sesión se origina en una fila.session_type: Es el tipo de sesión, por ejemplo, mensajes entrantes a través del chat web.conversation_id: Es el identificador de las sesiones del agente virtual que usan perfiles de conversación.session_id: Es el identificador de las sesiones de agente virtual que no usan perfiles de conversación.timestamp: Es la fecha y hora de un evento.data_parameters: Son las variables configuradas en el portal de CCAI Platform y enviadas al asistente virtual de tareas.
Muestra de carga útil
{
"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"
}
}
}
Se fue el asistente de tareas virtual
Este evento se pasa cuando el asistente de tareas virtuales abandona la sesión.
Campos de datos
call_id: Es el identificador de una sesión de voz (IVR).chat_id: Es el identificador de una sesión de chat web o móvil.campaign_id: Es el identificador de una llamada de campaña.campaign_name: Es el nombre de la campaña.virtual_agent_id: Es el identificador de un asistente de tareas virtual.virtual_agent_name: Es el nombre del asistente de tareas virtual.participant_id: Es el identificador del participante para el asistente de tareas virtual.queue_id: Es el identificador de la fila de la que se originó la sesión. Este identificador solo se incluye cuando la sesión se origina en una fila.queue_path: Es la ruta de acceso de la fila de la que se originó la sesión. Este identificador solo se incluye cuando la sesión se origina en una fila.queue_language_id: Es el idioma de la cola desde la que se originó la sesión. Este identificador solo se incluye cuando la sesión se origina en una fila.session_type: Es el tipo de sesión, por ejemplo, mensajes entrantes a través del chat web.conversation_id: Es el identificador de las sesiones del agente virtual que usan perfiles de conversación.session_id: Es el identificador de las sesiones de agente virtual que no usan perfiles de conversación.timestamp: Es la fecha y hora de un evento.finish_reason: Es el motivo de finalización cuando termina la sesión del agente virtual.data_parameters: Son las variables configuradas en el portal de CCAI Platform y enviadas al asistente virtual de tareas.captured_variables: Son las variables de sesión que captura el asistente de tareas virtual.
Muestra de carga útil
{
"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 sesión del asistente de tareas virtual recibidas
Se pasa cuando el asistente de tareas virtual envía una carga útil de variable de sesión personalizada.
Campos de datos
call_id: Es el identificador de una sesión de voz (IVR).chat_id: Es el identificador de una sesión de chat web o móvil.campaign_id: Es el identificador de una llamada de campaña.campaign_name: Es el nombre de la campaña.virtual_agent_id: Es el identificador de un asistente de tareas virtual.virtual_agent_name: Es el nombre del asistente de tareas virtual.queue_id: Es el identificador de la fila de la que se originó la sesión. Este identificador solo se incluye cuando la sesión se origina en una fila.queue_path: Es la ruta de acceso de la fila de la que se originó la sesión. Este identificador solo se incluye cuando la sesión se origina en una fila.queue_language_id: Es el idioma de la cola desde la que se originó la sesión. Este identificador solo se incluye cuando la sesión se origina en una fila.session_type: Es el tipo de sesión, por ejemplo, mensajes entrantes a través del chat web.conversation_id: Es el identificador de las sesiones del agente virtual que usan perfiles de conversación.session_id: Es el identificador de las sesiones de agente virtual que no usan perfiles de conversación.timestamp: Es la fecha y hora de un evento.data_parameters: Son las variables configuradas en el portal de CCAI Platform y enviadas al asistente virtual de tareas.captured_variables: Son las variables de sesión que captura el asistente de tareas virtual.
Ejemplo de carga útil
{
"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"
}
]
}
}
Carga útil de Dialogflow para variables de sesión personalizadas
La carga útil de la variable de sesión personalizada de Dialogflow admite eventos posteriores del asistente de tareas virtuales.
Las propiedades disponibles en la carga útil de la variable de sesión del cliente incluyen las siguientes:
capture_type:event: Indica que los valores que se muestran en la carga útil de la variable de sesión del cliente se deben pasar en los eventos posteriores del asistente de tareas virtual.capture_type:agent: Indica que los valores que se muestran en la carga útil de la variable de sesión del cliente se deben pasar al adaptador del agente.capture_type:comment: Indica que los valores que se muestran en la carga útil de la variable de sesión del cliente se deben pasar al registro de CRM como un comentario.invisible_to_adapter_events. Los valores de las claves especificadas en esta propiedad deben excluirse de los eventos posteriores del asistente de tareas virtual.
Muestra de carga útil
{
"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"
]
}
}
}