Guías

Actualizaciones de producto

Etiquetas de botones personalizables en la vista de firma

Editor interactivo de etiquetas de botones con el cursor flotando sobre él.

La pantalla de firma es la página más visible que cualquiera de sus firmantes verá, y hasta ahora los botones en ella decían exactamente lo que Firma.dev traía por defecto. A partir del 2026-06-24 esto cambia. Los administradores de los espacios de trabajo pueden personalizar las etiquetas de los botones de la vista de firma, por idioma, en los nueve idiomas admitidos. Si en su producto se llama "Aprobar" en lugar de "Firmar", el botón puede decir Aprobar.

Esta es una función de marca blanca. Funciona de manera conjunta con los dominios de correo electrónico personalizados, el control de notificaciones y la firma integrada como otro nivel de control sobre lo que realmente ven sus firmantes. Para tener una perspectiva completa, consulte la guía completa para crear una API de firma electrónica de marca blanca.

Novedades incorporadas

Los administradores de los espacios de trabajo ahora pueden anular las etiquetas de los botones predeterminadas en la vista de firma. Estas personalizaciones se encuentran en la configuración del espacio de trabajo y se aplican a los botones con los que interactúa un firmante a medida que avanza por un documento, incluidos la acción de firma principal, el botón que avanza al siguiente campo requerido y la acción de finalizar que completa la firma.

Las etiquetas se almacenan como signing_button_label_overrides, un objeto JSON indexado primero por idioma y luego por clave de botón. Nada cambia respecto a la lógica de la firma. Solo cambia el texto que leen sus firmantes.

Por qué es importante el texto de los botones en un flujo de marca blanca

Al utilizar la experiencia de firma de marca blanca, usted controla el logotipo, los colores, el dominio de correo electrónico y la dirección del remitente. Pero luego, el firmante llega a la pantalla de firma real y pulsa un botón etiquetado con un texto genérico que no coincide con nada más en su producto. Ese único desajuste es suficiente para recordarle que ha salido de su aplicación.

El texto de los botones es un elemento pequeño con un efecto desmesurado en la naturalidad del flujo. Adaptarlo a su propia terminología cierra una de las últimas brechas visibles entre su producto y el motor de firma subyacente.

Personalizaciones por idioma

Las personalizaciones se configuran por idioma y se aplican a los nueve idiomas compatibles: inglés, español, italiano, portugués, francés, alemán, griego, ruso y polaco. Un firmante que visualice el flujo en francés verá sus etiquetas personalizadas en francés. Un firmante en alemán verá sus etiquetas personalizadas en alemán. Usted configura cada idioma de manera independiente, por lo que puede modificar solo los idiomas que admita activamente y dejar el resto con los valores predeterminados de Firma.dev.

Esto se complementa de forma natural con las firmas multiidioma. Si ya localiza el flujo de firma, las etiquetas de botón personalizadas le permiten transmitir su propia voz a través de cada idioma que ofrece en lugar de aceptar la traducción predeterminada.

Cómo funciona

Configure las personalizaciones a través del endpoint de configuración del espacio de trabajo. El campo signing_button_label_overrides recibe un objeto indexado por código de idioma y luego por clave de botón:

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": {
      "en": {
        "sign": "Approve and Sign",
        "next": "Continue",
        "finish": "Complete Signing"
      },
      "es": {
        "sign": "Aprobar y Firmar",
        "next": "Continuar",
        "finish": "Completar Firma"
      }
    }
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": {
      "en": {
        "sign": "Approve and Sign",
        "next": "Continue",
        "finish": "Complete Signing"
      },
      "es": {
        "sign": "Aprobar y Firmar",
        "next": "Continuar",
        "finish": "Completar Firma"
      }
    }
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": {
      "en": {
        "sign": "Approve and Sign",
        "next": "Continue",
        "finish": "Complete Signing"
      },
      "es": {
        "sign": "Aprobar y Firmar",
        "next": "Continuar",
        "finish": "Completar Firma"
      }
    }
  }'

Los firmantes verán las etiquetas personalizadas de inmediato. Para volver a los valores predeterminados de Firma.dev, establezca el campo en null:

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": null
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": null
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": null
  }'

Algunas reglas de validación que vale la pena conocer antes de configurar los valores. Cada etiqueta debe ser una cadena de texto de 500 caracteres o menos, los códigos de idioma deben ser válidos y las etiquetas HTML o caracteres de control se eliminan automáticamente. Un aspecto a tener en cuenta para configuraciones multiinquilino: las personalizaciones de etiquetas de botones solo se aplican a nivel de espacio de trabajo, por lo que si utiliza un espacio de trabajo independiente por cliente, cada uno tendrá sus propias etiquetas. No existe una opción de personalización a nivel de organización que se aplique en cascada.

Para consultar la referencia completa, incluida cada una de las claves de botón disponibles, consulte la guía de marca blanca en la documentación.

Comenzar

Las etiquetas de botones personalizadas ya están disponibles en todos los espacios de trabajo, con las mismas tarifas de pago por uso que todo lo demás: 0,029 € por sobre (aproximadamente 3¢ de USD), sin mínimos mensuales.

Comience a utilizar Firma.dev de forma gratuita, sin necesidad de tarjeta de crédito.

  1. Encabezado

Artículos relacionados

Nuestra plataforma está diseñada para capacitar a las empresas de todos los tamaños para trabajar de manera más inteligente y alcanzar sus objetivos con confianza.

Imagen de fondo

¿Listo para añadir firmas electrónicas a tu aplicación?

Comienza gratis. No se requiere tarjeta de crédito. Paga solo 0,029 € por sobre cuando estés listo para ponerlo en marcha.

Imagen de fondo

¿Listo para añadir firmas electrónicas a tu aplicación?

Comienza gratis. No se requiere tarjeta de crédito. Paga solo 0,029 € por sobre cuando estés listo para ponerlo en marcha.

Imagen de fondo

¿Listo para añadir firmas electrónicas a tu aplicación?

Comienza gratis. No se requiere tarjeta de crédito. Paga solo 0,029 € por sobre cuando estés listo para ponerlo en marcha.