Skip to main content

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.

Ajusta la apariencia y el flujo de consentimiento del widget para que refleje tu marca: logo, colores, políticas y el modo de consentimiento que muestra al prospecto. La configuración se hace desde una interfaz con vista previa en tiempo real.
Esta funcionalidad requiere el permiso account:customize. Si no ves la opción “Personalización” en tu menú de configuración, contacta a tu administrador de cuenta.

​
Acceso a la interfaz

Para acceder a la configuración de personalización:
  1. Navega al Aplicativo Web de Trébol e inicia sesión
  2. Navega a Ajustes en el menú desplegable que se abre haciendo click en tu foto de perfil en la parte superior derecha de la pantalla
  3. Selecciona Personalización en el menú lateral
  4. Verás una interfaz dividida en dos columnas:
    • Izquierda: formulario de configuración
    • Derecha: vista previa en tiempo real del widget

​
Campos configurables

​
Información de la empresa

Nombre de la empresa

El nombre que se mostrará en el widget. Este aparecerá en múltiples lugares como el encabezado del sidebar y en los textos de consentimiento.Campo requerido

​
Branding visual

Logo de la empresa

Formatos soportados: PNG, JPG, GIF, WebP, SVGTamaño máximo: 20MBDimensiones recomendadas: 200x100px
Para mejor visualización, usa imágenes con fondo transparente (PNG o SVG)
El logo se mostrará en:
  • Sidebar del widget (versión pequeña)
  • Banner principal (versión grande, solo en modo referral)
  • Flujo “¿Cómo funciona?” (miniatura, solo en modo referral)

Colores

Color primario (requerido): color principal de tu marca, usado en botones, acentos y elementos activos.Color secundario (opcional): color complementario para elementos secundarios.
Los colores deben ser en formato hexadecimal. Ejemplos: #6BC33C, #000000. Se aceptan formatos cortos (#RGB) y completos (#RRGGBB).

​
URLs y políticas

Campo requeridoURL completa de tu política de privacidad. Los usuarios deberán aceptarla antes de continuar con el onboarding.Formato: https://tuempresa.com/privacidadEste enlace aparecerá en el footer del widget con el texto “política de privacidad”.
URL a la que será redirigido el usuario al finalizar exitosamente el proceso de onboarding.Formato: https://tuempresa.com/dashboardSi no se especifica, el usuario permanecerá en la página de confirmación del widget.

​
Configuración de consentimiento

Esta es una de las configuraciones más importantes, ya que determina el modelo de consentimiento y la experiencia del usuario en el widget.

​
El cliente acepta directamente tus términos

Cuándo usar: cuando tu empresa es el responsable principal del tratamiento de datos frente al cliente.Características:
  • El usuario acepta directamente tu política de privacidad
  • El widget muestra un formulario de captura de datos inmediato
  • No se muestra “Powered by Trébol” en el sidebar
  • El flujo es más directo: Email → NIT → Página Web → Comenzar
  • Footer simplificado con tu política de privacidad únicamente
Experiencia del usuario:
[Logo de tu empresa]

Validación de documentos
Completa los siguientes datos para iniciar tu proceso de registro

Email *
NIT (Sin dígito de verificación)*
Página Web

[Botón: Comenzar]

Al dar click en comenzar aceptas la política de privacidad de [Tu Empresa]
Esta opción es ideal para empresas que tienen su propio marco legal establecido y prefieren una experiencia de marca completamente propia.

​
Comparación visual

AspectoModo directoModo referral
Branding principalTu empresaTrébol + tu empresa
Powered by Trébol❌ No se muestra✅ Se muestra en sidebar
Landing page❌ Formulario directo✅ Landing con explicación completa
Sección “¿Cómo funciona?”❌ No incluida✅ Flujo visual de dos pasos
Tarjetas de beneficiosÍconos simplesTarjetas detalladas con descripciones
ConsentimientoSolo tu políticaTrébol + tu política

​
Vista previa en tiempo real

La columna derecha de la interfaz muestra una vista previa miniatura del widget que se actualiza automáticamente conforme realizas cambios:
1

Previsualización instantánea

Cada cambio en nombre, logo, colores o configuración de consentimiento se refleja inmediatamente en la vista previa.
2

Representación fiel

La vista previa replica fielmente la estructura y estilos del widget real, incluyendo layout de sidebar + contenido, colores y tipografía, y textos y descripciones según el modo seleccionado.
3

Tamaños responsivos

La vista previa está optimizada para mostrar una versión a escala del widget, manteniendo las proporciones y diseño originales.

​
Guardar los cambios

El botón “Guardar cambios” solo estará habilitado si has realizado al menos un cambio en la configuración. Los cambios se aplican inmediatamente a todas las nuevas verificaciones creadas con tu cuenta.
Al hacer clic en “Guardar cambios”:
  1. Validación de logo: si cargaste un nuevo logo, se valida tamaño y formato
  2. Subida a S3: el logo se sube a un bucket seguro de AWS S3
  3. Guardado de configuración: todos los campos se guardan en tu cuenta
  4. Aplicación inmediata: los cambios se reflejan en todas las nuevas instancias del widget

​
Mejores prácticas

Logo

  • Usa formato PNG o SVG con fondo transparente
  • Mantén dimensiones de 200x100px (ratio 2:1)
  • Asegúrate de que sea legible en tamaños pequeños
  • Evita logos con texto muy fino o detalles complejos

Colores

  • El color primario debe tener buen contraste con blanco para botones
  • Prueba tu paleta en la vista previa antes de guardar
  • Usa colores de tu guía de marca oficial
  • El secundario es opcional, úsalo solo si es necesario

URLs

  • Verifica que tu política de privacidad esté publicada y accesible
  • Usa HTTPS en todas las URLs
  • La URL de redirección debe apuntar a un recurso válido
  • Considera usar una landing page post-onboarding personalizada

Consentimiento

  • Consulta con tu equipo legal sobre qué modo usar
  • El modo directo requiere que tengas tu propia base legal
  • El modo referral es más seguro para instituciones financieras

​
Consideraciones

Los usuarios que ya tengan el widget abierto pueden no ver los cambios inmediatamente. Necesitarán recargar la página o iniciar una nueva verificación.
Los cambios se aplican de forma asíncrona. Puede tomar hasta 30 segundos para que la nueva configuración esté disponible en todas las regiones.
Posibles causas:
  • El archivo excede 20MB
  • El formato no es soportado (verifica que sea PNG, JPG, GIF, WebP o SVG)
  • El archivo está corrupto
Solución: prueba con un archivo diferente. Si el problema persiste, reduce el tamaño o cambia el formato.

​
Preguntas frecuentes

No actualmente. La configuración de personalización es a nivel de cuenta y se aplica a todos los flujos. Si necesitas diferentes experiencias, considera crear cuentas separadas.
Técnicamente sí, pero no es recomendable cambiar frecuentemente. Consulta con tu equipo legal antes de cambiar el modo de consentimiento, ya que tiene implicaciones legales sobre el tratamiento de datos.
Los formatos soportados son PNG, JPG, GIF, WebP y SVG. Si tu logo está en otro formato (EPS, AI, PSD), necesitarás convertirlo primero. Recomendamos PNG con fondo transparente o SVG.

​
Siguientes pasos

Instalar el widget

Embebe el widget en tu HTML con unas pocas líneas de código.

Estados del expediente

Cómo monitorear el progreso del expediente del usuario final.