Textbot Exchange

The icon for the Textbot Exchange action.

Integra un agente virtual Una aplicación de software que maneja las interacciones del cliente en lugar de un agente humano en vivo. de autoservicio con scripts de chat. Esta acción se utiliza en un ciclo en el script. Un script debe contener al menos dos acciones TextBot Exchange. Su agente virtual debe respaldar esta acción.

La TextBot Exchange acción es para agentes virtuales complejos o para cuando necesite personalizar el comportamiento del agente virtual de un turno a otro. Vigila turno a turno la conversación entre el contacto y el agente virtual Una aplicación de software que maneja las interacciones del cliente en lugar de un agente humano en vivo.. Envía cada enunciado Lo que dice o escribe un contacto. al agente virtual. El Agente virtual analiza el enunciado para detectar la intención El significado o propósito detrás de lo que dice/escribe un contacto; lo que el contacto quiere comunicar o lograr y el contexto y determina qué respuesta ofrecer. TextBot Exchange pasa la respuesta al contacto. Cuando la conversación ha finalizado, la acción continúa el script.

Al hacer doble clic en esta acción se abre Virtual Agent Hub, donde puede administrar todos sus bots de agentes virtuales.

Tipos de scripts compatibles


Correo electrónico	Conversación	SMS	Digital

Comparación de acciones similares

Las siguientes acciones tienen funciones similares, pero con algunas diferencias clave:

Textbot Exchange: Se utiliza esta action para interacciones complejas de agentes virtuales. Le permite incluir parámetros de intercambio y personalizar varios aspectos de la conversación entre el contacto y el agente virtual.
Voicebot Exchange: Se utiliza esta action para interacciones complejas de agentes virtuales. Le permite incluir parámetros de intercambio y personalizar varios aspectos de la conversación entre el contacto y el agente virtual.

Agentes virtuales compatibles

Esta acción es compatible con los siguientes agentes virtuales:

Antes de poder asignar un agente virtual a esta acción, debe agregar y configurar una aplicación para el agente virtual en Virtual Agent Hub. Solo necesita una aplicación para cada agente virtual que use. Puede asignar la misma aplicación a múltiples acciones de agentes virtuales en sus scripts. Consulte los detalles de la configuración en la página de ayuda del proveedor de agentes virtuales que esté usando.

Propiedades de entrada

Estas propiedades definen los datos que utiliza la acción al ejecutarse.

Una o más de las propiedades de esta acción requiere una acción Snippet con el siguiente código personalizado.

Las propiedad	Detalles
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. The default is the action name.
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 nombre que se utiliza en el campo Virtual Agent (Bot) Name en la aplicación Virtual Agent Hub.
automatedIntent	Ingrese por nombre una intención específica a la que responda el agente virtual, en lugar de que el agente virtual interprete la entrada del usuario. Un caso de uso común de esto es obtener el mensaje de Bienvenida inicial del Agente virtual. Welcome es la cadena estándar para los saludos iniciales.
userInput	El mensaje que escribe el contacto en la ventana de chat y se pasa al agente virtual como entrada de texto.
customPayload	Configure esta propiedad solo si necesita transmitir datos de carga útil personalizada al agente virtual. El objeto de carga útil personalizada se rellena desde el script de Studio. Puede usarlo para transmitir información, como el nombre del contacto, desde una CRM Sistemas de terceros que administran cosas como contactos, información de ventas, detalles de soporte e historiales de casos. para usar en un mensaje de bienvenida. Ingrese el nombre del objeto JSON que transmite datos desde el script hacia el agente virtual. Debe definir el objeto de carga útil personalizada en una acción Snippet. Se debe convertir el objeto a JSON, ya sea en el snippet o en la propiedad customPayload. Requisitos para proveedores específicos de agentes virtuales: Amazon Lex V1: Es necesaria esta propiedad incluso si no necesita transmitir datos al agente virtual. Agregue un fragmento con un valor marcador de posición. Google Dialogflow ES: Se utiliza esta propiedad para transmitir el contexto de una intención El significado o propósito detrás de lo que dice/escribe un contacto; lo que el contacto quiere comunicar o lograr. Revise las mejores prácticas para la carga útil personalizada con Google Dialogflow ES para asegurarse de manejarla adecuadamente. Google Dialogflow CX: Revise las mejores prácticas para la carga útil personalizada con Google Dialogflow CX para asegurarse de manejarla adecuadamente. No utilice esta propiedad si necesita procesar los datos que devuelve el agente virtual al script. En su lugar, use la variable customPayloadVarName (out).
botSessionState	Configúrela con la variable que contiene el identificador único de la conversación entre el contacto y el agente virtual. El proveedor de agentes virtuales la asigna automáticamente. El identificador evita que se cree una sesión nueva con cada turno de la conversación y ayuda al agente virtual a mantener el contexto entre los turnos. El proveedor crea el identificador cuando comienza la conversación y lo pasa al script junto con la primera respuesta. El script almacena el identificador en la variable que se nombra en la propiedad botSessionStateVarName (out) de esta acción. Por último, el script transmite el identificador de la propiedad botSessionStateVarName (out) del turno anterior a la propiedad botSessionState. Sus scripts nunca se deben escribir en esta propiedad ni en su variable. Se debe configurar su script correctamente para usar el identificador de estado de la sesión del bot.

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.

Las propiedad	Descripción
nextPromptVarName (out)	Define los comportamientos para incitar al usuario en el siguiente turno de conversación.
customPayloadVarName (out)	Devuelve datos JSON personalizados del agente virtual al script. Utilice esta variable cuando desee que el script procese los datos que proporciona el agente virtual. Puede contener datos de cumplimiento. Si desea proporcionar datos al agente virtual, utilice la propiedad customPayload.
errorDetailsVarName (out)	Solicita la secuencia de intento de error; puede dar lugar a una transferencia a un agente activo.
intentInfoVarName (out)	Una variable que contiene los detalles del agente virtual que indica la intención actual del usuario.
botSessionStateVarName (out)	Guarda la variable donde el script almacena el identificador del estado de la sesión bot que envía el proveedor de agente virtual. El contenido de la variable se pasa a la propiedad botSessionState. Debe configurarse adecuadamente la propiedad para que funcione correctamente el agente virtual. Se encuentra disponible más información sobre cómo configurarla en la página de ayuda del Snippet del Estado de Sesión del Bot.

Condiciones de la rama de resultados

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.
OnPromptAndCollectNextResponse	Ruta adoptada si el agente virtual ha determinado que debe continuar la interacción y está listo para recibir más información humana del contacto. Indica el siguiente turno de la conversación.
OnError	Recorrido cuando hay un problema inesperado (por ejemplo, mala conectividad, errores de sintaxis, etc.). La variable _ERR debería completarse con una explicación resumida del problema.
OnReturnControlToScript	Ruta adoptada si el agente virtual indicó que terminó la conversación y devuelve el control al script Studio para transferir o finalizar la llamada. Puede haber datos de cumplimiento por procesarse en el resultado customPayload.

Código de acción de fragmento

Una o más de las propiedades de esta acción requiere una Snippet action con el siguiente código personalizado:

Prácticas recomendadas para cargas útiles personalizadas conGoogle Dialogflow CX

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

Dialogflow CX no usa contextos para pasar datos a Dialogflowintenciones El significado o propósito detrás de lo que dice/escribe un contacto; lo que el contacto quiere comunicar o lograr como Dialogflow ES lo hace.
Puede pasar datos personalizados aDialogflow CX usando pares clave-valor JSON. En una acción de Snippet action en su script, cree un objeto dinámico customPayload y agréguele los pares clave-valor. Por ejemplo:
```
DYNAMIC customPayload
customPayload.ani = ani
customPayload.contactID = contactId
customPayload.masterContactId = masterId
customPayloadJSON = "{customPayload.asJSON()}"	
```
En la acción Exchange de su script, configure la propiedad customPayload con la variable que tiene la función asJSON() en su valor. Puede encontrar esta variable en el objeto customPayload.
Transmita el JSON de customPayload al agente virtual usando la propiedad Payload de QueryParameters. Consulte la documentación de Google sobre QueryParameters para Google Dialogflow CX.
Los datos transmitidos 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 inserte 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 CXone. Asigne esto a su script usando la variable customPayloadVarName (out) en la acción VOICEBOT EXCHANGE o TEXTBOT EXCHANGE Studio en su script. Por ejemplo, puede usar esto para configurar los Comportamientos del siguiente indicador.
Los parámetros definidos con customPayload solo se pueden usar en el webhook externo. Si desea establecer parámetros para usar fuera del webhook externo, configúrelos en una acción Snippet con el campo session_params. Por ejemplo:
```
{
	"session_params":
	{ 
		"name": "Winnie Le Pooh"
		"job": "Food critic"
		"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.
Es posible transmitir Sugerencias de contexto de voz con carga útil personalizada en el parámetro speechContexts. El valor de speechContexts.phrases debe ser un token de clase de Google para la sugerencia que desea ofrecer. El token debe coincidir con el idioma y la configuración regional de sus contactos. Por ejemplo:
```
DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		
```

Prácticas recomendadas para cargas útiles personalizadas conGoogle Dialogflow ES

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

CustomPayload se utiliza para pasar el contexto de una intención El significado o propósito detrás de lo que dice/escribe un contacto; lo que el contacto quiere comunicar o lograr. El contexto ayuda al agente virtual a comprender la intención del usuario. Los contextos no son obligatorios, pero ayudan al agente virtual a relacionar un enunciado Lo que dice o escribe un contacto. con una intención.
En una acción de Snippet en su script, cree un objeto customPayload que siga el formato descrito en la documentación de Google Dialogflow ES para recursos REST: projects.agent.sessions.context. La ayuda en línea de Studio ofrece más información sobre los objetos de datos dinámicos.
También puede transmitir datos personalizados con customPayload sin contextos. Para hacerlo, incluya pares clave-valor JSON estándar en un objeto dinámico de datos.
Los contextos de voz se transmiten en la carga útil personalizada del parámetro speech_contact. Puede ver el contenido de este parámetro en los seguimientos y registros de aplicación de Studio.
El objeto dinámico customPayload se transmite como un parámetro de agente virtual en formato JSON, como se observa en el script de ejemplo.
Es posible transmitir Sugerencias de contexto de voz con carga útil personalizada en el parámetro speechContexts. El valor de speechContexts.phrases debe ser un token de clase de Google para la sugerencia que desea ofrecer. El token debe coincidir con el idioma y la configuración regional de sus contactos. Por ejemplo:
```
DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		
```