> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/productos/facephi-intelligence-platform/modulos/configurator.md). # Configurator Configurator permite crear, configurar y gestionar los procesos que se ejecutan mediante las soluciones de FIP.
Desde este módulo puedes: * Consultar los procesos disponibles. * Crear procesos de onboarding y autenticación. * Configurar sus componentes y parámetros. * Añadir y configurar challenges. * Guardar procesos en borrador. * Publicar y despublicar procesos. * Clonar procesos existentes. * Archivar y eliminar procesos, según tus permisos. * Consultar la información necesaria para integrar un proceso. * Probar un proceso publicado mediante el modo demo. * Gestionar otras configuraciones disponibles para tu tenant y tu rol. {% hint style="info" %} Los cambios realizados en Configurator no afectan a las nuevas ejecuciones hasta que la configuración correspondiente se publica. {% endhint %} *** ## Cómo se organiza La sección principal de Configurator es **Processes**. Desde ella puedes acceder al listado de procesos y abrir cada uno para consultar o modificar su configuración. Cada proceso está definido, entre otros elementos, por: * Su tipo. * El entorno en el que se ejecuta. * La plantilla utilizada. * Sus componentes. * Los parámetros de esos componentes. * Los challenges configurados. * Su estado. Algunas configuraciones adicionales pueden estar disponibles según las funcionalidades contratadas y los permisos de tu perfil. *** ## Acceso y permisos Las acciones disponibles dependen de tu rol y de los permisos asociados a tu perfil. Según tus permisos, puedes: * Consultar procesos. * Crear procesos. * Editarlos. * Clonarlos. * Publicarlos o despublicarlos. * Archivarlos. * Eliminarlos. * Ejecutarlos en modo demo. * Acceder a configuraciones adicionales. Cuando una acción no está disponible para tu usuario, puede permanecer oculta o deshabilitada. {% hint style="info" %} Los procesos publicados no pueden modificarse directamente. Si necesitas cambiar su configuración, primero debes retirarlos de publicación cuando tengas permisos para hacerlo. {% endhint %} *** ## Consultar procesos **Processes** muestra los procesos disponibles en el entorno seleccionado.
Cada elemento del listado permite identificar el proceso, conocer su estado y acceder a las acciones disponibles. ### Buscar y filtrar procesos Utiliza la búsqueda para localizar un proceso por su nombre. Cuando estén disponibles, utiliza los filtros para limitar los resultados según criterios como: * Estado. * Tipo de proceso. * Entorno. * Plantilla. Los filtros aplicados se muestran sobre el listado y pueden retirarse individualmente. Selecciona **Clear all** para eliminarlos todos. ### Resultados Cada proceso puede mostrar información como: * Nombre. * Descripción. * Process ID. * Tipo de proceso. * Entorno. * Plantilla. * Estado. * Versión. * Fecha de creación o modificación. Según la vista, también pueden aparecer indicadores relacionados con su uso. ### Abrir un proceso Selecciona el proceso o la acción de visualización disponible. Se abrirá su detalle con la configuración correspondiente. Las acciones que puedes realizar desde el detalle dependen de su estado y de tus permisos. ### Sin procesos Cuando todavía no existen procesos, el listado muestra un estado vacío. Selecciona **Create process** para configurar el primero. Los nuevos procesos aparecerán en este listado una vez creados. *** ## Estados de un proceso El estado indica en qué punto de su ciclo de vida se encuentra un proceso. ### Draft El proceso está en configuración y todavía no está disponible para nuevas ejecuciones. Puedes modificarlo y guardar los cambios hasta que esté preparado para publicarse. ### Published El proceso está publicado y puede utilizarse para iniciar nuevas ejecuciones. La versión publicada es inmutable. Para realizar cambios, primero debes retirarla de publicación cuando tengas permisos para hacerlo. ### Archived El proceso se ha retirado del trabajo habitual, pero se conserva en el sistema. Según tus permisos, puedes recuperarlo o eliminarlo. *** ## Crear un proceso Selecciona **Create process** desde el listado. La creación comienza definiendo las características principales del proceso.
### Seleccionar el tipo de proceso Selecciona el tipo de flujo que quieres configurar. Puede ser: * **Onboarding** * **Authentication** El tipo seleccionado determina las plantillas y componentes que estarán disponibles. ### Seleccionar el entorno Selecciona dónde se ejecutará el proceso. Las opciones disponibles pueden incluir: * Web. * iOS. * Android. El entorno condiciona los componentes y configuraciones compatibles. ### Seleccionar una plantilla Selecciona la plantilla que servirá como configuración inicial. La plantilla define una combinación base de: * Componentes. * Validaciones. * Parámetros. * Dependencias. * Challenges, cuando corresponda. Después podrás modificar los elementos que sean configurables. {% hint style="info" %} Algunos valores quedan definidos por el tipo de proceso, el entorno o la plantilla y no pueden modificarse posteriormente. {% endhint %} *** ## Configurar un proceso La configuración se organiza en diferentes secciones según el tipo de proceso y la plantilla seleccionada.
Puede incluir: * Información general. * Terms & Conditions. * Componentes. * Parámetros. * Challenges. * Configuración técnica adicional. ### Campos editables Los campos editables permiten modificar el valor configurado. Cada campo puede tener: * Un valor inicial. * Un formato determinado. * Un rango de valores permitido. * Una longitud mínima o máxima. El sistema valida la información antes de guardar o publicar. ### Campos de solo lectura Algunos valores se muestran pero no pueden modificarse. Estos campos representan configuraciones determinadas por: * El tipo de componente. * La plantilla. * El entorno. * El propio sistema. {% hint style="info" %} Que un campo no pueda editarse no significa que esté incompleto. Algunos valores forman parte de la configuración interna del componente y se muestran únicamente como referencia. {% endhint %} ### Valores gestionados por el sistema Algunos parámetros necesarios para ejecutar el proceso pueden no aparecer en el formulario porque el sistema los gestiona automáticamente. No necesitas configurarlos manualmente. ### Validación de los valores Los campos aceptan únicamente valores compatibles con su configuración. Si introduces un valor fuera del rango permitido o con un formato incorrecto, corrígelo antes de guardar o publicar. *** ## Terms & Conditions Terms & Conditions permite configurar la información que el usuario debe aceptar durante el proceso. La configuración puede incluir: * Título. * Descripción. * Tiempo disponible para completar el paso. Solo puede existir **un componente de Terms & Conditions dentro del mismo proceso**. Si ya existe, no podrás añadir un segundo componente equivalente. *** ## Configurar componentes Los componentes determinan las capturas, verificaciones e interacciones que forman parte del proceso. La plantilla incorpora una configuración inicial que puedes adaptar dentro de los límites permitidos. ### Consultar un componente
Cada componente muestra su nombre, estado y las acciones disponibles. Según el componente, puedes encontrar: * **Edit** * **Disable** * **Restore** Las acciones disponibles dependen de su configuración y de las relaciones con otros componentes. ### Editar un componente Selecciona **Edit** para abrir su configuración. Modifica los parámetros disponibles y guarda los cambios. Selecciona **Cancel** para cerrar la edición sin aplicarlos. Algunos parámetros pueden mostrarse como read-only porque su valor viene determinado por el sistema. ### Desactivar un componente Selecciona **Disable** cuando quieras mantener el componente dentro de la configuración pero evitar que participe en la ejecución. Antes de desactivarlo, el sistema comprueba si existen otros componentes que dependan de él. Si puede desactivarse, confirma la acción. El componente permanece visible en la configuración como deshabilitado. ### Dependencias entre componentes Algunos componentes necesitan que otros estén activos para funcionar correctamente. Por ejemplo, una validación puede necesitar una captura previa para disponer de la información que debe analizar. Cuando intentas desactivar un componente con dependencias, el sistema te informa de los elementos afectados.
Dependiendo de la relación entre ellos: * La acción puede quedar bloqueada. * Puede ser necesario desactivar también otros componentes. * El sistema puede solicitar una confirmación adicional. {% hint style="warning" %} Revisa siempre los componentes afectados antes de confirmar una desactivación. El cambio puede modificar el flujo que experimentará el usuario. {% endhint %} ### Restaurar un componente Selecciona **Restore** para volver a activar un componente deshabilitado. El sistema comprueba sus dependencias antes de restaurarlo. Cuando otros componentes relacionados también están deshabilitados, puede ser necesario restaurarlos para recuperar correctamente la configuración. Según el caso, la interfaz puede permitir: * Restaurar únicamente el componente seleccionado. * Restaurar también los componentes necesarios para completar sus dependencias. Revisa la información mostrada antes de confirmar. Después de restaurarlo, el componente vuelve a participar en la ejecución del proceso. ### Componentes obligatorios Algunos componentes son necesarios para que la plantilla funcione correctamente. Cuando un componente es obligatorio: * No puede desactivarse, o * La acción aparece bloqueada. La interfaz indica cuándo una configuración es necesaria para mantener el flujo válido. *** ## Configurar challenges Los challenges permiten incorporar verificaciones adicionales al proceso.
Los disponibles dependen de: * El tipo de proceso. * La plantilla. * El entorno. * Las funcionalidades habilitadas. ### Añadir un challenge Selecciona el challenge que quieres incorporar y completa los parámetros disponibles. Cada challenge puede tener sus propios: * Campos. * Valores iniciales. * Rangos. * Límites. * Dependencias. ### Editar un challenge Selecciona **Edit** para modificar sus parámetros. El sistema valida que los nuevos valores sean compatibles antes de guardar. ### Desactivar un challenge Cuando esta acción esté disponible, selecciona **Disable** para mantener el challenge configurado sin ejecutarlo. El challenge permanece visible, pero deja de participar en el proceso mientras esté deshabilitado. ### Restaurar un challenge Selecciona **Restore** para volver a incorporarlo a la ejecución. El sistema recupera su configuración y comprueba las dependencias necesarias. ### Orden de ejecución Cuando el proceso contiene varios challenges, su orden determina la secuencia en la que pueden ejecutarse. Si la interfaz permite modificar ese orden, organiza los challenges según el comportamiento esperado antes de publicar. *** ## Guardar un proceso Puedes guardar la configuración mientras trabajas en ella sin necesidad de publicarla. Selecciona la acción de guardado disponible. El proceso permanece en estado **Draft** hasta que se publique.
### Errores de validación Un proceso puede guardarse como borrador aunque todavía necesite ajustes. Sin embargo, determinados errores impiden publicarlo. Antes de publicar, revisa: * Campos obligatorios. * Valores fuera de rango. * Componentes requeridos. * Dependencias. * Configuraciones incompletas. {% hint style="info" %} Guardar y publicar son acciones diferentes. Guardar conserva la configuración; publicar la hace disponible para nuevas ejecuciones. {% endhint %} *** ## Clonar un proceso Selecciona **Clone** cuando quieras crear un nuevo proceso a partir de una configuración existente. El clon se crea como un proceso independiente del original. Utiliza esta opción cuando quieras reutilizar una configuración como punto de partida sin modificar el proceso existente. Después de clonarlo: 1. Abre el nuevo proceso. 2. Revisa sus datos identificativos. 3. Comprueba los componentes y parámetros heredados. 4. Revisa los challenges y dependencias. 5. Realiza los cambios necesarios. 6. Publica el nuevo proceso cuando esté preparado. Los cambios realizados en el clon no afectan al proceso original. {% hint style="info" %} Antes de publicar un proceso clonado, revisa toda su configuración. Una configuración válida para un proceso puede necesitar ajustes antes de reutilizarse en otro contexto. {% endhint %} *** ## Publicar un proceso Publicar hace que una versión del proceso quede disponible para nuevas ejecuciones. Selecciona **Publish** cuando la configuración esté completa.
### Validaciones antes de publicar Antes de permitir la publicación, el sistema comprueba que el proceso sea válido. Puede verificar: * Campos obligatorios. * Componentes necesarios. * Dependencias. * Valores configurados. * Challenges. * Otros requisitos de la plantilla. Si existe algún problema, corrige los elementos indicados antes de volver a intentarlo. ### Confirmar la publicación Selecciona **Publish** y revisa la confirmación. Después de publicar: * El proceso cambia a **Published**. * Se crea una versión inmutable. * Esa versión queda disponible para nuevas ejecuciones. * La configuración publicada no puede editarse directamente. *** ## Versiones de un proceso Cada publicación genera una versión de la configuración. Las operaciones conservan la referencia a la versión con la que se ejecutaron. Esto permite que una operación anterior siga representando exactamente la configuración utilizada en ese momento, aunque el proceso cambie posteriormente. ### Modificar un proceso publicado Para modificar un proceso Published: 1. Retíralo de publicación, cuando tengas permisos. 2. Realiza los cambios necesarios. 3. Guarda la configuración. 4. Valida de nuevo el proceso. 5. Publícalo. La nueva publicación genera una nueva versión. Las operaciones anteriores continúan vinculadas a sus versiones originales. {% hint style="info" %} El historial y la comparación visual entre versiones no forman parte de la funcionalidad actual. {% endhint %} *** ## Despublicar un proceso Selecciona **Unpublish** para impedir que el proceso siga utilizándose para iniciar nuevas ejecuciones.
Esta acción puede estar limitada a determinados roles. Antes de confirmar, revisa el impacto de retirar el proceso de publicación. Después de despublicarlo: * No se pueden iniciar nuevas ejecuciones con la versión retirada. * La configuración puede volver a modificarse cuando tus permisos lo permitan. * Las operaciones ya iniciadas o registradas conservan la información de la versión utilizada. Cuando vuelvas a publicar la configuración, se generará una nueva versión cuando corresponda. *** ## Archivar un proceso Selecciona **Archive** cuando quieras retirar un proceso del trabajo habitual sin eliminarlo definitivamente. El sistema solicita confirmación antes de completar la acción. Después de archivarlo: * El proceso deja de aparecer entre los procesos activos. * Su configuración se conserva. * Las operaciones anteriores continúan vinculadas a sus versiones. Según tus permisos, podrás recuperar posteriormente un proceso archivado. *** ## Eliminar un proceso La eliminación está disponible únicamente cuando el estado y tus permisos permiten realizarla. Selecciona **Delete** y revisa el modal de confirmación. Después de confirmar, el proceso deja de estar disponible para su gestión habitual. Las evidencias y referencias necesarias para mantener la trazabilidad de operaciones anteriores no se modifican. {% hint style="info" %} Eliminar un proceso es una acción irreversible desde la interfaz. Utiliza Archive cuando necesites retirarlo sin perder la posibilidad de recuperarlo. {% endhint %} *** ## Detalle de un proceso El detalle permite consultar la configuración de un proceso y ejecutar las acciones disponibles. Puede mostrar: * Nombre. * Descripción. * Process ID. * Tipo de proceso. * Entorno. * Plantilla. * Estado. * Versión. * Componentes. * Challenges. * Información técnica asociada. ### Copiar el Process ID Selecciona el icono de copia junto al Process ID. Utiliza este identificador cuando necesites referenciar el proceso durante una integración o una consulta técnica. ### Acciones disponibles Dependiendo del estado y de tus permisos, desde el detalle puedes encontrar acciones como: * Edit. * Clone. * Publish. * Unpublish. * Archive. * Delete. * Demo. *** ## Probar un proceso en modo demo El modo demo permite ejecutar un proceso publicado antes de utilizarlo en una integración real.
La acción solo está disponible cuando: * Existe una versión Published. * El modo demo está habilitado. * Tu perfil dispone de los permisos necesarios. ### Abrir la demo Selecciona la acción correspondiente desde el proceso. Se abrirá un modal con: * Información del proceso. * Código QR. * Instrucciones para iniciar la demo. ### Demo Web Para ejecutar un proceso Web: 1. Abre la URL de demo indicada desde un dispositivo móvil. 2. Utiliza la cámara para escanear el QR. 3. Completa el proceso. ### Demo Mobile Para un proceso Mobile, utiliza la aplicación de demo correspondiente y escanea el QR cuando se indique. ### Validez del QR El QR asociado al proceso: * Es persistente. * Puede reutilizarse. * No caduca. * No se consume después de una ejecución. * No se invalida al cerrar el modal. * No necesita regenerarse. El mismo QR ejecuta la versión **Published** que esté activa en ese momento. Si publicas una nueva versión, el QR utiliza esa nueva versión. ### Qué ocurre al despublicar Cuando el proceso no tiene una versión Published activa, el QR deja de iniciar nuevas demos. No es necesario generar otro código. Cuando vuelva a existir una versión Published, el mismo QR podrá utilizarse de nuevo. {% hint style="info" %} El QR identifica el proceso, no una ejecución concreta. Por eso puede utilizarse varias veces mientras exista una versión publicada. {% endhint %} *** ## Configuraciones adicionales Según las funcionalidades contratadas y los permisos de tu perfil, Configurator puede incluir otras áreas de configuración. Estas superficies pueden gestionar elementos que afectan a más de un proceso. Consulta únicamente las opciones disponibles en tu tenant y evita modificar configuraciones globales sin revisar previamente su impacto. *** ## Crear y publicar un proceso Como referencia, el flujo habitual para preparar un proceso es: 1. Abre **Processes**. 2. Selecciona **Create process**. 3. Elige el tipo de proceso. 4. Selecciona el entorno. 5. Elige una plantilla. 6. Completa la información requerida. 7. Revisa Terms & Conditions. 8. Configura los componentes. 9. Comprueba las dependencias. 10. Configura los challenges. 11. Guarda el proceso. 12. Corrige cualquier error de validación. 13. Selecciona **Publish**. 14. Confirma la publicación. 15. Comprueba el proceso mediante el modo demo. 16. Utiliza el Process ID y la información técnica necesaria para realizar la integración. Antes de publicar, revisa el flujo completo y comprueba que la configuración corresponde con la experiencia que quieres ofrecer al usuario.