VOICEBOT STREAM

Integrates a self-service virtual agent with voice scripts using a continuous stream of audio from the platform. This action allows NiCE CXone use streaming audio with SIP Protocolo utilizado para señalizar y controlar sesiones de comunicación multimedia, como llamadas de voz y video.connections. This action does not allow you to change the virtual agent's behavior between turns. You only need one instance of this action in your script.

Dependencias

This action is only for use with the Google Dialogflow CX VoiceStream virtual agent Una aplicación de software que maneja las interacciones del cliente en lugar de un agente humano en vivo.. Use this action instead of the VOICEBOT EXCHANGE action for integrations with Dialogflow CX VoiceStream.

Tipos de script admitidos

Phone

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.

Las propiedad	Descripción
Add Caption	Ingrese 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 de la aplicación Virtual Agent Hub. Puede utilizar la sustitución de variables en esta propiedad.
Custom Payload to Bot	The variable that holds the custom payload to send to the virtual agent Una aplicación de software que maneja las interacciones del cliente en lugar de un agente humano en vivo.. Enter the name of the JSON object that passes data from the script to the virtual agent. You must define the custom payload object in a Snippet action. The object must be converted to JSON, either in the snippet or in the customPayload property. Don't use this property if you need to process data that the virtual agent returns to the script. Instead, use the customPayloadVarName (out) variable.
Initial Intent	The first intent El significado o propósito detrás de lo que dice o escribe un contacto; lo que el contacto desea comunicar o lograr. that the action sends to the virtual agent Una aplicación de software que maneja las interacciones del cliente en lugar de un agente humano en vivo..

Output Properties

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.

Las propiedad	Descripción
CustomPayloadFromBotVarName (out)	This variable contains the custom payload returned from the virtual agent Una aplicación de software que maneja las interacciones del cliente en lugar de un agente humano en vivo..
ErrorDetailsVarName (out)	Cuando se toma la rama Error, esta variable contiene todos los detalles asociados con el error.

Condiciones de ramificación de Resultado

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

Condición	Descripción
Default	Recorrido a menos que el script cumple una condición que requiere uno de los otros poderes. También se considera si no están definidas las demás ramas de la acción.
OnContained	The branch taken when the interaction with the virtual agent ends successfully.
Error During Session	Ruta tomada cuando la acción no se ejecuta correctamente. Por ejemplo, cuando haya un problema inesperado como una mala conectividad, errores de sintaxis, etc. La variable _ERR, con un único carácter de subrayado, debe llenarse con una explicación condensada del problema.
On Escalate	The branch taken when the interaction is escalated to a human agent.
On Failed to Initialize	The branch taken when the profile named in virtualAgentID has the wrong credentials or the wrong virtual agent profile is selected.

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

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

• Puede pasar datos personalizados a Dialogflow CX utilizando pares clave-valor de JSON. En un Snippet acción en su script, cree un objeto dinámico customPayload y agregue los pares clave-valor a él. 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 se 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 utilizando 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 de 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.

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

• Para configurar cuánto tiempo espera el agente virtual cuando el contacto hace una pausa al hablar, agregue el maxPostEnergySilenceMSparámetro a la Next Prompt Behaviorso Default Next Prompt BehaviorsSnippet acción.