TEXTBOT EXCHANGE

Esta página de ayuda es para Studio. Esta información también está disponible para Desktop Studio.

``` Ícono de TextBot Exchange: cabeza de robot verde azulado con una cara sonriente ```

Integra un agente virtualClosed A software application that handles customer interactions in place of a live human agent. de autoservicio con scripts de chat. Esta acción se utiliza en un bucle en el script. Un script debe contener al menos DOs acciones de Intercambio de textbot. Su agente virtual debe respaldar esta acción.

El TextBot Exchange acción es para agentes virtuales complejos o para cuando necesite personalizar el comportamiento del agente virtual de turno a turno. Supervisa la conversación entre el contacto y el agente virtualClosed A software application that handles customer interactions in place of a live human agent. turno por turno. Envía cada enunciadoClosed What a contact says or types. al agente virtual. El agente virtual analiza el enunciado para detectar la intenciónClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. 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 agente virtual.

Tipos de secuencias de comandos compatibles

Icono de un sobre verde grisáceo

Icono de burbuja de diálogo verde oscuro

Icono de un teléfono móvil verde con un globo de diálogo en su pantalla

Ícono de un monitor de computadora violeta con un dispositivo móvil que se superpone a su esquina inferior derecha

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: Este acción se usa para interacciones complejas de agente virtual. Le permite incluir parámetros de intercambio y personalizar varios aspectos de la conversación entre el contacto y el agente virtual.
  • Voicebot Exchange: Esto acción se utiliza para interacciones complejas del agente virtual. Le permite incluir parámetros de intercambio y personalizar varios aspectos de la conversación entre el contacto y el agente virtual.
  • VOICEBOT STREAM: Esta acción admite la transmisión de audio en tiempo real entre NiCE CXone y el proveedor de agente virtual. No admite la personalización de la conversación entre turnos. Actualmente, el único agente virtual admitido es Google Dialogflow CX VoiceStream.

Agentes virtuales compatibles

Esta acción admite 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 agente virtual en sus Scripts. Consulte la página de ayuda del proveedor de agente virtual que está utilizando para obtener los detalles de configuración.

Es posible que se admitan otros proveedores de agentes virtuales, pero requieren integraciones personalizadas. Estos incluyen integraciones de DEVone y custom endpoints. Las integraciones personalizadas no se configuran usando Virtual Agent Hub.

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 requieren una acción Snippet con código personalizado.

Propiedad Detalles

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.

ID de agente virtual

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.

Intención automatizada

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 para esto es obtener el mensaje de bienvenida inicial del agente virtual. Bienvenido es la cadena estándar para los saludos iniciales.

Entrada del usuario

El mensaje que escribe el contacto en la ventana de chat y se pasa al agente virtual como entrada de texto.

Carga útil personalizada

Configure esta propiedad solo si necesita transmitir datos de carga útil personalizada al agente virtual. El objeto carga útil personalizada se completa a partir del script Studio. Puede usarlo para transmitir información, como el nombre del contacto, desde una CRMClosed Third-party systems that manage such things as contacts, sales information, support details, and case histories. para usar en un mensaje de bienvenida.

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.

Requisitos para proveedores específicos de agentes virtuales:

No utilice esta propiedad si necesita procesar los datos que devuelve el agente virtual al script. En su lugar, utilice la variable customPayloadVarName (out).

Estado de sesión del bot

Configure with the variable that holds the unique identifier for the conversation between the contact and the virtual agent. It is automatically assigned by the virtual agent provider. The identifier prevents a new session from being created with every turn in the conversation and helps the virtual agent maintain context between turns.

El proveedor crea el identificador cuando comienza la conversación y lo pasa al script con la primera respuesta. El script almacena el identificador en la variable indicada en la propiedad botSessionStateVarName (out) de esta acción. Finalmente, el script pasa el identificador del turno anterior desde la propiedad botSessionStateVarName (out) a la propiedad botSessionState.

Sus scripts nunca se deben escribir en esta propiedad ni en su variable. Su script debe estar configurado correctamente para usar el identificador de estado de 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.

Propiedad

Descripción

Nombre DE variable del siguiente aviso

Define los comportamientos para incitar al usuario en el siguiente turno de conversación.

Nombre DE variable de carga útil personalizada

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, use la propiedad customPayload.

Nombre DE variable de Detalles de Error

Solicita la secuencia de intento de error; puede dar lugar a una transferencia a un agente activo.

Nombre DE variable de información de intención

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

Nombre de la variable de estado de sesión del bot

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 correctamente esta propiedad para que funcione correctamente su agente virtual. más información sobre cómo configurarlo está disponible en la página de ayuda de Bot Session State Snippet.

Condiciones de la bifurcació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.
PromptAndCollectNextResponse

Ruta que se toma si el agente virtual ha determinado que la interacción debe continuar y está lista para recibir más entrada humana del contacto. Indica el siguiente turno de la conversación.

Error Path taken when there is an unexpected problem (for example, poor connectivity, syntax errors, and so forth). The _ERR variable should be populated with a condensed explanation of the problem.
ReturnControlToScript

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 para ser procesados en elcustomPayload resultado.

Código de Acción de Snippet

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

Prácticas recomendadas para Cargas útiles personalizadas con Google Dialogflow CX

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

  • Dialogflow CX no utiliza contextos para pasar datos a las intencionesClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. de Dialogflow como lo hace Dialogflow ES.
  • 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 acción Exchange 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.
  • 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 A square with an arrow pointing from the center out from the top right corner. 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 EXCHANGE o TEXTBOT EXCHANGE Studio de su script. Por ejemplo, puede usar esto para configurar el comportamientos del siguiente mensaje.
  • 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.

Prácticas recomendadas para Cargas útiles personalizadas con Google Dialogflow ES

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

  • CustomPayload se usa para pasar el contexto de una intenciónClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish.. 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 enunciadoClosed What a contact says or types. 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 Icono que indica que el enlace va a un sitio web externo para REST Resource: projects.agent.sessions.context. La ayuda en línea de Studio proporciona información adicional sobre los objetos de datos dinámicos.
  • También puede transmitir datos personalizados con customPayload sin contextos. Para hacer esto, incluya pares clave-valor JSON estándar en un objeto de datos dinámicos.
  • Los contextos de voz se pasan en la carga útil personalizada en el parámetro speech_contact. Puede ver el contenido de este parámetro en las trazas de Studio y en los registros de la aplicación.
  • 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.
  • Configure los indicios de contexto de voz en el Snippet de Carga útil personalizada.