Skip to main content
Personaliza la apariencia y el flujo de consentimiento del widget para que refleje tu marca. Configuras logo, colores, políticas, correos y el modelo de consentimiento desde una interfaz con vista previa. La personalización es a nivel de cuenta: se aplica a todas las nuevas verificaciones.
La personalización no tiene endpoint público. Se configura solo desde el aplicativo web, no vía API. Necesitas el permiso account:customize. Si no ves “Personalización” en tu menú de configuración, contacta a tu administrador de cuenta.

​
Acceso a la interfaz

1

Inicia sesión

Entra al Aplicativo Web de Trébol con tu cuenta.
2

Abre Ajustes

Haz clic en tu foto de perfil, arriba a la derecha, y elige Ajustes.
3

Selecciona Personalización

En el menú lateral, abre Personalización.
4

Trabaja con la vista previa

Verás dos columnas: a la izquierda el formulario y a la derecha una vista previa de la primera pantalla del widget.

​
Campos configurables

El formulario muestra los campos en este orden: nombre, logo, color primario, color secundario, política de privacidad, redirección, términos, correo de contacto, remitente de los correos, RFC obligatorio, checkbox de consentimiento y configuración de consentimiento. Solo el nombre de la empresa, el color primario y la URL de política de privacidad son requeridos. Los demás campos son opcionales.

​
Información de la empresa

Nombre de la empresa

Label en la interfaz: Nombre de la empresa. Campo requerido.Aparece en el encabezado del sidebar, en los textos de consentimiento y en varios títulos del widget.

​
Branding visual

Logo de la empresa

Label: Logo de la empresa. Opcional.Formatos: PNG, JPG, GIF, WebP, SVG. Tamaño máximo: 20 MB. Dimensiones recomendadas: 200x100px.
Usa imágenes con fondo transparente (PNG o SVG) para que se vea bien sobre cualquier color.
El logo aparece en cinco superficies del widget:
  • Sidebar (en todos los pasos del flujo, no solo al inicio).
  • Banner principal de la landing.
  • Sección “¿Cómo funciona?”.
  • Modal de confirmación (modo referral).
  • Modal de verificación duplicada.

Colores

Labels: Color primario (requerido) y Color secundario (opcional).El color primario se usa en botones, acentos y elementos activos. El secundario aplica a elementos secundarios, como el título de la pantalla de registro pendiente.
Usa formato hexadecimal. Se aceptan formatos cortos (#RGB) y completos (#RRGGBB). Ejemplos: #6BC33C, #000000.

​
URLs, correos y políticas

Label: URL de política de privacidad. Requerido.URL completa de tu política de privacidad. El prospecto la acepta antes de continuar. Aparece en el footer del widget.Formato: https://tuempresa.com/privacidad
Label: URL de redirección (opcional). Opcional.Si la configuras, la pantalla de éxito muestra un botón “Finalizar” que lleva a esa URL. El botón aparece solo cuando el registro quedó completo.Si la dejas vacía, la pantalla de éxito no tiene botón de salida.Formato: https://tuempresa.com/dashboard
Label: URL de términos y condiciones (opcional). Opcional.Solo acepta URLs http: o https:. Se muestra junto a la política de privacidad. Inserta “los términos y condiciones y” en el texto de consentimiento y agrega el enlace de términos en la columna Legal del footer.Formato: https://tuempresa.com/terminos
Label: Correo de contacto (opcional). Opcional.Reemplaza el correo de soporte de Trébol en el footer del widget. También es el correo de contacto de respaldo en la pantalla de verificación bloqueada.Formato: soporte@tuempresa.com
Label: Remitente de los correos (opcional). Opcional. Máximo 100 caracteres.Es el único campo que no afecta al widget, sino a los correos. Define el nombre visible del remitente en los correos automáticos de onboarding a tus prospectos.Si lo dejas vacío, el remitente es “Sofía de” seguido del nombre de tu empresa.

​
Campo fiscal obligatorio

Hacer el identificador fiscal (RFC/NIT) obligatorio

Label: Hacer el identificador fiscal (RFC/NIT) obligatorio. Opcional (checkbox).Vuelve requerido el campo fiscal del primer paso del widget. Su efecto depende del país del flujo. Revisa El primer formulario depende del país para el detalle por país.

​
Configuración de consentimiento

El consentimiento del prospecto se controla con dos ejes independientes que se combinan. No es una sola elección entre dos modos.

​
Eje 1 — quién obtiene el consentimiento

Lo controla el radio group Configuración de consentimiento. Tiene dos opciones:
Label: Trébol refiere leads.Trébol obtiene el consentimiento del lead para compartir sus datos con tu institución. Úsalo cuando necesitas que Trébol te refiera leads con autorización explícita.La landing muestra el co-branding completo de Trébol:
  • Se muestra “Powered By Trébol” en el sidebar.
  • Banner con el nombre de tu empresa y el texto “usa Trébol para validar documentos”.
  • Sección “¿Cómo funciona?” con el flujo de dos pasos.
  • Tarjetas de beneficios (Seguro, Rápido, Confidencial, Aprobado).
  • Sección “Lo que dicen nuestros clientes” con tres testimonios fijos y no configurables.
  • Footer con los términos de Trébol y tu política de privacidad.
  • Un modal de confirmación antes de enviar el primer formulario (ver más abajo).
Por defecto, si no configuras este control, el prospecto ve el co-branding completo de Trébol (equivale a Trébol refiere leads).

​
Eje 2 — cómo se acepta

Lo controla el checkbox Requerir aceptación explícita con checkbox, opcional e independiente del eje 1:
  • Sin marcar: consentimiento implícito. El prospecto acepta al hacer clic en “Comenzar”.
  • Marcado: aparece un checkbox de aceptación. El botón “Comenzar” queda deshabilitado hasta que el prospecto lo marca.

​
Las cuatro combinaciones

Los dos ejes producen cuatro combinaciones efectivas:
Consulta a tu equipo legal antes de elegir. El eje 1 define quién es el responsable del tratamiento de datos y tiene implicaciones legales.

​
El modal de confirmación (solo modo referral)

En modo Trébol refiere leads, antes de enviar el primer formulario aparece un modal “Compartir Información”. Pregunta si autorizas a Trébol a compartir tu información con la empresa y ofrece los botones Cancelar y Aceptar. En modo directo el formulario se envía sin ese paso.

​
El primer formulario depende del país

El primer paso del widget captura correo, identificador fiscal y página web. La etiqueta y la obligatoriedad del campo fiscal cambian según el país del flujo. El checkbox Hacer el identificador fiscal (RFC/NIT) obligatorio actúa sobre este mismo campo:
El campo se etiqueta RFC. Es opcional, salvo que actives el checkbox de identificador fiscal obligatorio.
El país es una propiedad del flujo (country), no de la personalización. Lo defines al crear el flujo.

​
Vista previa

La columna derecha muestra una miniatura estática de la primera pantalla del widget. Se actualiza conforme editas nombre, logo, colores y consentimiento. No es una réplica fiel del widget real. Ten en cuenta que:
  • Solo muestra la primera pantalla, no el flujo completo.
  • El listado de pasos del sidebar es de ejemplo y no refleja tu flujo real.
  • No tiene vista móvil ni navegación entre pasos.

​
Guardar los cambios

El botón “Guardar cambios” solo se habilita si hiciste al menos un cambio. Los cambios se aplican a las nuevas verificaciones creadas con tu cuenta.
Al guardar, Trébol valida los campos, guarda la configuración y la aplica a las nuevas verificaciones.

​
Dominio personalizado de onboarding

Las ligas de onboarding usan el dominio de Trébol (onboarding.gotrebol.com) salvo que configures tu propio dominio (por ejemplo verificacion.tuempresa.com) para que el prospecto vea tu marca en la URL durante todo el flujo. Con el dominio verificado, todas las ligas nuevas usan tu dominio:
  • Las ligas de inicio de onboarding quedan limpias, sin identificadores de cuenta: https://verificacion.tuempresa.com/<id_slug>, donde id_slug es el identificador legible del flujo que definiste en Crear el flujo. Por ejemplo: https://verificacion.tuempresa.com/onboarding-mx-minimo. Trébol genera estas ligas (el aplicativo web al crear una verificación, los correos de invitación automáticamente), y también puedes construirlas tú: el formato https://<tu-dominio>/<id_slug> es un contrato estable. Si el prospecto navega directo a https://verificacion.tuempresa.com/, entra al flujo por defecto de tu cuenta.
  • El campo onboarding_url que devuelve el API conserva su formato actual (liga directa a la verificación, con su token de acceso). El API ya devuelve la liga con tu dominio; no necesitas reescribir el host. Aplica desde el momento en que el dominio queda verificado, también al consultar verificaciones creadas antes; las ligas ya entregadas sobre el dominio de Trébol siguen funcionando.
El dominio aplica a las ligas de onboarding. El widget embebido (<trebol-widget>) sigue cargando desde el dominio por defecto de Trébol.
Como el resto de la personalización, el dominio no tiene endpoint público: se configura solo desde el aplicativo web, en la misma pantalla de Personalización y con el mismo permiso account:customize. Es independiente del botón “Guardar cambios”: cada acción (agregar, verificar, eliminar) aplica de inmediato.

​
Configurar el dominio

1

Agrega tu dominio

Escribe el dominio (por ejemplo verificacion.tuempresa.com) y confírmalo. Queda en estado Pendiente y la interfaz te muestra el registro DNS que debes crear.
2

Crea el registro DNS

En el panel de tu proveedor de DNS, crea el registro que indica la interfaz. La interfaz es la fuente de verdad: muestra el registro exacto para tu dominio. Los valores típicos son:
Registro CNAME apuntando a cname.vercel-dns.com. Para verificacion.tuempresa.com, la fila queda así:
3

Verifica

Haz clic en Verificar. Trébol confirma dos cosas: que el dominio te pertenece y que el DNS ya rutea correctamente. La propagación del DNS puede tardar desde minutos hasta horas según tu proveedor.

​
Mientras el dominio está pendiente

Nada se rompe: las ligas siguen usando el dominio por defecto de Trébol hasta que tu dominio queda Verificado. Lo mismo aplica si nunca configuras un dominio. Si la verificación no pasa, la interfaz te dice por qué. Puede ser que el DNS aún no apunte (espera la propagación y reintenta) o que el dominio requiera una validación extra de propiedad (sigue las instrucciones en pantalla). La verificación es siempre manual: no hay reintento automático ni límite de tiempo — un dominio puede quedar en Pendiente indefinidamente sin afectar nada. El certificado TLS se emite de forma automática al verificar; no necesitas gestionarlo. Si una liga usa un id_slug que no existe o cuyo flujo fue eliminado, el prospecto ve la misma pantalla de error que hoy muestra una liga de flujo inválida en el dominio de Trébol.

​
Eliminar o cambiar el dominio

Al eliminar un dominio verificado, toda liga sobre ese dominio deja de resolver de inmediato — tanto las ya enviadas a prospectos como cualquier onboarding_url que hayas persistido en tu sistema. Las nuevas vuelven al dominio por defecto de Trébol. El aplicativo pide confirmación antes de aplicar.
Si guardaste ligas en tu sistema, vuelve a consultar la verificación en el API después de eliminar o cambiar el dominio: onboarding_url se calcula al momento de la consulta y devuelve la liga vigente. Para cambiar de dominio, agrega el nuevo: Trébol libera el anterior automáticamente y el nuevo inicia su propio ciclo de verificación.

​
Mejores prácticas

Logo

  • Usa PNG o SVG con fondo transparente.
  • Mantén el ratio 2:1 (por ejemplo 200x100px).
  • Verifica que sea legible en tamaños pequeños.
  • Cárgalo siempre: el widget real no tiene imagen de reemplazo.

Colores

  • Usa un primario con buen contraste sobre blanco.
  • Prueba tu paleta en la vista previa antes de guardar.
  • Toma los valores de tu guía de marca.

URLs

  • Publica tu política de privacidad y verifica que sea accesible.
  • Usa HTTPS en todas las URLs.
  • Apunta la redirección a un recurso válido.

Consentimiento

  • Define el eje 1 con tu equipo legal.
  • Activa el checkbox si necesitas aceptación explícita.
  • Evita cambiar el modo con frecuencia.

​
Preguntas frecuentes

La personalización (logo, colores, políticas, consentimiento) es a nivel de cuenta y se aplica a todos los flujos.Aun así, algunas cosas sí varían por flujo: el país (country) y los pasos de la pantalla de éxito (next_steps_checkout). Configúralos en Crear el flujo.
Técnicamente sí, pero no es recomendable cambiarlo con frecuencia. Consulta a tu equipo legal antes, porque el eje 1 tiene implicaciones sobre el tratamiento de datos.
El logo es opcional en el formulario. La vista previa del aplicativo web muestra un placeholder con el ícono de un edificio, pero el widget real no tiene imagen de reemplazo: el prospecto ve una imagen rota. En la práctica, carga siempre tu logo.
El botón de eliminar solo limpia la vista previa local. El logo guardado se conserva. Para cambiar tu marca, sube un logo diferente y guarda.
Los formatos soportados son PNG, JPG, GIF, WebP y SVG. Si tu logo está en otro formato (EPS, AI, PSD), conviértelo 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.