> ## Documentation Index
> Fetch the complete documentation index at: https://gotrebol.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo funciona Vía Widget

> El widget de onboarding de Trébol permite que tus usuarios finales carguen documentos directamente desde tu aplicación.

El **widget de onboarding** es un componente embebido (white-label) que se integra en tu aplicación para que **tus usuarios finales (prospectos)** puedan cargar documentos directamente. Trébol procesa los documentos en segundo plano y tu backend recibe los resultados.

Esta vía es ideal cuando:

* Tienes una aplicación propia y quieres que el onboarding ocurra dentro de ella
* Quieres una experiencia guiada de carga de documentos para tus usuarios finales sin construirla tú
* Tus prospectos no son técnicos — solo necesitan subir archivos

## Flujo mental

<Steps>
  <Step title="Creas un flujo">
    Defines qué documentos pedir al usuario final, qué reglas aplicar y qué items adicionales capturar (ubos, formularios). Ver [Crear el flujo](/docs/guia-devs/crear-verificaciones/via-widget/crear-flujo).
  </Step>

  <Step title="Embebes el widget en tu web/app">
    El usuario final ve el formulario y los campos de carga directamente en tu aplicación.
  </Step>

  <Step title="El usuario final sube documentos y llena formularios">
    Carga los documentos requeridos y completa los items configurados (ubos, forms).
  </Step>

  <Step title="Trébol valida cada documento">
    Verifica que cada documento sea del tipo esperado y cumpla las reglas configuradas.
  </Step>

  <Step title="Trébol extrae la información">
    Si el documento pasó la validación, extrae los datos estructurados.
  </Step>

  <Step title="Recibes los resultados">
    Vía [webhook](/docs/guia-devs/webhooks) o consulta a la API.
  </Step>
</Steps>

## Piezas clave

| Pieza                      | Qué es                                                                                             | Donde se configura                                                                                                         |
| -------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Flujo de onboarding**    | Configuración de qué documentos pedir, qué validaciones aplicar, qué pasos mostrar                 | Vía API (`POST /account-flows`) — ver [Crear el flujo](/docs/guia-devs/crear-verificaciones/via-widget/crear-flujo)             |
| **Widget embebido**        | Componente HTML + JavaScript que se inserta en tu página web                                       | Script en tu HTML — ver [Instalar el widget](/docs/guia-devs/crear-verificaciones/via-widget/instalar)                          |
| **Branding**               | Colores, logo, textos, políticas del widget                                                        | Web app de Trébol — ver [Personalizar el widget](/docs/guia-devs/crear-verificaciones/via-widget/personalizar)                  |
| **Estados del expediente** | Estado global del expediente y estado por requerimiento a medida que el prospecto carga documentos | Respuesta de la verificación — ver [Estados del expediente](/docs/guia-devs/crear-verificaciones/via-widget/estados-expediente) |

## Qué puede capturar el widget

El widget captura dos cosas distintas:

* **Requerimientos de documentos**: los documentos que el widget le solicita al prospecto (ej: constancia fiscal, acta constitutiva). Se configuran en el `record_validation_schema` del flujo, y cada requerimiento puede tener su propio conjunto de [reglas de validación](/docs/guia-devs/crear-verificaciones/via-api/reglas-validacion).
* **Items del widget** (`ubos`, `forms`): información adicional distinta a documentos — declaración de beneficiarios reales y formularios personalizados. Se configuran en `flow_items` del flujo, que también acepta consultas a fuentes externas que corren automáticamente.

Ver detalle de ítems en [Items del flujo](/docs/guia-devs/crear-verificaciones/via-widget/items). Ver cómo armar ambas partes del flujo en [Crear el flujo](/docs/guia-devs/crear-verificaciones/via-widget/crear-flujo).

## Diferencia con Vía API

|                              | Vía Widget                                         | Vía API                       |
| ---------------------------- | -------------------------------------------------- | ----------------------------- |
| **Quién carga el documento** | Usuario final (tu cliente)                         | Tú (desde tu backend)         |
| **Flujo obligatorio**        | Sí — requiere `account-flow`                       | No — opcional                 |
| **Validación**               | Siempre (vía `record_validation_schema` del flujo) | Opcional — tú eliges la forma |
| **Extracción**               | Siempre (después de validar)                       | Opcional — tú eliges la forma |
| **UI / UX**                  | Trébol provee el widget                            | Tú construyes tu UI           |

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Crear el flujo" href="/docs/guia-devs/crear-verificaciones/via-widget/crear-flujo">
    Define qué documentos pedir, qué reglas aplicar, qué pasos mostrar.
  </Card>

  <Card title="Instalar el widget" href="/docs/guia-devs/crear-verificaciones/via-widget/instalar">
    Embebe el widget en tu HTML con unas pocas líneas de código.
  </Card>

  <Card title="Personalizar el widget" href="/docs/guia-devs/crear-verificaciones/via-widget/personalizar">
    Configura colores, logo, políticas y textos.
  </Card>

  <Card title="Items del flujo" href="/docs/guia-devs/crear-verificaciones/via-widget/items">
    Detalle de ubos, forms y consultas a fuentes externas.
  </Card>
</CardGroup>