Cómo personalizar con marca blanca una API de firma de documentos en su producto SaaS

¿Busca el desglose completo? Esta publicación cubre los conceptos y decisiones clave. Para obtener una guía detallada de cada función de marca blanca, incluidos logotipos, temas de color, plantillas de correo electrónico personalizadas, direcciones de remitente y ejemplos de código, consulte la Guía completa de firmas electrónicas de marca blanca para SaaS.

Si está integrando una API de firma de documentos en su producto, sus clientes no deberían sentir que están utilizando el software de otra persona. La experiencia de firma debe verse y sentirse como su producto, no como una herramienta de terceros.

La marca blanca lo hace posible. Pero la mayoría de los desarrolladores piensan que la marca blanca solo significa poner su logotipo en algo. En la práctica, es más complejo. Una integración de API de firma digital con personalización de marca completa implica marca visual, personalización de correo electrónico, control de notificaciones e interfaces incrustadas, y no siempre las necesita todas. Para conocer todo el alcance de lo que puede personalizar, consulte la descripción general de la función de API de firma electrónica de marca blanca.

Esta guía detalla qué hace cada capa, cuándo utilizarla y cómo implementar una API de firma de PDF de marca blanca que se adapte a su producto.

Qué significa realmente la marca blanca para las firmas electrónicas

Cuando un cliente firma un documento a través de su aplicación, varios puntos de contacto llevan la marca:

• La interfaz de firma en sí (logotipo, colores, diseño)

• El correo electrónico que les notifica que un documento está listo para firmar

• La dirección del remitente y la plantilla de correo electrónico

• Notificaciones de finalización y de recordatorio

• Cualquier término legal o paso de aceptación

Por defecto, la mayoría de las API de firma marcan todo esto con su propio nombre. El etiquetado blanco le permite reemplazar esa marca con la suya propia o eliminarla por completo.

El objetivo es simple: sus clientes interactúan con su marca en todo el flujo de trabajo de firma. Nunca ven al proveedor de la API subyacente.

Las cuatro capas del etiquetado blanco

Capa 1: Imagen de marca visual

El impacto más inmediato. Suba su logotipo, configure su paleta de colores y oculte por completo la marca del proveedor de la API de la experiencia de firma.

Con Firma.dev, controla seis configuraciones de color (color de acento principal, texto de primer plano, fondo, color de tarjeta y color de borde) y puede cargar logotipos tanto a nivel de empresa como de espacio de trabajo. Para productos SaaS multiinquilino, esto significa que cada uno de sus clientes puede tener su propia identidad visual distinta en el flujo de firma.

Habilite show_custom_branding_only y la interfaz de firma parecerá construida por su equipo. Sin logotipos de terceros, sin esquemas de color desconocidos.

Esta capa tarda unos minutos en implementarse y tiene el mayor impacto visible. Comience aquí incluso si planea agregar las otras capas más adelante.

Capa 2: Dominios de correo electrónico y plantillas personalizadas

En lugar de enviar solicitudes de firma desde noreply@signatureprovider.com, los correos electrónicos se envían desde su dominio, como documents@yourcompany.com. También controla la parte local de la dirección del remitente (la parte antes de @), de modo que puede usar noreply, signing, contracts, lo que mejor se adapte a su producto.

Más allá del remitente, puede personalizar las propias plantillas de correo electrónico. Firma.dev admite plantillas HTML personalizadas para 11 tipos de correo electrónico (invitaciones de firma, finalizaciones, recordatorios, vencimientos y más), con marcadores de posición dinámicos para los nombres de los firmantes, enlaces de firma, logotipos de la empresa y detalles del equipo. Configure plantillas a nivel corporativo para mantener la coherencia y anúlelas por espacio de trabajo cuando sea necesario.

Para productos SaaS multiinquilino, los dominios de correo electrónico a nivel de espacio de trabajo significan que cada uno de sus clientes puede realizar envíos desde su propio dominio. Una plataforma de gestión de propiedades podría hacer que los correos electrónicos de firma provengan de leases@buildingname.com para cada propiedad.

Si busca una implementación rápida, consulte Cómo etiquetar en blanco sus correos electrónicos de firma electrónica y enlaces de firma para obtener una guía paso a paso.

Capa 3: Control de notificaciones

Los correos electrónicos de marca y las plantillas personalizadas son buenos. Un control total sobre las notificaciones es mejor.

La mayoría de las API de firma digital envían correos electrónicos automatizados para solicitudes de firma, confirmaciones de finalización, advertencias de vencimiento y avisos de cancelación. Una configuración de marca blanca le permite deshabilitar cualquiera o todas estas opciones por solicitud de firma.

¿Por qué querría deshabilitarlas? Porque tal vez quiera:

• Enviar enlaces de firma a través de su propia infraestructura de correo electrónico

• Integrar las notificaciones en los flujos de comunicación existentes con los clientes

• Controlar los tiempos de los recordatorios y seguimientos

• Activar correos electrónicos basados en su propia lógica empresarial

Cuando deshabilita los correos electrónicos de la API, recupera las URL de firma directamente de la API y las distribuye como desee. Esto es especialmente útil si ya dispone de una infraestructura de correo electrónico transaccional (SendGrid, Postmark, Customer.io) y desea que las notificaciones de firma fluyan a través del mismo sistema.

Capa 4: Experiencias de firma integradas

Esta es la solución completa de marca blanca. En lugar de redirigir a los usuarios a una página de firma de terceros, integra la interfaz de firma directamente en su aplicación.

Con la firma integrada, todo el flujo de trabajo ocurre dentro de su producto. Los usuarios nunca abandonan su dominio. Ven su encabezado, su navegación, su diseño. La interfaz de firma aparece como una parte integrada de su aplicación, renderizada con su logotipo y colores.

La mayoría de las API de firma de PDF ofrecen componentes integrables para:

• Firma: El flujo de firma de documentos real

• Edición de plantillas: Permitir que los usuarios definan campos de firma y marcadores de posición

• Configuración de la solicitud de firma: Configuración de destinatarios, orden y opciones

Las experiencias integradas suelen utilizar autenticación JWT (JSON Web Token). Su backend genera un token de corta duración y el frontend carga el componente integrado con ese token. No se exponen claves de API al cliente.

La personalización del flujo integrado ahora va un paso más allá de la propia interfaz. El texto del botón orientado al firmante se puede personalizar por idioma, por lo que los botones dentro de su vista de firma integrada pueden coincidir con la terminología de su producto en lugar de heredar los valores predeterminados genéricos. Consulte las etiquetas de botones de firma personalizables para saber cómo configurarlas.

Para los productos SaaS donde la firma de documentos es una función principal, la firma integrada suele valer el esfuerzo de implementación. Su producto se siente más cohesionado y mantiene un control total sobre la experiencia del usuario.

Elegir el enfoque correcto

No todas las integraciones necesitan una marca blanca completa. Aquí se explica cómo decidir:

El logotipo, colores y correos electrónicos de marca funcionan bien cuando la firma es una función secundaria. Sus clientes obtienen una experiencia profesional y personalizada sin un esfuerzo de desarrollo significativo. La implementación lleva unas pocas horas, principalmente la configuración de DNS y un par de llamadas a la API para la imagen de marca visual.

Lo anterior + plantillas de correo electrónico personalizadas se adapta a productos en los que desea comunicaciones de marca sin reemplazar su infraestructura de correo electrónico. Personaliza el contenido y el HTML de los correos electrónicos de firma mientras Firma.dev se encarga de la entrega. Esto agrega una o dos horas de trabajo con plantillas.

Lo anterior + control de notificaciones es el paso correcto cuando desea poseer la capa de comunicación por completo. Es posible que tenga requisitos de cumplimiento específicos en relación con el correo electrónico, o que desee que las notificaciones de firma fluyan a través de su sistema transaccional existente. Esto añade uno o dos días de trabajo de integración.

La experiencia integrada completa es la opción correcta cuando la firma es fundamental para su producto. Plataformas de recursos humanos, herramientas de gestión de contratos, software inmobiliario, sistemas de incorporación de atención médica. Si sus clientes pasan un tiempo considerable en los flujos de trabajo de firma, integrar esa experiencia vale la pena. Espere de unos días a una semana de trabajo de integración, según la cantidad de componentes que integre.

Consideraciones de implementación

Algunas cosas en las que pensar antes de empezar:

1. Espacios de trabajo y multiinquilino. Si está creando un producto SaaS multiinquilino, busque una API de firma de documentos que admita espacios de trabajo de clientes. Cada uno de sus clientes obtiene un entorno aislado con sus propias plantillas, historial de firmas, marca y (opcionalmente) dominio de correo electrónico. Esto mantiene los datos claramente separados sin tener que desarrollar la separación de inquilinos usted mismo.

2. La jerarquía de configuración. Los ajustes de marca en Firma.dev se aplican en cascada: el espacio de trabajo prevalece sobre la empresa, la empresa prevalece sobre los valores predeterminados. Esto significa que configura la marca de toda la empresa una vez y solo configura las excepciones a nivel de espacio de trabajo donde sea necesario. Establecer un valor de espacio de trabajo en null hereda del nivel de empresa.

3. Seguridad. Genere tokens JWT en su backend, nunca en el código del lado del cliente. Mantenga el vencimiento del token corto (lo habitual es de 1 a 4 horas). Valide los orígenes de los mensajes de iframe si gestiona eventos de componentes integrados.

4. Cumplimiento normativo. La marca blanca no cambia la validez legal de las firmas. Una API de firma digital bien diseñada mantiene el cumplimiento con ESIGN, UETA y eIDAS independientemente de la marca. Asegúrese de que su proveedor sea compatible con los marcos regulatorios relevantes para sus clientes.

5. Costo. Las plataformas de firma corporativas a menudo cobran tarifas premium por las funciones de marca blanca. Algunos proveedores incluyen la marca blanca en todos los niveles de precios. Firma.dev incluye todas las capacidades de marca blanca con tarifas de pago por uso a 0,029 € por sobre (~3 ¢ de USD), sin contratos ni mínimos.

Primeros pasos

Si está evaluando las API de firma de documentos para una integración de marca blanca, comience por identificar qué puntos de contacto son más importantes para sus clientes. ¿Les importa la marca del correo electrónico? ¿Necesitan integrar el flujo de firma? Las respuestas guiarán el alcance de su implementación. Para obtener una visión estratégica más amplia que abarque configuraciones de marca única y multiinquilino, consulte la guía completa de firmas electrónicas de marca blanca para SaaS.

Para obtener un desglose técnico detallado, la Guía de marca blanca de Firma.dev cubre dominios de correo electrónico personalizados, configuraciones de notificación y componentes integrados con ejemplos de código.

¿Listo para construir? Obtenga su clave de API y comience la integración en cuestión de horas, no de semanas.