Personalización

Haz que la experiencia de firma se sienta parte de tu producto. Configura colores, logo, textos y idioma — tus usuarios nunca sabrán que AllSign está por detrás.

Dos niveles de personalización

Nivel	Dónde se configura	Alcance	Uso típico
Brand Profile	API o Dashboard	Todas las firmas de tu cuenta	Configuración base: logo, colores corporativos
Runtime Theme	JS SDK (`theme` option)	Una sesión específica	Override por sesión: textos, colores situacionales

El theme, el locale y los values del SDK aún no toman efecto en la versión actual (@allsign/embedded 0.3.x). El SDK acepta estas opciones pero todavía no las reenvía al iframe, así que no cambian la apariencia, el idioma ni pre-llenan variables en la firma embebida. Para branding hoy, usa el Brand Profile (configurable desde el Dashboard); el idioma de la firma embebida es es-MX. Las opciones theme / locale / values de esta página quedan como roadmap.

Brand Profiles (vía API)

El endpoint POST /v2/brand-profiles está en desarrollo y no está disponible aún. Por ahora, configura tu brand profile desde el Dashboard. La configuración vía API estará disponible en una próxima versión.

Crea un perfil de marca que se aplica a todas las sesiones de firma embebida de tu cuenta.

POST

/v2/brand-profiles

curl -X POST "https://api.allsign.io/v2/brand-profiles" \
  -H "Authorization: Bearer allsign_live_sk_TU_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "name=Mi Empresa" \
  -F "logo=@logo.png" \
  -F "primary_color=#1a73e8" \
  -F "background_color=#f8f9fa" \
  -F "button_text_color=#ffffff" \
  -F "hide_allsign_branding=true"

Propiedades del Brand Profile

Propiedad	Tipo	Descripción
`name`	`string`	Nombre de tu empresa (se muestra en el header)
`logo`	`file`	Logo en PNG o SVG (máx 2MB, recomendado 200x60px)
`primary_color`	`string`	Color de botones y acentos (hex)
`background_color`	`string`	Color de fondo del widget
`button_text_color`	`string`	Color del texto en botones
`hide_allsign_branding`	`boolean`	Oculta "Powered by AllSign" del footer

Usar un Brand Profile al crear documentos

Asocia tu perfil de marca al crear un documento:

El brand_profile_id se pasa al crear la Signing Session, no al crear el documento:

{
  "document_id": "DOC_UUID",
  "signer_email": "juan@empresa.com",
  "brand_profile_id": "550e8400-e29b-41d4-a716-446655440000"
}

Runtime Theme (vía JS SDK)

Overrides puntuales al montar el widget. Ideal para adaptar la experiencia por contexto (ej: un botón que diga "Aceptar contrato" en vez de "Firmar").

const session = AllSign.init({
  clientSecret: 'as_sess_xxx_secret_yyy',
  theme: {
    primaryColor: '#e63946',        // Rojo para urgencia
    backgroundColor: '#f1faee',     // Fondo suave
    buttonText: 'Aceptar y firmar', // Texto contextual
    logo: 'https://mi-app.com/logo-dark.svg',
  },
  onSuccess: (result) => { /* firmado */ },
});

session.inline('#firma-container');

Propiedades del Theme

Propiedad	Tipo	Descripción
`primaryColor`	`string`	Color principal — botones, links, acentos
`backgroundColor`	`string`	Fondo del widget de firma
`buttonText`	`string`	Texto del botón principal (default: "Firmar documento")
`logo`	`string`	URL del logo (override del brand profile)

Roadmap: cuando el SDK reenvíe el theme al iframe, tendrá prioridad sobre el Brand Profile para overrides por sesión. En la versión actual (0.3.x) el theme no toma efecto — usa el Brand Profile.

Locale

El SDK soporta español (México) e inglés de forma nativa.

const session = AllSign.init({
  clientSecret: 'as_sess_xxx_secret_yyy',
  locale: 'es-MX',  // o 'en-US'
  onSuccess: (result) => { /* firmado */ },
});

session.inline('#firma-container');

Locale	Idioma	Textos incluidos
`es-MX`	Español (México)	Botones, instrucciones, errores, confirmaciones
`en-US`	English (US)	Buttons, instructions, errors, confirmations

Cuando el locale tome efecto (roadmap), afectará todos los textos de la interfaz de firma. En la versión actual (0.3.x) la firma embebida se muestra en es-MX.

Configuración desde el Dashboard

También puedes gestionar Brand Profiles desde el Dashboard de AllSign:

Ve a Configuración → Marca
Sube tu logo y define tus colores corporativos
Activa "Ocultar branding de AllSign" si lo deseas
El perfil se aplica automáticamente a todas las firmas embebidas

Ejemplo: White-label completo

Combinando Brand Profile + Runtime Theme para una experiencia completamente de marca blanca:

// Brand Profile ya configurado vía API con:
// - Logo de tu empresa
// - Colores corporativos
// - hide_allsign_branding: true

// Runtime: solo ajustes contextuales
const session = AllSign.init({
  clientSecret: 'as_sess_xxx_secret_yyy',
  locale: 'es-MX',
  theme: {
    buttonText: 'Confirmar y firmar carta porte',  // Texto específico del contexto
  },
  onSuccess: (result) => { /* firmado */ },
});

session.inline('#firma-container');

El resultado: tu usuario ve una interfaz con tu logo, tus colores, sin mención de AllSign, con un botón que dice "Confirmar y firmar carta porte". Detrás, AllSign genera la evidencia NOM-151, timestamps criptográficos y el PDF de evidencia.

Siguiente paso

Eventos y Callbacks — Reacciona a cada paso de la firma
Seguridad — Protege tus sesiones de firma