> ## 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 Trébol

> Los tres métodos para crear verificaciones en Trébol: Aplicativo Web (no técnico), widget y API.

Trébol ofrece tres métodos para crear verificaciones. Elige el que mejor se adapte a tu caso y nivel de integración.

## Tabla comparativa

| Método              | Cuándo usarlo                                                                  | Quién carga los documentos | Requiere integración técnica        |
| ------------------- | ------------------------------------------------------------------------------ | -------------------------- | ----------------------------------- |
| **Aplicativo Web**  | Equipos que verifican ocasionalmente, sin integración técnica                  | Tú (desde la UI de Trébol) | No                                  |
| **Widget embebido** | Cliente con UI propia que quiere flujo de onboarding para sus usuarios finales | Usuario final (tu cliente) | Baja (HTML + script + account-flow) |
| **API directa**     | Integración técnica con máximo control                                         | Tú (desde tu backend)      | Media (llamadas REST)               |

***

## 1. Aplicativo Web

Crea verificaciones desde la interfaz web de Trébol. No requiere integración técnica.

**Cuándo usar:**

* Equipos que verifican ocasionalmente
* Para pruebas manuales o demos
* Cuando no hay recursos técnicos para integrar

**Cómo procesa Trébol:** Aplicativo Web crea items como `generic` por detrás — Trébol clasifica y extrae automáticamente.

**Cómo acceder:** Ingresa al Aplicativo Web de Trébol con tu cuenta y usa el botón "Crear verificación".

## 2. Widget embebido

Embebe el widget de Trébol (white-label) en tu sitio o aplicación. Tus usuarios finales (prospectos) interactúan con el widget para cargar documentos, y Trébol procesa.

**Cuándo usar:**

* Tienes tu propia UI y quieres que el onboarding ocurra dentro de tu producto
* Quieres una experiencia guiada de carga de documentos sin construirla tú
* Tus prospectos no son técnicos — solo necesitan subir archivos

**Cómo procesa Trébol:** el widget siempre opera con un `account-flow` que define los documentos requeridos. Trébol primero valida cada documento (tipo esperado + reglas) y después extrae la información.

**Cómo integrar:** Ver [Cómo funciona Vía Widget](/docs/guia-devs/crear-verificaciones/via-widget/overview).

## 3. API directa

Crea verificaciones llamando directamente a `POST /verifications` desde tu backend. Tú controlas qué items crear y cómo procesarlos.

**Cuándo usar:**

* Quieres integrarte directamente con tu backend, sin widget
* Tienes control sobre los archivos antes de enviarlos a Trébol
* Necesitas máxima flexibilidad

**Cómo procesa Trébol:** Tres formas de procesamiento, tú eliges cuál usar:

* **Clasificación automática** (item `generic`) — Trébol detecta el tipo y extrae
* **Validación** (item `doc_validation`) — Trébol verifica que el documento cumple criterios
* **Extracción** (item con tipo directo) — Trébol extrae directamente

**Cómo integrar:** Ver [Cómo funciona Vía API](/docs/guia-devs/crear-verificaciones/via-api/overview).