Origination

Origination es una herramienta diseñada para optimizar y automatizar procesos complejos en diversos sectores, como la gestión de solicitudes, aprobaciones o registros que requieren la interacción de múltiples partes. Esta característica permite a los usuarios crear y gestionar flujos de trabajo colaborativos en los que diferentes actores pueden participar activamente. A través de Origination, es posible solicitar y recopilar documentación e información entre partes, facilitando la validación y el avance del proceso en función de los requisitos cumplidos.

Una de las principales ventajas de Origination es su capacidad para gestionar flujos de trabajo en múltiples pasos, permitiendo que cada paso sea verificado antes de avanzar, lo que garantiza la precisión y el cumplimiento de cada etapa. Además, Origination ofrece un entorno seguro y eficiente, evitando el intercambio de información confidencial por medios inseguros, lo que reduce el riesgo de errores y asegura la protección de los datos.

Esta funcionalidad no está incluida por defecto en todos los planes de Modyo. Para activarla, es necesario contactar al equipo de Modyo para solicitar su implementación.

Origination está diseñado para cualquier organización que busque agilizar procesos complejos, mejorar la colaboración entre los involucrados y asegurar que el flujo de trabajo se gestione de manera estructurada y segura.

Crear una Nueva Originación

Para crear una nueva originación, sigue estos pasos:

• En el menú lateral, navega a Customers > Reinos y selecciona el Reino en el que deseas trabajar.
• Dirígete a la opción Origination.
• Haz clic en el botón + Nueva originación.
• Asigna un nombre a la originación.
• Haz clic en Crear para finalizar y comenzar a configurar los pasos del nuevo flujo de originación.

Flujos de Originación

Los flujos de originación están compuestos por Pasos y Tareas, que estructuran y definen las acciones necesarias para completar el proceso.

Pasos

Los pasos agrupan tareas que se presentan en una misma pantalla. Para avanzar al siguiente paso, el usuario debe completar todas las tareas asignadas.

Agregar pasos

Para agregar un paso, presiona el botón Añadir y designa los valores

• Nombre: El nombre que se mostrará en la interfaz del usuario para identificar el Paso.
• Identificador: Un valor único que se incluirá en la URL del flujo de originación.

Atención

Cada paso debe incluir al menos una tarea válida para ser guardado.

Tareas

Las tareas son las acciones individuales dentro de cada paso. Estas tareas recopilan información, realizan validaciones o solicitan acciones específicas del usuario. Las tareas se completan de manera secuencial, y al validarse, permiten avanzar al siguiente paso del flujo.

Agregar tareas

Para agregar una nueva Tarea, presiona el botón + Agregar tarea y eso creará un nuevo contenedor de tareas. Al crear una tarea, debes incluir sus valores

• Nombre: El nombre de la tarea que será visible para el usuario.
• Identificador: Un identificador único que se incluirá en la URL de la originación.
• Descripción: Un breve texto explicativo sobre la tarea, que será visible para el usuario.
• Tipo: Selecciona el tipo de tarea en función de los objetivos del flujo.

Tipos de tareas

Los tipos de tareas disponibles son:

• Input: Solicitan información o entrada de datos del usuario.
• Validación: Requieren que un administrador valide la tarea antes de avanzar al siguiente paso.
• Firma: Solicitan al usuario una firma digital.
• Revisión pendiente: Pausa el proceso hasta que un administrador autorice el avance al siguiente paso.
• Snippet de código: Permiten agregar código a la medida.
• Proceso de originación: Llaman a otro flujo de originación dentro de este.
• Invitación: Permiten invitar a otros usuarios a llenar datos necesarios en el flujo.
• Verificación de Identidad: Solicitan al usuario verificar su identidad con captura de documento y biometría a través de un proveedor.
• Confirmación: Solicitan al usuario confirmar las respuestas entregadas en tareas Input anteriores.

Propiedades de la tarea

En este apartado se pueden editar los valores de la tarea seleccionada, puedes encontrar estos valores

• Nombre: El nombre de la tarea que será visible para el usuario.
• Identificador: Un identificador único que se incluirá en la URL de la originación.
• Descripción: Un breve texto explicativo sobre la tarea, que será visible para el usuario.

Edición de identificadores

Al editar un paso, una tarea o un campo ya guardados, el campo Identificador aparece bloqueado con un candado. Para modificarlo debes presionar el candado y confirmar la advertencia Desbloquear campo identificador: cambiar un identificador rompe las referencias desde sistemas externos o mediante el SDK de Liquid y, en el caso de los campos, las respuestas dejan de poder buscarse por ese campo. El identificador solo se genera automáticamente a partir del nombre durante la creación; al editar, cambiar el nombre no lo modifica.

Input

En las tareas Input puedes incorporar una amplia variedad de campos en tus formularios para personalizar la recolección de datos de tus usuarios.

Añadir campos

Para incluir un nuevo campo debes seleccionar una tarea y seleccionar la pestaña Añadir

Origination soporta todos los tipos de entrada disponibles en formularios. Puedes ver el listado completo de tipos en la documentación de formularios (opens new window)

Editar campos

Al seleccionar un campo, puedes modificar sus propiedades al dirigirte a la pestaña Editar Allí encontrarás diferentes propiedades según las características del campo seleccionado. Las principales propiedades son:

• Título del campo:Es el nombre del campo que se mostrará en la interfaz del usuario. Este debe ser claro y descriptivo para facilitar la interacción.
• Requerido: Determina si el campo es obligatorio o no. Si está activado, el usuario deberá completarlo antes de continuar con el flujo.
• Instrucciones del campo: proporciona orientación adicional para que el usuario comprenda cómo completar el campo. Estas instrucciones se muestran directamente en la interfaz, debajo del campo.
• Agregar campo Pop-up de instruciones: Agrega un ícono de ayuda junto al campo. Al hacer clic en este ícono, se despliega un mensaje con información adicional o consejos útiles relacionados con el campo.
• Opciones: Propiedades adicionales de acuerdo al tipo de campo seleccionado.

Validación

La tarea de validación requiere una revisión manual del agente asignado. Este debe validar los datos entregados por el usuario para desbloquear la siguiente tarea del flujo. Se hace un refresco de la tarea cada 5 segundos para que el usuario final sepa si la tarea fue validada.

Al configurar la tarea, puedes definir un Asignado: un administrador o un grupo de administradores responsable de las validaciones. Al seleccionar un grupo, puedes asignar a todo el grupo o a un usuario específico dentro de él. Si no defines un asignado, las validaciones se asignan de forma predeterminada al asignado de la respuesta.

Los administradores asignados reciben un correo cuando una validación queda pendiente y también pueden revisarla desde la vista Mis tareas del menú principal, filtrando por el tipo de tarea Revisión de validación. El usuario recibe una notificación interna cuando su tarea es aprobada o rechazada.

En una respuesta específica, puedes reasignar la validación desde la pestaña Validaciones, una vez que el usuario haya completado las tareas a validar.

Firma

La tarea de firma permite una firma simple con un checkbox o una avanzada cuando hay algun proveedor de firma digital instalado en las integraciones del reino.

Revisión pendiente

La tarea de revisión pendiente pausa el proceso de originación. Se usa para gatillar procesos asíncronos, generalmente en sistemas externos. Se hace un refresco de la tarea cada 5 segundos para que el usuario final sepa si la tarea fue revisada.

Al igual que en las tareas de validación, puedes definir un Asignado para la tarea: un administrador o un grupo de administradores. Si no defines uno, la revisión se asigna de forma predeterminada al asignado de la respuesta.

Verificación de Identidad

La tarea de Verificación de Identidad solicita al usuario verificar su identidad mediante la captura de una selfie, su documento de identidad y detección de vida (liveness), a través de un proveedor de verificación.

Para usar esta tarea, primero debes habilitar una integración de la categoría Verificación de Identidad en las integraciones del reino, como Amazon Rekognition.

Al configurar la tarea defines:

• Proveedor: La integración de verificación de identidad que procesará la verificación.
• Características: Las verificaciones que incluye la tarea: Selfie (siempre requerida), Documento (captura del frente y reverso del documento de identidad con extracción de sus datos) y Liveness (detección de vida).
• Ajustes de Liveness: Si activaste Liveness, puedes definir el Umbral de confianza (de Flexible a Estricto) y Habilitar desafío de color, que muestra luces de colores durante la verificación e incluye una advertencia de fotosensibilidad para el usuario.

Durante el flujo, el usuario captura su selfie y su documento guiado por la interfaz; la plataforma valida la calidad de las imágenes, extrae los datos del documento y compara el rostro del documento con la selfie.

En los detalles de una respuesta, la pestaña Verificación de Identidad muestra el estado de la verificación, los puntajes de coincidencia facial (Face Match Score) y de detección de vida (Liveness Score), los datos extraídos del documento y las imágenes capturadas.

Snippet de código

Los snippets de código o code snippets, permiten agregar bloques personalizados de código en los flujos de originación. Estos bloques soportan HTML, JavaScript y CSS, lo que facilita la creación de componentes interactivos o la personalización del flujo según las necesidades del usuario.

Los code snippets pueden:

• Ajustarse a cualquier escenario dentro del flujo de originación.
• Desplegar datos en tiempo real desde la aplicación.
• Almacenar y consumir información relevante para el proceso.

Insertar un Code Snippet

Para agregar un code snippet en una tarea de originación, sigue estos pasos:

1. Crea una nueva Tarea dentro de un paso del flujo.
2. Selecciona el tipo de tarea Snippet de código.
3. Configura las propiedades de la tarea.

Propiedades del Snippet de código

• Task ID: Identificador único de la tarea. Se genera automáticamente al guardar la tarea y permite acceder a los datos desde la API.
• Nombre: Nombre de la tarea, visible para el usuario.
• Identificador: Valor único que se incluye en la URL de originación.
• Descripción: Breve texto explicativo que describe la tarea.
• Completar la tarea mediante la API: Si se marca, la acción de continuar se desactivará por defecto para esta tarea y requerirá que el desarrollador notifique el estado de finalización mediante la API de JavaScript.

API de JavaScript para Code Snippets

Modyo proporciona una API en JavaScript para interactuar con los code snippets en tiempo de ejecución.

Métodos disponibles

• getUrl(): Retorna la URL del flujo de originación actual.
• enableButton(): Habilita el botón de acción de la tarea y permite al usuario continuar con el flujo.

API JSON para Code Snippets

Los Code Snippets pueden comunicarse con la API de originación utilizando datos en formato JSON.

Para obtener datos almacenados en la respuesta actual, usa el método getUrl() para construir la solicitud. Para guardar información, se debe realizar una petición POST a la misma URL.

Ejemplo de estructura JSON

Cuando consumes datos de la API JSON obtendrás un objeto con todas los datos almacenados en la respuesta actual.

{
  "submission": {
    "sequence_id": "12345",
    "fields": [
      {
        "answers": [
          {
            "question": {
              "label": "What's your name?"
            },
            "text_field": "Jorge Regula"
          }
        ]
      }
    ]
  },
  "task": {
    "task_id": "67890",
    "step": {
      "uid": "abcd1234"
    }
  },
  "page": {
    "name": "Origin Page"
  }
}

Atención

Para almacenar información, los datos deben utilizar formato JSON válido, los errores de formato no serán procesados.

Uso de Liquid en code snippets

Los code snippets pueden utilizar objetos de liquid para acceder a datos internos de la respuesta y personalizar la experiencia del usuario.

En un flujo de originación, cada respuesta representa el proceso en curso de un usuario específico.

Puedes aprender más sobre Objetos Liquid en nuestra documentación.

Ejemplo de Code Snippets

En este ejemplo puede encontrar en uso el acceso a datos por Objetos de Liquid e interacción con la APIs de JavaScript y JSON. Recuerda reemplazar el valor QUESTION_ID por el correspondiente en tu respuesta.

<div class="form-group">
    <div class="form-group">
        <label for="productDropdown" class="form-label">Select a car <span class="req">*</span></label>
        <select class="form-select" id="productDropdown" disabled>
            <option value="" selected>Loading...</option>
        </select>
    </div>
    <div class="form-group">
        <label for="colorDropdown" class="form-label">Select your favorite color <span class="req">*</span></label>
        <select class="form-select" id="colorDropdown" disabled>
            <option value="" selected>Loading...</option>
        </select>
    </div>
	  <div class="form-group">
        <label for="yearInput" class="form-label">Year <span class="req">*</span></label>
        <input type="number" class="form-control" id="yearInput" placeholder="e.g., 2023">
    </div>
	  <div class="form-group">
        <label for="dateInput" class="form-label">Driver license expiration<span class="req">*</span></label>
        <input type="date" class="form-control" id="dateInput">
    </div>
	 <div class="form-group">
     <label for="extrasSelect" class="form-label">Select extras (multi-select)</label>
       <select class="form-select" id="extrasSelect" multiple>
         <option value="ac">Air Conditioning</option>
         <option value="gps">GPS</option>
         <option value="sunroof">Sunroof</option>
         <option value="leather_seats">Leather Seats</option>
       </select>
   </div>
</div>
<script>
    const staticProducts = [
        { id: 'ferrari', title: 'Ferrari' },
        { id: 'lamborghini', title: 'Lamborghini' },
        { id: 'maserati', title: 'Maserati' },
        { id: 'alfa_romeo', title: 'Alfa Romeo' },
        { id: 'fiat', title: 'Fiat' },
        { id: 'lancia', title: 'Lancia' },
        { id: 'pagani', title: 'Pagani' }
    ];

    const staticColors = [
	 { id: 'white', name: 'White' },  
	{ id: 'red', name: 'Red' },
        { id: 'blue', name: 'Blue' },
        { id: 'black', name: 'Black' },    
        { id: 'silver', name: 'Silver' },
        { id: 'green', name: 'Green' },
        { id: 'yellow', name: 'Yellow' }
    ];

    const productDropdown = document.getElementById('productDropdown');
    const colorDropdown = document.getElementById('colorDropdown');
	  const yearInput = document.getElementById('yearInput');
	  const dateInput = document.getElementById('dateInput');
	  const extrasSelect = document.getElementById('extrasSelect'); 

    async function initializeDropdowns() {
        const savedData = await getRequestJson();
        let selectedProductValue = null;
        let selectedColorValue = null;

        if (savedData?.application?.fields?.[0]?.answers) {
            const productAnswer = savedData.application.fields[0].answers.find(answer => answer.question.label === 'PRODUCT');
            selectedProductValue = productAnswer?.text_field;

            const colorAnswer = savedData.application.fields[0].answers.find(answer => answer.question.label === 'COLOR');
            selectedColorValue = colorAnswer?.text_field;
        }

        let productOptionsHtml = '<option value="">Seleccionar ...</option>';
        staticProducts.forEach(product => {
            productOptionsHtml += `<option value="${product.id}" ${selectedProductValue && product.id === selectedProductValue ? 'selected' : ''}>${product.title}</option>`;
        });
        productDropdown.innerHTML = productOptionsHtml;
        productDropdown.disabled = false;
        if (productDropdown.value) enableButton();

        let colorOptionsHtml = '<option value="">Seleccionar ...</option>';
        staticColors.forEach(color => {
            colorOptionsHtml += `<option value="${color.id}" ${selectedColorValue && color.id === selectedColorValue ? 'selected' : ''}>${color.name}</option>`;
        });
        colorDropdown.innerHTML = colorOptionsHtml;
        colorDropdown.disabled = false;
        if (colorDropdown.value && productDropdown.value) enableButton();
    }

    productDropdown.addEventListener('change', () => {
        if (productDropdown.value && colorDropdown.value) enableButton();
    });

    colorDropdown.addEventListener('change', () => {
        if (productDropdown.value && colorDropdown.value) enableButton();
    });

    async function getRequestJson() {
        try {
            const url = getUrl();
            const response = await fetch(url);
            if (!response.ok) throw new Error(`HTTP error: ${response.status}`);
            return await response.json();
        } catch (error) {
            console.error("Error in getRequestJson:", error);
            return null;
        }
    }

    async function sendData() {
			  const selectedExtras = Array.from(extrasSelect.selectedOptions).map(option => option.value);
			
        const jsonData = {
            "submission": {
                "fields": {
                    "car": productDropdown.value,
                    "color": colorDropdown.value,
		   "year": yearInput.value ? parseInt(yearInput.value, 10) : null,
		   "expiration": dateInput.value,
		   "extras": selectedExtras
                }
            }
        };
        return await postRequestJson(jsonData);
    }
    
    async function postRequestJson(content) {
        try {
            const response = await fetch(getUrl().concat(`?content=${encodeURIComponent(JSON.stringify(content))}`), {
                method: 'POST',
                headers: { 'Content-Type': 'application/json', 'Accept': 'application/json', 'X-CSRF-Token': document.querySelector('meta[name=csrf-token]').content }
            });
            if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
            await response.json();
        } catch (error) {
                console.error('Error:', error);
        }
    }

    async function postRequestJson2(content) {
        try {
            const response = await fetch(getUrl(), {
                method: "POST",
                headers: {
                    'X-CSRF-TOKEN': document.querySelector('meta[name=csrf-token]').content,
                    'Accept': 'application/json',
            'Content-Type': 'application/json'
                },
                body: JSON.stringify({content: content}),
            });
            if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
            await response.json();
        } catch (error) {
            console.error('Error:', error);
        }
    }

    document.addEventListener('DOMContentLoaded', async function() {
        await initializeDropdowns();
	   const mainForm = document.querySelector('form');
	    mainForm.addEventListener("submit", async function(event) {
            event.preventDefault();
            const submitHandler = async (e) => {
                e.preventDefault(); 
                try {
                    const responseData = await sendData(); 
                    mainForm.removeEventListener("submit", submitHandler);
                    mainForm.submit(); 
                } catch (error) {
                    console.error("Error durante el envío de datos:", error);
                }
            };
	   submitHandler(event);
        });
    });
</script>

JSON válido

El parámetro content que se envía tiene que ser un json válido. En caso de que tenga que ser vacío se tiene que enviar {}.

Proceso de originación

La tarea de tipo proceso de originación permite insertar otra originación en el flujo. Esto porque muchas veces en diferentes flujos se comparten unos pasos o datos que se requieren del usuario. Al usar un una tarea de proceso de originación, si el usuario ya tiene respuestas anteriores podría usarlas en lugar de volver a entregar los mismos datos una y otra vez. Permitir o no el uso de datos anteriores se define al agregar la tarea de proceso de originación.

Invitación

La tarea de Invitación permite crear flujos de originación multiusuario: el usuario principal de la respuesta invita a otras personas para que completen tareas específicas del flujo.

Para poder crear una tarea de invitación, primero debes crear al menos un rol en la edición de la originación. Cada rol puede usarse en una sola tarea de invitación de la originación.

Al configurar la tarea defines:

• Rol: El rol que asumirán los usuarios invitados.
• Plantilla de correo: El código HTML/Liquid del correo de invitación. Tienes disponibles variables de Liquid como invitation.first_name, invitation.last_name, invitation.email, invitation_url, submission, task, origination y site.
• Tareas objetivo: Las tareas que los usuarios invitados podrán completar. Solo puedes seleccionar tareas anteriores a la tarea de invitación; otras tareas de invitación y las tareas de proceso de originación no son seleccionables.

Además, en las propiedades de cada tarea incluida en una tarea de invitación encontrarás la opción Mostrar esta tarea al usuario principal, que controla si el usuario principal también ve esa tarea en su flujo.

En la página de originación, el usuario principal puede invitar a personas nuevas (nombre, apellido y correo electrónico) o a usuarios ya invitados en otras tareas, y puede reenviar o cancelar las invitaciones pendientes. Cada invitado recibe un correo con un enlace de acceso y, al ingresar, solo ve las tareas que le fueron asignadas; si tiene más de un rol, ve la unión de las tareas de todos sus roles. El usuario invitado no puede cancelar la respuesta.

La tarea de invitación se completa cuando todos los invitados terminan sus tareas. Si el rol no requiere invitaciones y el usuario principal no invita a nadie, la tarea se completa automáticamente al continuar. La cantidad de invitaciones activas está limitada por el Número máximo de usuarios del rol.

Plantilla para usuarios invitados

La página de la originación incluye la plantilla Reanudar (Invitado), que es la vista que ven los usuarios invitados al volver a ingresar a la respuesta. Puedes personalizarla como el resto de las plantillas de la página.

Confirmación

La tarea de Confirmación muestra al usuario un resumen de las respuestas que entregó en tareas Input anteriores, para que las revise y confirme antes de continuar con el flujo.

Al configurar la tarea, en Seleccionar ítems a confirmar eliges las tareas cuyas respuestas se incluirán en el resumen, agrupadas por paso. Solo puedes seleccionar tareas de tipo Input anteriores a la tarea de confirmación.

El usuario ve cada tarea seleccionada con sus respuestas y un enlace Editar que lo lleva directamente a esa tarea para corregirla. Al presionar Confirmar, la tarea se completa y el flujo continúa. Para completar la tarea, todos los ítems configurados deben estar confirmados.

En los detalles de una respuesta, las tareas de confirmación completadas muestran el listado de Tareas confirmadas.

Lógica Condicional

La lógica condicional te permite crear flujos de trabajo más dinámicos e inteligentes. Con esta funcionalidad, puedes definir reglas para mostrar u ocultar Pasos, Tareas y campos de tareas Input basándote en las respuestas proporcionadas por los usuarios o en datos existentes dentro de la respuesta. Esto te permite personalizar la experiencia del usuario, presentando solo la información relevante en cada etapa del proceso y simplificando o bifurcando la interacción. La lógica condicional te ofrece la flexibilidad de:

• Ocultar o mostrar pasos completos: Dirige a los usuarios a través de diferentes caminos dentro del flujo de originación según sus respuestas previas.
• Ocultar o mostrar tareas individuales: Dentro de un paso, puedes mostrar u ocultar tareas específicas. Esto es útil para solicitar información adicional solo cuando es necesaria.
• Ocultar o mostrar campos de tareas Input: Dentro de una tarea de tipo Input, puedes mostrar u ocultar campos específicos. Esto te permite omitir o solicitar datos de acuerdo a las respuestas que proporciona el usuario.

Configurar Lógica Condicional

Para configurar la lógica condicional, sigue estos pasos:

1. Entra en el editor: En la vista Build de una originación, presiona el botón de Lógica condicional.
2. Edita la visibilidad de los elementos: Por defecto, todos los pasos, tareas y campos estarán visibles. En la sección Estructura, puedes marcar como no visibles los elementos que quieras presionando el ícono del ojo.
3. Define reglas: En la sección Reglas, puedes definir las condiciones que determinarán si un elemento se muestra u oculta. Las reglas se componen de: (1) una o más condiciones evaluadas mediante operadores AND y OR y (2) una acción a ejecutar cuando las condiciones se cumplan.
   1. Agrega una regla: Presiona el botón Añadir.
   2. Define las condiciones: Las condiciones pueden estar basadas en:
      • Respuestas a campos Input: Compara la respuesta proporcionada por el usuario en un campo específico con un valor determinado. Puedes utilizar operadores como "es igual a", "no es igual a", "contiene", "es mayor que", "es menor que", etc.
      • Completitud de un Paso o Tarea: Evalúa si un paso o tarea fue completada.
   3. Define la acción: Selecciona la acción y el elemento sobre el cual se ejecutará cuando la regla se cumpla. Las acciones disponibles son Mostrar y Ocultar.
4. Guarda los cambios: Una vez que hayas definido tus reglas, guarda los cambios.

Experiencia de usuario

Considera cómo la lógica condicional puede afectar la experiencia del usuario y asegúrate de que el flujo pueda ser completado con facilidad.

Editar configuración de la originación

Al seleccionar la opción Editar en el menú contextual de tu originación puedes editar sus propiedades.

• Nombre: Define el nombre de la originación, visible para los usuarios en la interfaz.
• Descripción: Incluye un breve texto explicativo sobre el propósito de la originación.
• Mensaje de completado: Es el mensaje que aparecerá al usuario al finalizar el proceso de originación.
• Asignado por defecto de la respuesta: Especifica el administrador o grupo de administradores que será asignado automáticamente a cada nueva respuesta. Al seleccionar un grupo, puedes usar la opción Asignar a todo el grupo o elegir un usuario específico dentro de él.
• Vence en: Establece un plazo máximo para completar la originación.
• Cancelar automáticamente las respuestas que excedan la fecha de vencimiento: Disponible solo si configuraste un vencimiento. Al activar esta opción, las respuestas en estado Pendiente que superen su fecha de vencimiento se cancelan automáticamente.
• Reglas de completado: Define el comportamiento de completado para cada respuesta.
• Reglas de cancelación: Define quién puede cancelar una respuesta desde la página de originación:
  • Cualquiera puede cancelar la respuesta: Opción por defecto.
  • Solo los administradores pueden cancelar la respuesta: El botón Cancelar deja de mostrarse al usuario en la página de originación y la cancelación queda disponible solo para los administradores.
• Privacidad: Permite restringir el acceso al flujo de originación a ciertos segmentos de usuarios predefinidos.

Cancelación automática por vencimiento

La cancelación automática se ejecuta en un proceso en segundo plano una vez al día, por lo que puede no ser inmediata al momento del vencimiento. Solo cancela respuestas en estado Pendiente y registra Auto-cancelada por vencimiento como razón de cancelación, visible en los detalles de la respuesta.

Roles

En la edición de la originación encontrarás la sección Roles, donde defines los roles que usarán las tareas de invitación de los flujos multiusuario. Para crear un rol, presiona el botón Agregar Rol y completa:

• Nombre: El nombre del rol, único dentro de la originación.
• Requiere invitaciones: Si está activo, el usuario principal debe invitar al menos a una persona para completar la tarea de invitación que use este rol.
• Número máximo de usuarios: La cantidad máxima de usuarios que pueden tener este rol en una misma respuesta.

Eliminar originación

Si necesitas eliminar una originación de forma permanente:

1. Selecciona la opción Eliminar originación.
2. Confirma que no necesitas los datos de la originación antes de proceder.

Peligro

Este proceso es irreversible.

Ver detalles de una originación

Al acceder a una originación específica, puedes visualizar métricas y datos relevantes en función de la vista que selecciones. Estas vistas te permiten analizar y gestionar de manera eficiente la información asociada con la originación.

• Resumen: Presenta un panorama general de las métricas principales asociadas a la originación, proporcionando una visión rápida del rendimiento y progreso.
• Respuestas: Muestra un listado detallado de todas las respuestas realizadas dentro de esta originación. Es ideal para revisar el historial y el estado de cada solicitud.
• Asignados: Proporciona un listado de las personas asignadas a esta originación, junto con sus métricas de gestión, lo que facilita el seguimiento del desempeño y la carga de trabajo.

Resumen de Originación

La vista resumen de una originación te ofrece un resumen de las métricas clave relacionadas con el rendimiento y estado de las solicitudes en el flujo. Esta información es útil para comprender el progreso general y realizar un seguimiento efectivo.

• Pendientes: Muestra el número total de solicitudes enviadas que aún no han sido completadas.
• Completadas: Indica la cantidad de solicitudes que han finalizado exitosamente el flujo de originación.
• Canceladas: Refleja las solicitudes que han sido canceladas por el usuario o el administrador.
• Total: Representa el número total de solicitudes, incluyendo las pendientes, completadas y canceladas.

Gestión de Respuestas

La vista de respuestas te permite revisar y administrar individualmente el estado e información de cada respuesta a esta originación. Puedes seleccionar una respuesta específica para acceder a sus detalles y gestionar sus elementos clave.

En la vista de detalles, encontrarás las siguientes secciones principales:

• Detalles: Información general de la respuesta, como el nombre, descripción y estado actual.
• Tareas: Listado de tareas asociadas al flujo de originación, junto con su estado de avance.
• Campos: Campos configurados en el flujo para recopilar información del usuario.
• Documentos: Archivos subidos por los usuarios o necesarios para el proceso de originación.
• Firmas: Seguimiento de las firmas digitales recolectadas durante el flujo.
• Validaciones: Validaciones realizadas por los administradores para autorizar el progreso.
• Actividad: Registro de actividades y cambios realizados en la respuesta, útil para seguimiento y auditoría.

Esta estructura te brinda una visión integral y detallada de cada respuesta, permitiéndote gestionar de manera efectiva todos los aspectos relacionados con las respuestas.

En las respuestas multiusuario, las pestañas Tareas, Revisiones y Validaciones incluyen el selector Viendo tareas de, que te permite alternar entre el Usuario Principal y cada usuario invitado para revisar el avance individual de sus tareas.

Tip

Desde la vista de una respuesta en el menú de acciones (identificado con …) se puede impersonar al usuario para ayudarlo a contestar la originación. Esto depende de los roles del usuario

Alcance por segmentos

Si tu acceso al reino está restringido por segmentos, solo verás las respuestas de los usuarios de tu alcance. Las respuestas que tengas asignadas siguen visibles y operables aunque el usuario pertenezca a segmentos fuera de tu alcance.

Buscar respuestas

El listado de respuestas incluye una caja de búsqueda que te permite encontrar respuestas por los datos del usuario, los valores de sus campos personalizados, las respuestas ingresadas en los campos del flujo y el contenido de las tareas.

La búsqueda requiere un mínimo de 3 caracteres, no distingue mayúsculas ni acentos y encuentra coincidencias parciales. Por ejemplo, lau encuentra a "Claudio" y perez encuentra a "Pérez".

Puedes buscar de dos formas, que además puedes combinar en una misma consulta:

• Texto libre: Escribe uno o más términos y la búsqueda los encontrará en los datos del usuario, los valores de sus campos personalizados y el contenido de las respuestas.
• Pares clave=valor: Escribe la clave de un campo seguida de = y el valor a buscar para acotar la búsqueda a ese campo específico.

Las claves disponibles para los pares clave=valor son:

• Campos del usuario: first_name, last_name, second_last_name, email, username, uuid e id.
• Campos personalizados del usuario: La clave del campo personalizado, con o sin el prefijo _ucf_. Por ejemplo, pais=Chile y _ucf_pais=Chile son equivalentes.
• Preguntas del flujo: El identificador de la pregunta definido en el flujo de originación. Por ejemplo, rut=18301757.

Al usar pares clave=valor ten en cuenta lo siguiente:

• La clave debe escribirse completa, mientras que el valor sí admite coincidencias parciales.
• Para buscar valores o frases con espacios usa comillas dobles. Por ejemplo, first_name="Jean Pierre" o "crédito hipotecario".
• Todas las condiciones se combinan entre sí, por lo que una respuesta debe cumplir todos los términos y pares de la consulta para aparecer en los resultados.
• Si la clave no existe o el valor está vacío, el término se busca como texto libre sin generar errores.

Algunos ejemplos de búsquedas:

Búsqueda	Resultado
Claudio	Respuestas cuyo usuario o contenido incluye "Claudio".
first_name=Claudio	Respuestas cuyo usuario contiene "Claudio" en su nombre.
pais=Chile	Respuestas cuyo usuario tiene "Chile" en el campo personalizado pais.
rut=18301757	Respuestas donde la pregunta con identificador rut contiene "18301757".
first_name="Jean Pierre"	Respuestas cuyo usuario contiene "Jean Pierre" en su nombre.
pais=Chile rut=18301757 hipotecario	Respuestas que cumplen las tres condiciones a la vez.

Actualización de los resultados

Los cambios recientes en una respuesta pueden tardar unos segundos en reflejarse en los resultados de la búsqueda. Los cambios en los datos del usuario, en los valores de sus campos personalizados y en los segmentos se reflejan de forma diferida.

Filtrar respuestas

Además de la búsqueda, puedes acotar el listado de respuestas con los siguientes filtros, combinables entre sí y con la búsqueda:

• Rango de fechas: Filtra por la fecha de creación de la respuesta.
• Estado: Filtra por el estado actual de la respuesta: No Iniciada, Pendiente, Completada o Cancelada.
• Asignado: Muestra las respuestas asignadas al administrador seleccionado.
• Segmento: Muestra las respuestas de los usuarios que pertenecen al segmento seleccionado.

Asignar respuesta

En el listado de respuestas, selecciona el menú de acciones y presiona la opción Asignar. En el modal puedes asignar la respuesta a un administrador, a un grupo completo de administradores o a un usuario específico dentro de un grupo. También puedes usar la opción Asígname para asignarte la respuesta directamente.

Al asignar a todo un grupo, todos sus miembros pueden ver y gestionar la respuesta. La columna Asignado del listado muestra el grupo o el administrador asignado; si el administrador fue elegido desde un grupo, se muestra también el nombre del grupo.

Cancelar respuesta

Para cancelar una respuesta, ábrela y presiona el botón Cancelar en la vista de la respuesta. En el modal puedes ingresar de manera opcional una Razón de cancelación y luego confirmar la acción. La cancelación modifica permanentemente el estado de la respuesta a Cancelada.

Puedes cancelar respuestas en estado No Iniciada, Pendiente o Completada.

En los detalles de una respuesta cancelada se muestra la fecha de cancelación en el campo Cancelada el y la Razón de cancelación ingresada. Si no se ingresó una razón, el campo muestra --.

Eliminar respuesta

Para eliminar una respuesta individual, selecciona el menú en la columna actions y presiona la opción delete. Esto eliminará la respuesta.

Para eliminar varias respuestas al mismo tiempo, selecciona cada entrada marcando la casilla correspondiente y presiona el botón eliminar.

Reabrir tareas de una respuesta

A través de la API de administración puedes gestionar individualmente las respuestas a tareas de una respuesta: consultarlas, cambiarlas de estado (iniciar, completar o reabrir una tarea ya completada para que el usuario vuelva a responderla) y eliminarlas de forma individual o masiva.

Considera lo siguiente:

• Cambiar el estado de una respuesta a tarea requiere el permiso Cambiar estado de la Respuesta de una Tarea; eliminar respuestas a tareas requiere el permiso Eliminar Respuestas.
• Estas operaciones solo están disponibles mientras la respuesta está en estado No Iniciada o Pendiente.
• Todas las operaciones quedan registradas en la actividad de la plataforma.

Invitar usuarios

Puedes invitar a usuarios para que ingresen información en una originación. Al invitar a un usuario, deberás ingresar su información básica

• Nombre: El primer nombre del usuario que utilizará la originación.
• Apellido: El apellido del usuario.
• Email: La dirección de correo electrónico del usuario, donde recibirá la invitación para acceder a la originación.
• Asignar la respuesta: En la lista desplegable, selecciona un administrador que gestionará esta originación en particular. Si no se selecciona un administrador, la respuesta quedará sin asignar.

Gestión de Asignados

En la vista de asignados, puedes monitorear y administrar a los administradores responsables de las respuestas dentro de un reino. Esta vista facilita el seguimiento del desempeño y la carga de trabajo de los administradores. Puedes filtrar las respuestas asignadas por rangos de fecha

Al seleccionar un administrador, podrás ver todas las respuestas que tiene asignadas y su correspondiente status

Crear una Página de Originación

Para desplegar una página de originación a los usuarios, sigue los pasos a continuación. Esto te permitirá habilitar un acceso directo y funcional a tus flujos.

• Verifica Conexión con el Realm: Accede al módulo de Channels, selecciona el sitio deseado y confirma que está conectado al Realm donde se encuentra configurada la originación.
• Crear una página de originación: Desde el sitio seleccionado, crea una nueva página y define su tipo como originación.
• Seleccionar la originación: Asocia la página con la originación que deseas desplegar.
• Configurar Nombre y Ruta: Define un nombre claro y una ruta específica para la página, y presiona Create para finalizar.

Los usuarios podrán acceder a la página de originación para realizar el flujo configurado. Es fundamental asegurarte de que todas las configuraciones estén correctamente definidas para garantizar el acceso a los usuarios finales.

El acceso a esta página estará restringido según las configuraciones de privacidad y segmentación establecidas en la originación. Esto asegura que solo los segmentos autorizados puedan interactuar con el flujo, manteniendo el control y la seguridad de la información.

Es importante tener en cuenta que cada originación puede estar vinculada únicamente a una página. Si necesitas crear una nueva página de originación, primero será necesario desvincular o eliminar la página existente para evitar conflictos y asegurar una configuración adecuada.