Adaptive Cards

NiCE CXone Bot Builder admite el uso de Adaptive Cards en las respuestas del bot.Puede usarlos en historiasClosed Used to train a bot for interaction handling based on intent and context., reglasClosed Used to define a bot response to messages that don't change with context. y respaldoClosed A plain text alternative sent when the destination doesn't support rich media..

Desarrollado por Microsoft, Adaptive Cards An icon of a square with an arrow  pointing from the center out to the upper right corner. SOn un método para crear contenido de rich messagingClosed Elements in digital messaging such as buttons, images, menus, and option pickers.. SOn un formato de intercambio de tarjetas abiertas que le permiten enviar contenido UI de forma común y congruente. Con Adaptive Cards, puede enviar mensajes interactivos que SOn más complejos y más útiles que aquellos que contienen únicamente elementos estándar de contenido multimedia enriquecido.

Actualmente, solo conversación digital admite Adaptive Cards. Los canales de chat en vivo actualmente admiten tarjetas adaptables en MAX, pero no en Agente. Si se envían mensajes con Adaptive Cards en otros canales, se utiliza en su lugar el texto de alternativaClosed A plain text alternative sent when the destination doesn't support rich media. designado.

Bot Builder No tiene ninguna Adaptive Cards disponible de manera predeterminada.Debe diseñar las suyas propias usando el diseñador Microsoft Adaptive Card, que está integrado en Bot Builder.

Con el diseñador de Adaptive Card, puede crear plantillas de Adaptive Card para usar con Bot Builder. Cuando un bot ejecuta una respuesta que incluye una plantilla de Adaptive Card, la plantilla se completa de forma dinámica con la información adecuada para esa interacción y se envía al contactoClosed The person interacting with an agent, IVR, or bot in your contact center..

Compatibilidad de las Adaptive Card por Canal

Las Adaptive Cards sólo se pueden usar en canales que las admitan. Actualmente, solo admite canal de chat Digital.

Si el bot envía mensajes en canales que admiten Adaptive Cards, así como en canales que no los admiten, debe configurar la alternativa de mensajería enriquecida fallbackClosed A plain text alternative sent when the destination doesn't support rich media.. La alternativa se envía en lugar de los Adaptive Card en los canales que no los admiten. Puede configurar la alternativa de mensajería enriquecida para cada respuesta del bot que use Adaptive Cards.

Diseñador de Adaptive Card

El diseñador de Adaptive Card le permite crear plantillas de Adaptive Card para usar con Bot Builder. Cuando crea una historia, regla o alternativa, puede agregar la Adaptive Card acción de bot y luego elegir una de las Adaptive Cards que creó.

El diseñador de Adaptive Card es un producto de Microsoft integrado en Bot Builder. Hay documentación detallada sobre el uso del diseñador disponible en el Microsoft Adaptive Card sitio webUn icono de un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha..

Puede usar cualquier elemento disponible de Adaptive Card en las tarjetas que desarrolle. Para personalizar dinámicamente un Adaptive Card, puede usar variables de slotClosed Entity extracted from contact's message and saved for use in bot responses. Similar to a variable.. Si desea devolver datos a su bot, puede incluir datos de postback en las configuraciones de elementos tales como un botón. Por ejemplo, esto le permite devolver al bot la intención asociada con la elección del contacto.

Personalizar las Adaptive Cards con variables de ranura

You can include slot variables in your Adaptive Cards. This allows you to display the entityClosed A piece of information gathered from the contact's messages during conversations with a bot. associated with the slotClosed Entity extracted from contact's message and saved for use in bot responses. Similar to a variable. on the card when the card is sent to a contact.

Una variable de ranura se construye usando el nombre de la entidad asociada con la ranura entre llaves. Por ejemplo, {phone_number}. Puede usar variables de ranura en las propiedades de un elemento en el diseñador de Adaptive Card. También puede buscar el elemento en la sección editor de Carga útil de la tarjeta del diseñador de Adaptive Card y agregar la variable de ranura al elemento. Por ejemplo, "text": "Phone Number: {phone_number}".

Botones interactivos

Puede incluir botones interactivos en sus Adaptive Card. Los puede agregar a cualquier elemento con una sección Acciones en sus propiedades. Existen varios tipos de botones en el diseñador de Adaptive Card que puede utilizar. Los siguientes tipos de botón SOn particularmente útiles con Bot Builder:

  • Botón de URL: El botón abre una URL. El JSON para este tipo de botón se ve como el siguiente ejemplo:

    {
      "type": "Action.OpenUrl",
      "title": "View",
      "url": "http://www.nice.com"
    }
  • Botón de retorno de datos: El botón envía datos de retorno al bot cuando el cliente hace clic o toca el botón. Puede usarlo para enviar una intenciónClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. de regreso al bot. El JSON para este tipo de botón se ve como en el siguiente ejemplo:

    {
     "type": "Action.Submit",
     "title": "Connect with agent",
     "data": {
    	"text": "/[intentName]"
     }

Crear una Adaptive Card

Las Adaptive Cards nuevas comienzan con un conjunto de elementos de ejemplo de manera predeterminada. Puede modificar los elementos de ejemplo o eliminarlos a todos para construir una tarjeta desde cero.

Después de crear un Adaptive Card, puede usarlo en una respuesta de bot.

  1. En NiCE CXone, haga clic en el selector de aplicaciones Icon of three-by-three grid of white squares on a blue background y seleccione Otros > Bot Builder.
  2. Haga clic en el bot con el que desea trabajar.
  3. Haga clic en Preferencias > Adaptive Cards.
  4. Para crear una carpeta, haga clic en el signo más Icon of a plus sign inside a circle. e ingrese un nombre, luego presione intro.
  5. En la carpeta a la que desea agregar un Adaptive Card, haga clic en el signo de más Icon of a plus sign inside a circle..
  6. Escriba un nombre para la tarjeta y pulse intro.
  7. Add elements to your card: 
    • Haga doble clic en una opción dentro de Elementos de tarjeta para agregarla.
    • Arrastre y suelte un elemento desde la sección Elementos DE TARJETA hacia la vista previa de la tarjeta.
    • Haga clic en la brújula Icon of four arrows in a circle. de un elemento en la vista previa de la tarjeta y arrastre el elemento a una nueva ubicación.
  8. Configure your element's properties:
    • Seleccione un elemento en la vista previa o en la sección Estructura de la tarjeta. La sección Propiedades del elemento muestra las propiedades del elemento seleccionado. Modifíquelas según sea necesario. Cada elemento tiene un conjunto distinto de propiedades.
    • Use el Card Payload editor para ver, configurar o modificar las propiedades de un elemento.
    • Haga clic en el X de la esquina superior derecha de la vista previa para eliminar un elemento.
  9. Use una ranura en un elemento ingresando el nombre de entidad en un campo de propiedad de elemento. Escriba el nombre entre llaves.Por ejemplo, {phone_number}.
  10. To add an interactive button to the card, configure an action in your card as follows: 
    • Abrir una URL: Seleccione Action.OpenURL como el Tipo DE acción e ingrese la URL.
    • Enviar datos de postback: Seleccione Action.Submit como Tipo DE acción e ingrese el nombre de la intención en el campo Datos utilizando el formato {"text":"/[intentName]"}.
  11. Para probar el aspecto de su tarjeta en la sección de vista previa, reemplace los datos predeterminados en la sección editor de datos de muestra con datos de ejemplo para su tarjeta.
  12. Los cambios se guardan automáticamente.