Saltar a contenido

Generación de respuestas

Una vez que el bot identifica el skill que representa la expresión del usuario, este debe recibir una respuesta concordante.

Caso de uso

Independientemente del tipo de skill asignado, el bot debe devolver una respuesta al skill detectado.

Ejemplo

Como respuesta al skill menú, el bot podría mostrar en formato de botones las dos opciones. Ver Pedido y Promociones

Implementación

Para ello, en la sección de Acciones se va a programar el resultado del skill en el que estamos trabajando. Tenga en cuenta que:

  • Las acciones definidas se ejecutarán acorde al orden establecido. Para ordenar una acción, seleccione y arrastre hacia la posición específica.
  • En cada tipo de respuesta, se debe determinar el canal para el cual habilita la ejecución de esa acción escogiendo entre los iconos de los canales de Twitter, Facebook, Telegram o WhatsApp.
  • Tiene la posibilidad de personalizar un mensaje con las siguientes palabras reservadas propias de Yanibot:
Palabra Reservada Descripción Canal
${name!} Toma el nombre del usuario con el que se identifica en los diferentes canales Facebook, Microsoft Teams, Telegram, (En WhatsApp mostrará la palabra "cliente")
${whats!} Toma el nombre del contacto en caso de tenerlo registrado caso contrario tomará el número telefónico Solo WhatsApp
${email!} Toma el email del usuario Solo Microsoft Teams
${dept!} Toma el nombre del departamento al que pertenece Solo Microsoft Teams

acciones

Yanibot

Acceda a las variables almacenadas en memoria a través de la siguiente estructura: ${nom_variable!}

  • Puede devolver una respuesta en diferentes formatos:

Texto

El bot le presentará el texto ingresado como respuesta al skill.

Botón

Tipo de respuesta interactiva que le impulsa al usuario a seleccionar alguna de las opciones expresadas en forma de botón. Para ello seleccione Botón e ingrese lo siguiente:

  • El texto que representa el conjunto de botones siguientes.
  • El texto a mostrar al usuario cuando se ingresa alguna opción no válida.

  • Agregar botón: Ingrese un título de botón, un subtítulo en el caso de ser necesario, no es un campo obligatorio. Puede agregar hasta 3 botones de los diferentes tipos:

    • URL: dirige a la URL ingresada.

    • POSTBACK: Debe ingresar un título, subtítulo y la variable que Yanibot identifica para procesar ese dato.

      Tip

      Si desea identificar la acción de este botón con una expresión de entrada de un skill, identifíquelos con una expresión única para que Yanibot los asocie.

    • LLAMAR: al número establecido. Opción válida para integraciones con Facebook, Twitter y web.

    Tip

    Tenga presente al canal al cual va dirigido. WhatsApp no acepta la interacción con botones, por lo que una opción es crear una nueva respuesta en texto numerando las opciones y marcando el icono de WhatsApp para que esta respuesta sea ejecutada al uso de este canal.

boton

Card

Permite mostrar una imagen junto con acciones definidas en forma de botón. Se implementan las mismas características de los botones.

Carrousel

Una secuencia de cards independientes. Puede agregar hasta 10 cards.

!!! tip Si en el primer card del carousel ingresa una imagen, los siguientes cards deberán contener también imágenes para generar una misma estructura visual.

carrousel

WebHook

-   POST: permite la transferencia de información en el cuerpo de la solicitud por medio de http.
-   GET:XXXXX
-   PATCH: XXX
-   PUT: XXX

webhook

Skill

Redirección inmediata a un skill seleccionado siempre y cuando cumpla una o varias condiciones establecidas. En el caso de existir varias acciones tipo skill, estas se ejecutarán en el orden establecido hasta que se cumpla las condiciones asignadas en alguna de las acciones.

skill

Solicitud de requerimientos a través de Acciones

Uno de los casos más comunes donde la generación de respuestas toma importancia es el caso donde se necesita solicitar y guardar en memoria los datos del usuario.

Los pasos lógicos a implementarse serían:

  1. Verificar que el valor solicitado se encuentra en memoria. Esta intención la podemos realizar a través un tipo de acción Skill, donde te permite dirigir a otro skill si el valor del requerimiento solicitada ya se encuentra en memoria.

  2. Caso contrario solicitar ese dato a través de un tipo de acción Texto. Ejemplo: "Ingrese su número de cédula".

    Para ello, en el mismo skill se debe establecer el tipo de requerimiento que se va a recibir, y procedera guardar este dato en la memoria del bot.

requerimientos_acciones