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: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.
- 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
Creas un flujo
Defines qué documentos pedir al usuario final, qué reglas aplicar y qué items adicionales capturar (ubos, formularios). Ver Crear el flujo.
Embebes el widget en tu web/app
El usuario final ve el formulario y los campos de carga directamente en tu aplicación.
El usuario final sube documentos y llena formularios
Carga los documentos requeridos y completa los items configurados (ubos, forms).
Trébol valida cada documento
Verifica que cada documento sea del tipo esperado y cumpla las reglas configuradas.
Recibes los resultados
Vía webhook o consulta a la API.
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 |
| Widget embebido | Componente HTML + JavaScript que se inserta en tu página web | Script en tu HTML — ver Instalar el widget |
| Branding | Colores, logo, textos, políticas del widget | Web app de Trébol — ver Personalizar el widget |
| 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 |
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_schemadel flujo, y cada requerimiento puede tener su propio conjunto de reglas de validación. - Items del widget (
ubos,forms): información adicional distinta a documentos — declaración de beneficiarios reales y formularios personalizados. Se configuran enflow_itemsdel flujo, que también acepta consultas a fuentes externas que corren automáticamente.
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
Crear el flujo
Define qué documentos pedir, qué reglas aplicar, qué pasos mostrar.
Instalar el widget
Embebe el widget en tu HTML con unas pocas líneas de código.
Personalizar el widget
Configura colores, logo, políticas y textos.
Items del flujo
Detalle de ubos, forms y consultas a fuentes externas.