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 exhaustiva 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. Sin embargo, la mayoría de los desarrolladores piensan que la marca blanca consiste simplemente en colocar su logotipo en algún sitio. En la práctica, es más complejo. Una integración de API de firma digital totalmente de marca blanca implica personalización visual, personalización de correos electrónicos, control de notificaciones e interfaces incrustadas, y no siempre las necesitará todas. Para conocer el alcance completo de lo que puede personalizar, consulte la descripción general de las funciones de la API de firma electrónica de marca blanca.

Esta guía detalla lo que hace cada capa, cuándo utilizarlas 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 su marca:

• La propia interfaz de firma (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

• Las notificaciones de finalización y 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. La marca blanca le permite reemplazar esa marca por la suya propia, o eliminarla por completo.

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

Las cuatro capas de la marca blanca

Capa 1: Personalización visual

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

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

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

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

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

En lugar de enviar solicitudes de firma desde noreply@signatureprovider.com, los correos electrónicos se envían desde su propio dominio, como documents@yourcompany.com. También puede controlar la parte del destinatario de la dirección del remitente (lo que va antes de la arroba @), por lo que puede usar noreply, signing, contracts, o 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 nombres de firmantes, enlaces de firma, logotipos de la empresa y detalles del equipo. Configure las plantillas a nivel de empresa para mantener la coherencia y anúlelas por espacio de trabajo cuando sea necesario.

Para los 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 procedieran de leases@buildingname.com para cada propiedad.

Si busca una implementación rápida, consulte la guía paso a paso Cómo aplicar la marca blanca a sus correos electrónicos de firma electrónica y enlaces de firma.

Capa 3: Control de notificaciones

Disponer de correos electrónicos de marca y plantillas personalizadas es fantástico. Tener el control total de las notificaciones es aún mejor.

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

¿Por qué querría desactivarlas? Porque tal vez prefiera:

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

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

• Controlar la frecuencia de los recordatorios y seguimientos

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

Al desactivar los correos electrónicos de la API, usted recupera las URL de firma directamente de la API y las distribuye como desee. Esto resulta 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 por el mismo sistema.

Capa 4: Experiencias de firma incrustadas

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

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

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

• Firma: El flujo de firma real del documento

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

• Configuración de solicitudes de firma: Ajustar los destinatarios, el orden y las opciones

Las experiencias incrustadas suelen utilizar autenticación JWT (JSON Web Token). Su servidor genera un token de corta duración, y el cliente interactivo carga el componente integrado utilizando ese token. No se exponen claves de API al cliente.

Llevar la marca blanca al flujo incrustado va ahora un paso más allá del diseño visual. El texto de los botones dirigidos al firmante se puede personalizar por idioma, por lo que los botones incluidos en su vista de firma incrustada pueden coincidir con la terminología de su producto en lugar de heredar los valores genéricos predeterminados. Consulte 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 incrustada suele merecer el esfuerzo de implementación. Su producto se percibirá como un todo más cohesionado y usted mantendrá el control total sobre la experiencia de usuario.

Cómo elegir el enfoque adecuado

No todas las integraciones necesitan una marca blanca completa. He aquí cómo decidir:

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

Lo anterior junto con plantillas de correo electrónico personalizadas se adapta a los productos en los que se desea que las comunicaciones utilicen la propia marca sin tener que reemplazar la infraestructura de correo electrónico. Usted personaliza el contenido y el HTML de los correos electrónicos de firma, mientras que Firma.dev gestiona el envío. Esto añade una o dos horas de trabajo en las plantillas.

Lo anterior junto con el control de notificaciones es el paso adecuado cuando desea ser el único propietario de la capa de comunicación. Es posible que tenga requisitos de conformidad específicos en torno al correo electrónico o prefiera que las notificaciones de firma pasen por su sistema transaccional actual. Esto añade uno o dos días de trabajo de integración.

La experiencia incrustada completa es la opción adecuada cuando la firma es el núcleo de su producto. Plataformas de recursos humanos, herramientas de gestión de contratos, software inmobiliario, sistemas de incorporación en el sector sanitario. Si sus clientes dedican una parte importante de su tiempo a los flujos de firma, integrar esta experiencia vale la pena. Estimamos de unos días a una semana de trabajo de integración, dependiendo de cuántos componentes decida incrustar.

Consideraciones de implementación

Algunos aspectos que debe considerar antes de empezar:

1. Espacios de trabajo y sistemas multiinquilino. Si está creando un producto SaaS orientado a varios clientes, 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, personalización de marca y (opcionalmente) dominio de correo electrónico. Esto mantiene los datos perfectamente separados sin necesidad de construir la lógica de aislamiento de inquilinos por su cuenta.

2. Jerarquía de la configuración. Las configuraciones de marca en Firma.dev se aplican en cascada: el espacio de trabajo anula a la empresa, y la empresa anula los valores predeterminados. Esto significa que puede definir la marca corporativa una sola vez y configurar únicamente personalizaciones específicas a nivel de espacio de trabajo si es necesario. Ajustar el valor de un espacio de trabajo a null hereda la opción de nivel de empresa.

3. Seguridad. Genere los tokens JWT siempre en la parte del servidor, nunca en el código cliente. Mantenga una caducidad de token corta (normalmente de 1 a 4 horas). Gestione la validación de orígenes de mensajes de iframe si detecta eventos de componentes incrustados.

4. Conformidad legal. La personalización de marca blanca no cambia la validez jurídica de las firmas. Una API de firma digital bien diseñada mantiene la conformidad con las normativas ESIGN, UETA y eIDAS independientemente de los detalles visuales de la marca. Asegúrese de que su proveedor admita los marcos regulatorios relevantes para sus clientes.

5. Costes. 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 precio. Firma.dev incluye todas las capacidades de marca blanca con tarifas según el consumo a 0,049 € por sobre (~5¢ USD), sin contratos ni mínimos de consumo.

Primeros pasos

Si está evaluando API de firma de documentos para una integración de marca blanca, empiece por identificar cuáles son los puntos de contacto más importantes para sus clientes. ¿Les importa la personalización de los correos electrónicos? ¿Necesitan que el flujo de firma esté integrado? Las respuestas definirán el alcance de su implementación. Para obtener una visión estratégica más amplia de los entornos de marca única y multiinquilino, consulte la guía completa de firmas electrónicas de marca blanca para SaaS.

Para un análisis técnico detallado, la Guía de marca blanca de Firma.dev aborda dominios de correo electrónico personalizados, configuraciones de notificaciones y componentes incrustados utilizando 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.