Actualizaciones de producto

Etiquetas de botones personalizables en la vista de firma

Escrito por

Botón morado con el texto «Etiqueta del botón» seleccionado y controles de cambio de tamaño, con un cursor editándolo, lo que representa una interfaz de usuario personalizable.

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

Esta es una función de marca blanca. Se suma a los dominios de correo electrónico personalizados, el control de notificaciones y la firma integrada como otra capa de control sobre lo que realmente ven sus firmantes. Para obtener una visión completa, consulte la guía completa para crear una API de firma electrónica de marca blanca.

Novedades incorporadas

Los administradores del espacio de trabajo ahora pueden anular las etiquetas de botones predeterminadas en la vista de firma. Las modificaciones se configuran en los ajustes del espacio de trabajo y se aplican a los botones con los que interactúa un firmante a medida que avanza por un documento, incluida la acción principal de firma, el botón que avanza al siguiente campo obligatorio y la acción de finalización que completa la firma.

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

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

Al aplicar marca blanca a la experiencia de firma, usted controla el logotipo, los colores, el dominio de correo electrónico y la dirección de envío. Pero luego, el firmante llega a la pantalla de firma real y se encuentra con un botón con un texto genérico que no coincide con nada de su producto. Esa sola discrepancia basta para recordarle que ha salido de su aplicación.

El texto de los botones es una superficie pequeña con un impacto enorme en lo nativo que se siente el flujo. Adaptarlo a su propia terminología cierra una de las últimas brechas visibles entre su producto y el motor de firma subyacente.

Modificaciones por idioma

Las modificaciones se establecen por idioma y se aplican a los nueve idiomas admitidos: inglés, español, italiano, portugués, francés, alemán, griego, ruso y polaco. Un firmante que vea el flujo en francés verá sus etiquetas personalizadas en francés. Un firmante en alemán verá sus etiquetas personalizadas en alemán. Cada idioma se configura de forma independiente, por lo que puede modificar únicamente los idiomas a los que da soporte 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 botones personalizadas le permiten transmitir su propia voz en cada idioma que ofrece en lugar de aceptar la traducción predeterminada.

Cómo funciona

Configure las modificaciones mediante el endpoint de ajustes del espacio de trabajo. El campo signing_button_label_overrides admite un objeto indexado por código de idioma y, a continuación, 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 ven 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 conviene conocer antes de definir los valores: cada etiqueta debe ser una cadena de 500 caracteres o menos, las claves de idioma deben ser códigos de idioma válidos y las etiquetas HTML o caracteres de control se eliminan automáticamente. Un aspecto a tener en cuenta para configuraciones multiinquilino: las modificaciones de las etiquetas de botones son solo un ajuste a nivel de espacio de trabajo, por lo que si gestiona un espacio de trabajo independiente por cliente, cada uno tendrá sus propias etiquetas. No hay ninguna modificación a nivel de empresa 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.

Primeros pasos

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

Comience a utilizar Firma.dev gratis, 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,049 € por sobre cuando estés listo para empezar.

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,049 € por sobre cuando estés listo para empezar.

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,049 € por sobre cuando estés listo para empezar.