Request Entity by Name

Categoría: Variable manipulatio

Descripción: Módulo de extensión que permite permiten invocar la solicitud de una entidad al cliente, desde campos configurables.

Funcionalidad: Utilice este módulo de extensión para invocar una solicitud de respuesta por parte del cliente a traves de una entidad, estas pueden ser un dato en especifico, tales como teléfono, rut, mensaje, encuesta etc.

Implementación

Presentación al solicitar la entidad: Campo de tipo lista desplegable permite elegir el estilo de presentación con el que la entidad se mostrará al usuario.

• Al seleccionar Default, la entidad se presentará con el formato de visualización predeterminado.

• Al seleccionar Menú, aparecerán dos subconjuntos de configuración opcionales adicionales: Presentación del Menú en WhatsApp y Configuración necesaria para Menú Enriquecido. Puedes consultar más detalles sobre la configuración de estas opciones AQUÍ

El nombre de la entidad obtenido de una expresión: Campo de tipo string permite ingresar una expresión que se desea evaluar. Puede completarse con una entidad o texto, el cual debe estar entre comillas simples para ser reconocido como tal.

Permitir valor nulo o vacío obtenido de una expresión: Campo de tipo Boolean permite especificar si el cliente podrá ingresar datos en blanco para la entidad creada. Si se ingresa false, el cliente debe proporcionar datos obligatoriamente, y de no hacerlo, se considerará un error. Si se ingresa 'true', el cliente podrá dejar en blanco la solicitud de datos.

Máximo de intentos fallidos obtenidos de una expresión: Campo de tipo integer en el cual se define la cantidad de intentos fallidos permitidos para el cliente. Es decir, si es configurado como 3 intentos fallidos, el cliente tendrá tres oportunidades de ingresar el dato correcto que se le solicita.

Mensaje de valor no válido obtenido de una expresión: Campo de tipo string que permite definir permite definir un mensaje entre comillas simples, que se mostrará cuando el cliente ingrese datos incorrectos.

Ejemplo:

‘El dato ingresado no corresponde a lo solicitado, favor reintentar.’

Json para definir las validaciones que se aplicaran sobre las entidades solicitadas en los canales soportados: Se define una expresión en formato json la cual contendrá validaciones sobre la entidad creada; pudiendo o no ser ejecutada, según el criterio configurado. Esta configuración solo es válida para entidades tipo date

Ejemplo:

{
    "validationType": "datetime",
    "weekdays": ["mo", "tu", "we", "th", "fr", "st", "su"],
    "disableCurrent": false,
    "disableBefore": 1,
    "disableAfter": 0,
    "disabledDates": ["2022-06-14", "2021-12-31"],
    "interval": 5,
    "hourBefore": 0,
    "hourAfter": 1,
    "days": {
        "mo": [{
            "start": "15:00",
            "end": "17:00"
        }],
        "tu": [{
            "start": "08:00",
            "end": "09:00"
        }],
        "we": [{
            "start": "08:00",
            "end": "22:00"
        }],
        "th": [{
            "start": "08:00",
            "end": "09:30"
        }],
        "fr": [{
            "start": "08:00",
            "end": "09:30"
        }],
        "st": [{
            "start": "08:00",
            "end": "22:00"
        }],
        "su": [{
            "start": "08:00",
            "end": "22:00"
        }]
    }
}

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_Entity_Error': Lista desplegable donde debe seleccionar nombre de la intención para el manejo de errores. Al ejecutarse un desborde de error la entidad Request_Entity_Error será cargada con el detalle de error si el mismo se encuentra disponible.

Ejemplo de implementación

El ejemplo consiste en solicitar la selección de una opción

Campo	Valor
Nombre	Encuesta1
El nombre de la entidad obtenido de una expresión	'encuesta_1'
Permitir valor nulo o vacío obtenido de una expresión	false
Máximo de intentos fallidos obtenidos de una expresión	3
Mensaje de valor no válido obtenido de una expresión	'error'
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_Entity_Error'	Error_Handler

A continuación, se muestra el resultado de la implementación de este módulo de extensión