Saltar a contenido

Request Entity by Name

Nombre del elemento: Solicitud de entidad por nombre (Request Entity by Name)

Categoría: Manipulación de variable (Variable manipulation)

Descripción: Funcionalidad básica, que contiene campos configurables que permiten invocar la solicitud de una entidad al cliente.

Funcionalidad: Permite llamar a una entidad configurada para obtener una respuesta por parte del cliente, pudiendo ser un dato específico como teléfono, rut etc.., mensaje o encuesta. Esta información podrá ser utilizada posteriormente en el flujo. Tiene una configuración avanzada según el tipo de entidad que desee presentar.

Campos de configuración de acción

[Nombre]: Descriptor único de caja de configuración con fines de identificar la misma en el flujo.

Subconjunto Configuración (requerido)

[Presentación al solicitar la entidad]:Campo de tipo lista que permite seleccionar tipo de entidad a presentar para la solicitud. Si selecciona Default se presenta con el formato entidad por defecto. Si selecciona Menú se despliegan dos nuevos Subconjuntos de configuración opcionales: Presentación del Menú en WhatsApp y Configuración necesaria para menú enriquecido cuya configuración puede consultar AQUÍ

[El nombre de la entidad obtenido de una expresión]: Campo obligatorio de tipo string Expresion donde debe definirse una entidad (previamente ya creada) la cual se encontrará configurada para la recolección de información.

Consultar 🔎: Para crear una entidad

[Permitir valor nulo o vacío obtenido de una expresión]: Se debe indicar si el cliente podrá ingresar datos en blanco para la entidad creada. Si se indica false el cliente debe ingresar datos de forma obligatoria, de no ser así se considerará un dato erróneo. Al indicar true el cliente puede dejar en blanco la solicitud de datos.

[Máximo de intentos fallidos obtenidos de una expresión]: Se define una cantidad de intentos fallidos del 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]: Se define una expresión entre comillas simples. El mensaje estará relacionado con el ingreso erróneo de la data por parte del cliente.

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
    ],
disable_current: false,
disable_before: 1,
disable_after: 0,
disabled:[
    2022-06-14,2021-12-31
],
interval: 5
hour_before: 0,
hour_after: 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
        }]
}

}

[Manejador de errores]: Caja de selección donde se identifica la intención que se activara en caso de presentarse un error en la acción “Encuesta de Satisfacción”. Al ejecutarse un desborde de error la entidad Write_Customer_Satisfaction_Survey_Error, será cargada con el detalle de error si el mismo se encuentra disponible.

Ejemplo de implementación Request Entity by Name

El ejemplo consiste en solicitar el nombre de la persona el cual se utilizará en el saludo.

Precondiciones:

Entidad:  nombrePersona (Tipo String)

Entidad de Sistema: @ClientName <- Luis Pérez

--Entrada

[Presentación al solicitar la entidad]: Default [El nombre de la entidad obtenido de una expresión]: nombrePersona --> Entidad tipo string --> Favor ingrese su nombre [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]: 'El formato ingresado no corresponde, favor ingrese nuevamente su nombre' [Json para definir las validaciones que se aplicaran sobre las entidades solicitadas en los canales soportados]: sin configuración.

Posteriormente insertar una caja de diálogo configurando la sección texto con el siguiente ejemplo:

'Bienvenido '+nombrePersona + '. Esta es una prueba desde Lynn'

--Resultado:

Bienvenido Luis Pérez. Esta es una prueba desde Lynn

Funcionalidad Avanzada

Este módulo de extensión cuenta con una funcionalidad avanzada que se activa al seleccionar Menú en la etiqueta [Presentación al solicitar la entidad]. Puede consultar AQUÍ para más detalles.