Request Rich Menu by Name
Nombre del elemento: Request Rich Menu by Name
Categoría: Variable manipulation
Descripción: Invoca la solicitud de una entidad de tipo Lista al cliente. El formulario de solicitud es enriquecido con valores adicionales que mejoran su apariencia. Pause el flujo de control de Lynn hasta que el usuario ingrese el valor requerido.
Funcionalidad: Modulo de extensión que permite solicitar menú con texto de multimedia enriquecida como video, imagen o document, el cual se encuentra orientado para canal WhatsApp
Para su configuración se debe tener en cuenta los siguientes parámetros:
Configuraciones de la acción
Sección 1: Configuraciones relacionadas con la entidad (Requerido)
Nombre: Campo de tipo string para ingresar el identificador único del componente dentro del flujo.
Nombre de la entidad de tipo Lista: Campo de tipo select que permite seleccionar la entidad de tipo lista que se mostrará al cliente.
Texto del menú obtenido de una expresión (opcional): Campo de tipo string expression para definir el texto que se mostrará como encabezado del menú. Si este campo se deja vacío, se usará por defecto el texto definido en la entidad. Esta opción permite construir encabezados dinámicos, concatenando entidades.
Opciones del menú obtenidas de una expresión (opcional): Campo de tipo string expression para definir dinámicamente las opciones del menú. Deben cumplir con la estructura ["val 1", "val 2"]. Si se deja vacío, se usarán las opciones definidas en la entidad seleccionada. Tambien se pueden concatenar ea esta estructura, entidades, por ejemplo: '["Opcion Programable 1","+ent2+"]', concanenándose en este caso la entidad ent2
Tipo de cabecera: Campo de tipo select que permite elegir el tipo de cabecera del menú. Las opciones disponibles son: texto, imagen, video, documento o ninguno.
Important
Si se selecciona una opción distinta a "ninguno", se habilitará la sección Configuración relacionada al Header de Texto-Video-Imagen-Documento.
Permitir valor nulo o vacío: Campo de tipo boolean. La opción "Sí" permite que el usuario no seleccione ningún valor; la opción "No" fuerza la selección de una opción válida.
Máximo de intentos fallidos: Campo e tipo number para ingresar el número de intentos permitidos para que el cliente ingrese una respuesta válida. Si se alcanza este límite, se activará la intención de error configurada.
Mensaje de valor no válido (obtenido de una expresión): Campo de tipo string expression que define el mensaje a mostrar cuando el cliente ingresa un valor incorrecto.
Intención a ejecutar si se alcanza el máximo de intentos fallidos: Campo de tipo select para definir la intención que se activará si el usuario excede el número máximo de intentos. El error se pasará a la variable Request_Rich_Menu_Error.
Sección 2: Presentación del Menú en WhatsApp (Opcional)
Sobrescribir la configuración del canal para presentar el menú: Opción Sí o No para indicar si se desea reemplazar la configuración actual del canal.
Forma de presentación del menú: Campo select para elegir cómo se presentará el menú en WhatsApp. Las opciones son:
Text: como mensaje de texto.Button: como botones interactivos.List: como lista desplegable.
Idioma para los textos predeterminados del menú interactivo: Lista de idiomas disponibles en la configuración de Lynn.
Sección 3: Configuración relacionada con el pie de página (Opcional)
Expresión para obtener el texto del pie de página: Campo de tipo string expression para definir el contenido del pie de página que acompañará al menú.
Configuración relacionada al Header de Texto-Video-Imagen-Documento (Opcional)
Para headers de tipo Texto:
Expresión para obtener el contenido del header de texto: Campo de tipo string expression para definir el contenido textual del encabezado.
Para headers de tipo Video:
- Expresión para obtener la URL del header de video: Campo de tipo string expression que define la URL del video.
- Expresión para obtener el content type del header de video: Campo string expression para definir el tipo de contenido del video.
- Expresión para obtener el nombre del archivo del header de video: Campo string expression para definir el nombre del archivo.
Para headers de tipo Imagen:
- Expresión para obtener la URL del header de imagen: Campo string expression que define la URL de la imagen a mostrar.
Para headers de tipo Documento:
- Expresión para obtener la URL del header de documento: Campo string expression que define la URL del documento a mostrar.
- Expresión para obtener el content type del header de documento: Campo string expression que define el tipo de contenido del documento.
Ejemplo Implementación Request Rich Menu by Name
-- Requisitos:
Previamente deberá crear la entidad tipo menu: prueba_menu <--- Selecciones una de las opciones:
-- Entrada:
Nombre: PruebamenuRRMBN
[El nombre de la Entidad de tipo Lista] prueba_menu
[Texto del menu] 'Seleccione la demo a mostrar'
[Opciones del menu] '["Demo E-Bank","Demo Proactive"]'
[Tipo de cabecera.] Image
[Permitir valor nulo o vacío.] No
[Máximo de intentos fallidos.] 3
[Mensaje de valor no válido obtenido de una expresión.] 'Seleccione una opción válida'
[Si se alcanza el máximo de intentos fallidos, el flujo de acción se interrumpirá y la descripción del error se pasará a la intención seleccionada con el nombre: 'Request_Rich_Menu_Error'.] Error_Handler
Configuración relacionada con el Pie de Página. (Opcional)
[Expresión para obtener el código de Pie de Página] 'Descubre nuestros servicios'
Configuración relacionada al Header de Imagen. (Opcional)
[Expresión para obtener la URL del Header de Imagen]: ‘https://lynnlatamtestingbrstr.blob.core.windows.net/icons/EbankDise%C3%B1oImagen%20MEnu.png’
--- Resultado:
A continuación, se observa como resultado la imagen configurada como Header y menú configurado para la entidad “prueba_menu”
