La gran mayoría de las plantillas de la categoría Mensajería de usuario se basan en el componente Respuesta común, que permite utilizar propiedades de componentes y metadatos para crear una interfaz de usuario especializada que puede incluir texto, botones de acción, imágenes y tarjetas.

En muchos casos, como las plantillas de la subcategoría Mostrar mensajes multimedia, las principales diferencias se encuentran en la propiedad Metadatos del componente Respuesta común.

En otros casos, como en la subcategoría Mostrar tablas y formularios, la plantilla consta de un componente de respuesta común precedido por un componente Definir variable.

En la subcategoría Características específicas del canal, hay ejemplos de uso de extensiones disponibles para los canales de Slack y Microsoft Teams.

El componente Comentarios del usuario le permite recopilar datos de comentarios para Estadísticas presentando a los usuarios una escala de calificación después de haber completado un flujo transaccional. Los usuarios no pueden cambiar su calificación porque el componente Comentarios de usuario no permite la entrada en desorden. Si utiliza el SDK de la versión 21.10 o posterior, este componente genera un sistema de clasificación por estrellas horizontal.

Aunque puede cambiar el comportamiento de este componente mediante las propiedades del componente, puede cambiar su aspecto al utilizar el SDK (versión 21.10 o posterior). Por ejemplo, puede sustituir los iconos de estrella por defecto utilizados para los botones de comentarios por otro icono.

Este componente puede devolver las siguientes acciones:

Puede utilizar las siguientes variables del sistema para la salida de mensajes mediante los estados de transición:

• system.userFeedbackRating: devuelve la calificación del usuario.
• system.userFeedbackText: cuando enableTextFeedback está definido en true, la aptitud puede solicitar comentarios cuando las calificaciones están por debajo del valor threshold. system.userFeedbackText devuelve la entrada del usuario (${system.userFeedbackText.value}).

El texto de visualización estándar del componente se almacena en las entradas del grupo de recursos. Estas entradas de paquete tienen texto predeterminado, pero puede personalizarlas. A continuación se muestran las entradas de este componente:

Copia valores de una variable a otra.

Las definiciones de estas propiedades no tienen que reflejarse entre sí. Si bien puede definir las variables de destino y de origen como listas de variables, también puede definir la variable de origen con una única variable y el destino como una lista. Si define una variable de destino adicional, hereda el valor de variable del valor de origen de procedimiento especificado.

Este componente define los valores de las variables especificadas como nulos.

El componente Definición de Variables define el valor de una variable predefinida.

El componente Detectar Idioma utiliza el servicio de traducción para detectar el idioma del usuario a partir de la entrada del usuario.

Este componente establece una variable denominada profile.languageTag con la cadena de configuración regional. Se pueden definir variables con el idioma actual si se utiliza en una expresión de valor (${profile.languageTag}).

Este componente envía el texto especificado al servicio de traducción de la aptitud y, a continuación, almacena la traducción al inglés. Se basa en la aptitud que se está configurando con un servicio de traducción, que reconoce el idioma de la entrada del usuario y la convierte al inglés. Este componente no funciona con aptitudes que utilizan el modo de idioma con soporte nativo.

Utilice este componente cuando necesite procesar el texto de entrada sin formato antes de traducirlo. Por ejemplo, puede que desee eliminar datos personales de la entrada de usuario antes de enviarla al servicio de traducción.

Dado que este componente utiliza el servicio de traducción, que detecta el idioma del usuario, este componente no necesita seguir los estados que detectan o establecen el idioma.

El componente Resultado de Conversión permite traducir texto especificado al idioma del usuario. El componente toma el valor definido para la propiedad Expresión. Utiliza el servicio de traducción de la aptitud para traducir el texto al idioma detectado por el componente Idioma de detección o por la variable profile.locale y, a continuación, lo almacena en la variable especificada por la propiedad Variable.

Este componente no funciona con aptitudes que utilizan el modo de idioma con soporte nativo.

El componente Entidad de coincidencia llama al motor de intenciones para extraer la información de la entidad del texto contenido por la propiedad Variable de origen. Si existe una coincidencia para el tipo de entidad de la variable, esta especificada por la propiedad Variable se establece con este valor de entidad.

Este componente también tiene dos transiciones predefinidas: match y nomatch.

Utilice este componente para obtener el código de autorización para servicios protegidos por el flujo de concesión de código de autorización, como LinkedIn, Twitter, Google o Microsoft. Los componentes personalizados de la aptitud pueden intercambiar el código de autorización por un token de acceso, que luego utilizan para llamar el servicio final.

El componente dirige en primer lugar al usuario a la página de conexión del proveedor de identidad. Después de una conexión correcta, el componente devuelve el código de autorización en una variable, que se utiliza para transferir el código de autorización al componente personalizado. La API de componente personalizado debe intercambiar el código de autorización, el ID de cliente y el secreto de cliente para un token de acceso de usuario OAuth.

Para cada estado que requiere autorización antes de que se pueda llamar, defina su configuración Necesita autorización en True. Consulte Autorización de usuario para conocer los pasos para configurar esta configuración.

${(system.message.channelConversation.channelType=='twilio')?then('false','true')}

Este componente puede devolver las siguientes acciones:

El texto de visualización estándar del componente se almacena en las entradas del grupo de recursos. Estas entradas de paquete tienen texto predeterminado, pero puede personalizarlas. A continuación se muestran las entradas de este componente:

Consulte Modify a Resource Bundle Entry para conocer los pasos para cambiar el mensaje predeterminado para una entrada de grupo de recursos.

Cuando el motor de diálogo encuentra este componente, el bot de aptitud solicita al usuario dos enlaces: Conexión y Cancelar.

Descripción de la ilustración fb-oauth.png

Hay varias formas de realizar la transición desde este componente:

• El usuario hace clic en el botón Cancelar y el componente pasa al estado que especifica la acción fail.

• El usuario no hace clic en ningún botón, sino que introduce texto en su lugar. El componente pasa al estado especificado por la acción textReceived.

• El usuario hace clic en el enlace de conexión y el canal representa la página de conexión del proveedor de identidad o el cuadro de diálogo de autenticación en forma de vista web, como se muestra en el siguiente ejemplo. Tras una autorización correcta, el componente pasa al estado especificado por la acción pass (o al siguiente estado si no hay una acción pass), que normalmente llamaría a un componente personalizado que intercambia el código de autorización por un token de acceso.

Descripción de la ilustración webview-login.png

Si la ventana de prueba no representa la vista web, corte y pegue el texto del enlace en el explorador.

Utilice este componente para obtener un token de acceso de usuario OAuth2 (código de autorización de tipo de permiso) para los recursos protegidos por OCI IAM, Oracle Access Manager (OAM), la plataforma de identidad de Microsoft o la autorización de Google OAuth 2.0. Este componente completa todos los pasos del flujo de OAuth2 en 3 partes y devuelve el token de acceso de OAuth2.

Para cada estado que requiere autorización antes de que se pueda llamar, defina su configuración Necesita autorización en True. Consulte Autorización de usuario para conocer los pasos para configurar esta configuración.

Si necesita obtener un token de acceso con el tipo de permiso Credenciales de cliente para acceder a los recursos del cliente, consulte OAuth 2.0 Client.

Para poder utilizar este componente en una aptitud, debe realizar las siguientes tareas:

1. Si aún no se ha registrado, registre el cliente con el proveedor de identidad, tal y como se describe en Registro de proveedor de identidad.
2. Agregue un servicio de autenticación para el proveedor de identidad, como se describe en Servicios de autenticación.

Algunos proveedores de identidad han emitido tokens de refrescamiento. Cuando se utilizar este componente, Digital Assistant almacena el token de refrescamiento para el período de retención especificado para el servicio de autenticación. El backend de Digital Assistant puede utilizar el token de refrescamiento, si está disponible, para obtener un nuevo token de acceso sin que el usuario tenga que volver a conectarse.

${(system.message.channelConversation.channelType=='twilio')?then('false','true')}

Este componente puede devolver las siguientes acciones:

El texto de visualización estándar del componente se almacena en las entradas del grupo de recursos. Estas entradas de paquete tienen texto predeterminado, pero puede personalizarlas. A continuación se muestran las entradas de este componente:

Consulte Modify a Resource Bundle Entry para conocer los pasos para cambiar el mensaje predeterminado para una entrada de grupo de recursos.

Cuando el motor de diálogo encuentra el componente, el bot de aptitudes solicita al usuario dos enlaces: Obtener un token de acceso y Cancelar (puede utilizar linkLabel y cancelLabel para cambiar el texto del enlace).

Si el usuario hace clic en el enlace para obtener un token de acceso, se muestra la página de conexión del proveedor de identidad o el diálogo de autenticación especificado por el servicio de autenticación. Tras establecer una conexión correcta, obtiene el token de acceso, define los valores para las variables identificadas por accessTokenVariableName y authenticatedUserVariableName y, a continuación, fluye al estado con el nombre de la acción pass (o al siguiente estado si no hay una acción pass). Si el usuario cancela, la acción de devolución se establece en fail. Si el usuario introduce texto, devuelve la acción textReceived.

Como se ha mencionado anteriormente, puede definir requiresAuthorization para un estado a fin de garantizar que el usuario esté autorizado antes de llamar al componente de estado. Si el usuario aún no ha autorizado, el cuadro de diálogo invoca el evento Autorizar usuario.

Utilice este componente para obtener un token de acceso de OAuth2 del tipo de permiso Credenciales de cliente. Es decir, puede utilizarlo para obtener un token de acceso basado en las credenciales del cliente, no en el nombre y la contraseña del usuario. Puede utilizar este componente para obtener un token que permita acceder a los recursos del cliente protegidos por Oracle Identity Cloud Service u Oracle Access Manager (OAM).

Si necesita acceder a recursos en nombre de un usuario, consulte OAuth 2.0 Enlace de cuenta y OAuth Enlace de cuenta.

Para poder utilizar este componente en una aptitud, debe realizar las siguientes tareas:

1. Si aún no se ha registrado, registre el cliente con el proveedor de identidad, tal y como se describe en Registro de proveedor de identidad.
2. Agregue un servicio de autenticación de credenciales de cliente para el proveedor de identidad, como se describe en Servicios de autenticación.

Este componente no incluye ninguna acción. Para manejar los problemas del sistema que puedan surgir, agregue una transición que pase a un estado que pueda manejar este tipo de errores.

Utilice este componente para revocar todos los tokens de acceso de usuario y los tokens de refrescamiento de usuario conectado del proveedor de identidad que representa el servicio de autenticación. También elimina los tokens de refrescamiento de la base de datos. Para utilizar este componente, debe proporcionar el URL del token de refrescamiento de revocación del proveedor de identidad en la interfaz de usuario del servicio de autenticación.

La aptitud debe incluir un estado que utilice el componente OAuth 2.0 Account Link para el mismo servicio de autenticación y se debe llamar antes que el estado que utiliza este componente.

Este componente puede devolver la siguiente acción:

Utilice este componente para cambiar los estados en función del valor de una variable.

Este componente determina una ruta de ejecución resolviendo una variable o expresión y, a continuación, disparando una acción de transición correspondiente que se asigna a un estado del flujo.

Las acciones de transición se definen y asignan en el separador Transiciones del inspector de propiedades.

Con este componente, llama a un flujo secundario desde el flujo actual, transfiriendo opcionalmente parámetros de entrada. Cuando finaliza el flujo secundario, devuelve una acción y parámetros de salida opcionales a su flujo principal.

Las acciones de transición que se pueden definir dependen de las acciones definidas en el componente End Flow del flujo secundario.

Con este componente, llama al flujo de una aptitud diferente y, opcionalmente, transfiere parámetros de entrada. Cuando finaliza el flujo llamado, devuelve una acción y parámetros de salida opcionales al flujo de llamada.

Antes de utilizar este componente, debe haber un flujo público disponible en la aptitud a la que llama. Consulte Llamada a otra aptitud desde un flujo.

ParamName: ParamValue

Este componente se utiliza para finalizar explícitamente un flujo.

Cuando se alcanza este estado, todas las variables del flujo se borran y el control se devuelve al flujo principal (o, si no hay un flujo principal, al flujo principal).

No necesita un estado de flujo de finalización para un flujo si no necesita devolver parámetros o acciones del flujo a un flujo principal o al flujo principal.

Esta plantilla consta de los componentes Agent Initiation y Agent Conversation. Estos componentes se utilizan conjuntamente para transferir la conversación de una aptitud a un agente de Oracle B2C Service.

• El componente Iniciación de Agente inicia el establecimiento de comunicación con el canal de integración de agente especificado por la propiedad Canal de integración de agente del componente.
• El componente Conversación de agente gestiona el intercambio entre la aptitud y el agente activo.

Esta plantilla es para conversaciones originadas en la aptitud. No utilice esta plantilla para conversaciones originadas en el chat de Oracle B2C Service, como se describe en El marco del asistente digital como agente en acción.

Utilice el componente de transferencia de agente de los asistentes digitales de tipo asistente digital como agente para devolver la conversación al servicio de chat. La conversación se enrutará a un agente activo según las reglas del chat configuradas en el servicio de chat.

Este componente es para conversaciones que se originan en un chat de servicio, como se describe en El marco del asistente digital como agente en acción. Para conversaciones originadas en la aptitud, utilice la plantilla de comunicación de agente en su lugar.

Puede utilizar el componente Condición de transferencia de agente de los asistentes digitales DA-as-agent para determinar si los agentes están disponibles y, si es así, el tiempo de espera esperado.

Las propiedades del componente se utilizan para especificar las condiciones de transferencia y devuelve una acción que indica si se han cumplido las condiciones. Además, define los valores de la variable de asignación con nombre.

A continuación se muestra la estructura del valor de la Variable de estado de disponibilidad de agente y la información almacenada en ella:

queueId (integer, optional): The engagement queue ID,
expectedTotalWaitSeconds (integer, optional): Expected wait time in the queue in seconds
        ( -1 if there's inadequate information, zero or greater otherwise ).,
expectedWaitSeconds (integer, optional): The number representing the "ss" segment of the expected wait time of format mm:ss 
        ( -1 if there's inadequate information, zero or greater otherwise ).,
expectedWaitMinutes (integer, optional): The number representing the "mm" segment of the expected wait time of format mm:ss 
        ( -1 if there's inadequate information, zero or greater otherwise ).,
availableAgentSessions (integer, optional): Total number of sessions available across all agents.,
totalAvailableAgents (integer, optional): Total number of agents whose status is available.,
totalUnavailableAgents (integer, optional): Total number of agents whose status is unavailable.,
totalAgentsRequestingNewEngagement (integer, optional): Total number of agents who are available and have capacity.
outsideOperatingHours (boolean, optional): True if outside operating hours. False if inside operating hours.,
engagementsInQueue (integer, optional): The number of engagements currently in the queue.
sessionId (string, optional): The session ID.,
clientId (integer, optional): The client ID.

This might take {minutes, plural,
     =-1 {}
     =0 {}
     =1 {1 minute and }
     other {# minutes and }
}{seconds, plural,
     =-1 {a while}
     =0 {{minutes, plural,
          =0 {a short wait time}
          other {0 seconds}
        }}
     =1 {1 second}
     other {# seconds}
} to connect. Are you willing to wait?

Utilice este componente para enviar una solicitud HTTP a un punto final de REST que haya configurado en la configuración de servicios de API.

Estas son las propiedades del componente:

El componente devuelve estas acciones:

Para obtener más información, consulte Acceso a backends mediante el componente de servicio REST.

Utilice este componente para buscar información sobre un término de búsqueda determinado en Oracle B2C Service Knowledge Foundation u Oracle Fusion Service Knowledge Management y mostrar los resultados.

Para Oracle B2C Service, los resultados de búsqueda dependen de si las respuestas son públicas y de cuáles sean los valores de nivel de acceso, producto o categoría.

Tenga en cuenta que debe crear un servicio de búsqueda de conocimientos para poder utilizar este componente. Consulte Adición de un servicio de búsqueda de conocimientos.

Estas son las propiedades del componente de búsqueda de conocimiento:

La plantilla Creación de incidentes se utiliza para crear un informe de incidentes en un sitio de servicio al cliente. Tenga en cuenta que debe crear una integración de servicio al cliente en la página Configuración > Servicios adicionales > Integración de servicio al cliente para poder utilizar este componente en la instancia.

Utilice este componente para acceder a una entrevista de Oracle Intelligent Advisor desde una aptitud.

Debe crear una integración de servicio de Intelligent Advisor para poder utilizar este componente. Consulte Adición de un servicio de Intelligent Advisor. Además, la entrevista se debe haber desplegado en el hub de Intelligent Advisor y se debe activar en el canal de servicio de chat. La entrevista debe ser para usuarios anónimos. No puede acceder a entrevistas para usuarios de portal o usuarios de agente.

Puede utilizar las propiedades del componente para especificar la siguiente configuración de entrevista:

• Si se van a mostrar los títulos y la explicación
• Las etiquetas de los botones Sí, No y No lo tengo claro
• Las cadenas que el usuario introduce para restablecer, volver a la pregunta anterior (deshacer) y salir de la entrevista
• El texto que se mostrará al final de la entrevista
• Cómo formular la pregunta sobre si se va a mostrar la explicación
• La cadena que introduce el usuario para indicar que ha terminado de cargar los archivos
• Los valores de atributo y los parámetros de conector que se transferirán a la entrevista
• Configuración regional del proyecto que se va a utilizar

El componente Vista web abre una vista web dentro de la aptitud o, en el caso de las aptitudes que se ejecutan en un canal web, en un separador del explorador.

Este componente se utiliza para enviar una notificación a un usuario cuando se ha producido un evento basado en la nube de un tipo que se ha registrado en Oracle Digital Assistant. Consulte Eventos externos para obtener información sobre el registro de tipos de eventos y la configuración de un asistente digital para consumir el evento.

Utilice este componente para publicar externamente un evento basado en la nube de un tipo que se haya registrado en Oracle Digital Assistant. Consulte Eventos externos para obtener información sobre el registro de tipos de eventos y la configuración de un asistente digital para publicar y consumir eventos.

A continuación, se muestra un ejemplo de carga útil que se podría utilizar como valor para la propiedad Data:

{
    "size": "Large",
    "type": "Veggie"
}

        "system.postbackActions": {
          "small": {
            "postback": {
              "variables": {
                "size": "Small"
              },
              "system.botId": "44F2405C-F317-4A3F-8250-617F54F01EA6",
              "action": "Small",
              "system.state": "size"

En este punto, el sistema compara la propiedad system.state de la carga útil de la acción de devolución entrante con el estado actual. Si no coinciden, la aptitud ejecuta una transición que puede, en función de cómo se haya configurado el flujo de diálogo, respetar o denegar la petición del usuario.

Puede cambiar el comportamiento por defecto del manejo de mensajes en desorden asignando el evento de transición del sistema Mensajes en desorden a un componente de flujo de llamada que llama a un flujo que ha proporcionado para el manejo de mensajes en desorden.