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 individual más visible que verá cualquiera de sus firmantes y, hasta ahora, los botones que aparecían en ella se leían exactamente de la forma en que Firma.dev los enviaba. 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 sitúa junto a 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 ver el panorama completo, consulte la guía completa para crear una API de firma electrónica de marca blanca.

Novedades

Los administradores del espacio de trabajo ahora pueden anular las etiquetas de los botones predeterminadas en la vista de firma. Las anulaciones residen 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, incluida la acción de firma principal, 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 estructurado 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

Cuando personaliza la experiencia de firma con marca blanca, controla el logotipo, los colores, el dominio de correo electrónico y la dirección de envío. 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. Esa única discrepancia es suficiente para recordarles que han salido de su aplicación.

El texto del botón es una superficie pequeña con un efecto desmesurado en la sensación de que el flujo es nativo. Adaptarlo a su propia terminología cierra uno de los últimos huecos visibles entre su producto y el motor de firma subyacente.

Anulaciones por idioma

Las anulaciones se configuran 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. Usted configura cada idioma de forma independiente, por lo que puede anular solo los idiomas que admite activamente y dejar el resto con los valores predeterminados de Firma.dev.

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

Cómo funciona

Establezca las anulaciones a través del endpoint de configuración del espacio de trabajo. El campo signing_button_label_overrides toma un objeto cuya clave es el código de idioma y luego la clave del 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 vale la pena conocer antes de establecer 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 cualquier etiqueta HTML o carácter de control se elimina automáticamente. Una cosa a tener en cuenta para las configuraciones multiinquilino (multi-tenant): las anulaciones de las etiquetas de los botones son una configuración que solo se aplica a nivel de espacio de trabajo, por lo que si tiene un espacio de trabajo separado por cliente, cada uno llevará sus propias etiquetas. No existe una anulación a nivel de empresa que se aplique en cascada.

Para obtener 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 el mismo modelo de precios de pago por uso que todo lo demás: 0,049 € por sobre (aproximadamente 5 centavos de USD de dólar), sin mínimos mensuales.

Comience a usar Firma.dev gratis, sin necesidad de tarjeta de crédito.

  1. Encabezado

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.