Personalización
Hoy el widget de firma embebida se ve igual para todas las cuentas: colores y logo de AllSign, y el pie «Powered by AllSign». Esta página separa lo que funciona hoy de lo que está planeado.
Hoy no puedes configurar la apariencia del widget. El SDK (@allsign/embedded 0.3.x) acepta las opciones theme y values, pero no las envía al iframe: no cambian colores, logo ni contenido. El idioma sí se elige: desde 0.3.1, la opción locale cambia el idioma de todo el widget (ver Idioma). No hay una API de perfiles de marca, y la pestaña Marca de tu espacio de trabajo en el Dashboard no afecta al widget embebido. El campo brand_profile_id de las Signing Sessions tampoco tiene efecto: no lo envíes.
Lo que hay hoy
| Aspecto | Comportamiento hoy |
|---|---|
| Colores | Los de AllSign. No se pueden cambiar. |
| Logo | El de AllSign, en la pantalla de carga y en el pie. No se puede cambiar. |
| «Powered by AllSign» | Siempre visible en el pie del widget. |
| Texto del botón de firmar | Fijo. No es configurable. |
| Idioma | Lo eliges con locale ('es-MX' o 'en-US') desde el SDK 0.3.1. Sin locale, español, o inglés si el idioma principal del navegador del firmante es inglés. |
Opciones del SDK sin efecto en 0.3.x
| Opción | Estado en 0.3.x |
|---|---|
theme | Se acepta y se ignora. No cambia colores, fondo ni logo. |
values | Se acepta y se ignora. No pre-llena variables del documento. |
Pasar estas opciones no produce error, pero tampoco cambia nada en el widget.
Idioma
Desde @allsign/embedded 0.3.1, locale elige el idioma de todo el flujo de firma dentro del iframe: pantallas, botones, errores, e.firma y firma simple.
const session = AllSign.init({ clientSecret, locale: 'en-US' })
| Valor | Resultado |
|---|---|
'es-MX' o 'es' | Todo el widget en español. |
'en-US' o 'en' | Todo el widget en inglés. |
Sin locale | Decide el navegador del firmante: inglés si su idioma principal es inglés, español en cualquier otro caso. |
| Otro valor | El SDK deja un aviso en la consola, no lo envía y decide el navegador. |
El botón de cerrar del modal y el title del iframe también siguen el idioma. Si tu código o tus pruebas seleccionan el iframe por su title, actualízalos: desde 0.3.1 es «Firma electrónica de AllSign» o «AllSign electronic signature».
El texto del botón de firmar no es configurable
Pulsar el botón de firmar es el momento en que el firmante manifiesta su voluntad de firmar. Para que ese consentimiento sea claro, AllSign define el texto de ese botón y no se puede cambiar, ni hoy ni en lo planeado.
Lo que está planeado
Lo siguiente es plan, no funcionalidad disponible. Cuando exista, se documentará aquí.
- Color del widget desde tu espacio de trabajo. Las cuentas con un plan de pago podrán definir el color principal del widget en su espacio de trabajo, y se aplicará a sus sesiones de firma embebida sin cambiar tu integración.
- «Powered by AllSign» siempre visible. Ninguna opción lo ocultará. El widget se sirve desde
allsign.io, y el pie le dice al firmante quién genera su firma y su evidencia. - Sin CSS propio ni logos por URL externa. La personalización se limitará a valores que AllSign valida, como el color; el widget no aceptará hojas de estilo propias ni imágenes cargadas desde otros dominios.
Siguiente paso
- Eventos y Callbacks — Reacciona a cada paso de la firma
- Seguridad — Protege tus sesiones de firma