Conversación TextBot

El ícono para la acción Intercambio de Textbot.

Integra un autoservicio agente virtual Una aplicación de software que maneja las interacciones del cliente en lugar de un agente humano en vivo. textbot con cualquier tipo de script compatible. Su agente virtual debe respaldar esta acción.

Esta acción es únicamente para su uso con agentes virtuales simples. No permite la personalización del comportamiento del agente virtual de turno en turno. Si necesita personalizar el comportamiento del agente virtual entre turnos de la conversación y si su proveedor de agentes virtuales lo admite, use la acción TextBot Exchange.

Textbot Conversation interactúa directamente con el agente virtual y supervisa la conversación de forma pasiva en tiempo real. El agente virtual analiza la conversación para determinar 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 Devuelve las respuestas apropiadas al contacto. Cuando el agente virtual indica que ha terminado la conversación, la acción continúa el script Studio. La acción transmite información relevante a las pantallas emergentes Puede configurar una ventana emergente con información sobre el contacto. Aparece en la pantalla de un agente después de un determinado evento, generalmente cuando el agente se conecta a un contacto., el enrutamiento de agentes, etc.

Textbot Conversation no se recomienda su uso con Google Dialogflow CX, Google Dialogflow ES, o SmartAssist los agentes virtuales de texto en la mayoría de los casos.

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

Tipos de scripts compatibles


Correo electrónico	Chat	SMS

RelacionadoStudio Comportamiento

La acción TextBot Exchange es similar a esta acción, pero se utiliza para interacciones de agentes virtuales más complejas. Te permite incluir parámetros de intercambio y personalizar varios aspectos de la conversación entre el contacto y el bot.

También son similares Voicebot Conversation y Voicebot Exchange, ya que proporcionan la misma función que Textbot Conversation y Textbot Exchangeen las interacciones de voz.

Agentes virtuales compatibles

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

CXone CXone SmartAssist Powered by Amelia (no recomendado)
Google Dialogflow CX (no recomendado)
Google Dialogflow ES (no recomendado)

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

Propiedad	Detalles
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.
useDefaultWelcomeMessage	Cuando se coloca en true, se utiliza el mensaje de bienvenida predeterminado para el agente virtual asignado a la acción. Cuando se coloca en false, el script se basa en el bot del agente virtual para presentar el mensaje de bienvenida.
userInputTimeout	Establece la cantidad de tiempo en segundos que la acción espera a que el contacto ingrese una respuesta antes de que se agote el tiempo de espera.
maxTimeouts	Establece el número de intercambios sin enunciados antes de enrutar a la rama de reserva de errores.
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: 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. Para obtener más información sobre el uso de esta propiedad con Google Dialogflow ES, ver las Prácticas recomendadas para cargas útiles personalizadas conGoogle Dialogflow ESapartado de este tema. Para Google Dialogflow CX bots, vea las Prácticas recomendadas para cargas útiles personalizadas con Google Dialogflow CXsección. No utilice esta propiedad si necesita procesar los datos que devuelve el agente virtual al script. En su lugar, use la variable customPayloadVarName (out).

Ramas

Rama	Detalles
OnBotSessionComplete	Ruta adoptada cuando el agente virtual indica que ha terminado 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.
OnTimeout	Ruta tomada cuando no hay respuesta del usuario dentro del tiempo especificado en la acción Comportamiento predeterminado del siguiente avisoSnippet.

Variables de salida

Variable	Detalles
customPayloadOutput (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.
errorDetailsOutput (out)	Enumera el motivo por el que se tomó la rama de error.
intentInfoOutput (out)	Una variable que contiene los detalles del agente virtual que indica la intención actual del usuario.

Variable

Detalles

customPayloadOutput (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.

errorDetailsOutput (out)

Enumera el motivo por el que se tomó la rama de error.

intentInfoOutput (out)

Una variable que contiene los detalles del agente virtual que indica la intención actual del usuario.

Código de acción de fragmento

Algunas de las propiedades de esta acción requieren una acción Snippet con código personalizado. Puede seguir estos ejemplos al crear su script:

Carga útil personalizada

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 Snippet en su script, cree un objeto de customPayload DYNÁMICA y agregue los pares clave-valor. Por ejemplo:
```
DYNAMIC customPayload
customPayload.ani = ani
customPayload.contactID = contactId
customPayload.masterContactId = masterId
customPayloadJSON = "{customPayload.asJSON()}"	
```
En la acción Intercambio o Conversación de su script, configure la propiedad customPayload con una variable que tenga el método asJSON() en su valor. Puede encontrar esta variable en el objeto customPayload.
Transmita el JSON de customPayload al bot usando la propiedad Payload de QueryParameters. Consulte la documentación de Google en Parámetros de consulta por 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.
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 Studio de su bot de voz o chatbot 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 lePooh

$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.
Para configurar cuánto tiempo espera el agente virtual cuando el contacto hace una pausa mientras habla, agregue el parámetro maxPostEnergySilenceMS a la acción Snippet nextPromptBehaviors o defaultNextPromptBehavior.

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

Al usar esta acción conGoogle 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 Snippet en su script, cree un objeto DINÁMICO customPayload que sigue 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 ello, incluya pares clave-valor JSON estándar en un objeto DINÁMICO.
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.

Ejemplo de script usando Conversación de TextBot

Una imagen que muestra un script de ejemplo utilizando la acción Intercambio de TextBot.

Descarga este script.