VOICEBOT STREAM

Integra un agente virtual de autoservicio con scripts de voz utilizando un flujo continuo de audio desde la plataforma. Esta acción permite que NiCE CXone use audio de transmisión con SIP Protocol used for signaling and controlling multimedia communication sessions such as voice and video calls.conexiones. Esta acción no le permite cambiar el comportamiento del agente virtual entre turnos. solo necesita una instancia de esta acción en su script.

Dependencias

Esta acción es solo para uso con el Google Dialogflow CX VoiceStream agente virtual A software application that handles customer interactions in place of a live human agent.. Use esta acción en lugar de la acción VOICEBOT EXCHANGE para integraciones con Dialogflow CX VoiceStream.

Tipos de script admitidos

Teléfono

Propiedades de Entrada

Estas propiedades definen los datos que utiliza la acción al ejecutarse.Puede usar la sustitución de variables en todas las propiedades de esta acción.

Propiedad	Descripción
Agregar leyenda	Introduzca una frase corta que identifique de forma única esta acción en el script. La leyenda aparece en el lienzo del script debajo del ícono de acción.
virtualAgentId	``` El nombre del agente virtual seleccionado en el Virtual Agent Hub. Cuando asigna una aplicación de agente virtual a una acción Studio en Virtual Agent Hub, esta propiedad se rellena de forma automática. El nombre es el valor utilizado en el campo Virtual Agent (Bot) Name en la aplicación Virtual Agent Hub. Puede usar la sustitución de variables en esta propiedad. ```
Custom Payload to Bot	\n La variable que contiene la carga útil personalizada para enviar al agente virtual A software application that handles customer interactions in place of a live human agent.. \n Ingrese el nombre del objeto JSON que pasa datos del script al agente virtual. Debe definir el objeto de carga útil personalizada en una acción Snippet. El objeto se debe convertir a JSON, ya sea en el snippet o en la propiedad customPayload. No utilice esta propiedad si necesita procesar los datos que devuelve el agente virtual al script. En su lugar, utilice la variable customPayloadVarName (out). \n
Initial Intent	La primera intención The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. que la acción envía al agente virtual A software application that handles customer interactions in place of a live human agent..

Propiedades de salida

Estas propiedades contienen variables que incluyen datos que se evuelven al ejecutar la acción. Están disponibles como referencia y para usarse cuando se completa la acción.

Propiedad	Descripción
CustomPayloadFromBotVarName (out)	Esta variable contiene la carga útil personalizada devuelta por el agente virtual A software application that handles customer interactions in place of a live human agent..
ErrorDetailsVarName (out)	Cuando se toma la rama Error, esta variable contiene cualquier detalle asociado con el error.

Condiciones de ramificación de Resultado

Las condiciones de las ramas de resultado le permiten crear ramas en su script para manejar diferentes resultados cuando se ejecuta una acción.

Condición	Descripción
Por defecto	Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
OnContained	La rama que se toma cuando la interacción con el agente virtual finaliza correctamente.
Error During Session	Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.
On Escalate	La ramificación taken cuando la interacción se escala a un agente humano.
On Failed to Initialize	La ramificación que se toma cuando el perfil nombrado en virtualAgentID tiene las credenciales incorrectas o se selecciona el perfil de agente virtual incorrecto.

Prácticas recomendadas para la Carga útil personalizada con Dialogflow CX VoiceStream

Cuando use esta acción con Dialogflow CX VoiceStream, siga estas prácticas recomendadas para integrar cargas útiles personalizadas:

• Puede pasar datos personalizados a Dialogflow CX mediante pares clave-valor en formato JSON. En un Snippet acción en su script, cree un objeto dinámico customPayload y agregue los pares clave-valor. Por ejemplo:

  DYNAMIC customPayload
  customPayload.ani = ani
  customPayload.contactID = contactId
  customPayload.masterContactId = masterId
  customPayloadJSON = "{customPayload.asJSON()}"	

• En la VoiceBOT STREAM acción de su script, configure la propiedad customPayload con una variable que tenga la función asJSON() en su valor. Puede encontrar esta variable en el objeto customPayload.
• Pase el JSON de customPayload al agente virtual mediante la propiedad Payload de QueryParameters. Consulte la documentación de Google sobre QueryParameters para Google Dialogflow CX.
• Los datos que pasan a través de QueryParameters SOn recibidos por un webhook en Dialogflow CX.Puede escribir código en la Dialogflow Consola CX para manejar los datos pasados.
• No anide un objeto dentro del objeto customPayload. Los objetos insertados se envían como cadenas literales.
• Para transmitir datos personalizados desde su agente virtual Dialogflow CX devuelta al l script, usa el campo Carga útil personalizada en la consola Dialogflow CX.Asegúrese de estar en la consola del agente virtual que está usando con NiCE CXone. Asigne esto a su script mediante la variable customPayloadVarName (out) en la acción VOICEBOT STREAM de su script.

• Para pasar datos personalizados a Dialogflow CX desde el script, use session_params en el objeto customPayload en una acción Snippet. Por ejemplo:

  DYNAMIC customPayload
  customPayload.session_params.name = "Winnie le Pooh" 
  customPayload.session_params.job = "Food critic" 
  customPayload.session_params.location = "Hundred Acre Wood"	

  Accede a los parámetros de la sesión en la Dialogflowintención del agente CX con la siguiente sintaxis:

  $session.params.name = Winnie Le Pooh
  $session.params.job = Food critic
  $session.params.location = 100 Acre Wood 

  Los parámetros de sesión solo se utilizan con los agentes virtuales Dialogflow CX. Para lograr un resultado similar con Dialogflow ES, use contextos.

• Configurar sugerencias de contexto de voz y un ID de conversación personalizado para transferir la conversación a un agente virtual Dialogflow CX diferente en el Carga útil personalizada snippet.

• Para configurar cuánto tiempo espera el agente virtual cuando el contacto hace una pausa mientras habla, agregue el maxPostEnergySilenceMS parámetro a la Next Prompt Behaviorso la Default Next Prompt Behaviors Snippet acción.