Guías

Actualizaciones de producto

Envía correos electrónicos de firma en 7 idiomas: Soporte de correo electrónico multilingüe de Firma.dev

Escrito por

Logotipo de Firma.dev rodeado por un icono de correo electrónico e iconos de las banderas de Francia, España, Portugal, Grecia, Reino Unido, Italia y Alemania.

Has localizado tu aplicación. Tu interfaz de usuario se muestra en francés para los usuarios franceses, en alemán para los alemanes, en portugués para los brasileños. Pero en el momento en que se envía una solicitud de firma, tu firmante recibe un correo electrónico que dice "Please review and sign this document" en inglés. Es un pequeño detalle que rompe la experiencia justo en el momento más importante.

Firma.dev ahora envía correos electrónicos de notificación de firma en 7 idiomas de forma predeterminada, sin necesidad de configurar plantillas personalizadas.

El problema de los correos electrónicos de firma solo en inglés

La mayoría de las API de firma electrónica utilizan el inglés de forma predeterminada y dejan la localización como un problema que debe resolver el desarrollador. Eso significa escribir y mantener plantillas de correo electrónico traducidas para cada idioma admitido por tu producto, para cada tipo de correo electrónico en el flujo de firma, y mantenerlas actualizadas cada vez que cambien tus textos.

Para un flujo de firma con 5 tipos de correo electrónico en 4 idiomas, son 20 plantillas para crear, probar y mantener. Y si te olvidas de una, un firmante en Lyon o Lisboa recibe un correo electrónico del sistema en un idioma que no ha elegido.

Más allá de la carga de mantenimiento, hay una dimensión de confianza. Un correo electrónico de firma que no coincide con el idioma de la interfaz del firmante parece un error, incluso si el documento en sí es correcto. Para contratos de gran valor, esa fricción importa.

Cómo funciona el soporte de idiomas de Firma.dev

Firma.dev añadió un campo language a la configuración de Empresa y de Espacio de trabajo. Cuando se establece, la plataforma utiliza plantillas localizadas integradas para los 5 tipos de correos electrónicos de notificación de firma: signing_invite, next_signer, signing_expired, signing_cancelled y signing_declined.

Los 7 idiomas admitidos son:

Código

Idioma

es

Inglés (predeterminado)

es

Español

it

Italiano

pt

Portugués

fr

Francés

de

Alemán

el

Griego

La configuración de idioma se aplica en cascada de la misma manera que las plantillas de correo electrónico: el nivel de solicitud de firma tiene prioridad, luego el espacio de trabajo y, a continuación, la empresa. Configúralo una vez a nivel de empresa y cada espacio de trabajo lo heredará, o anúlalo por espacio de trabajo para un control más granular.

Una aclaración importante: el campo language solo afecta a las plantillas predeterminadas integradas. Si un espacio de trabajo tiene una plantilla de correo electrónico personalizada configurada para un tipo de correo determinado, se utiliza esa plantilla personalizada independientemente de la configuración de idioma. El campo de idioma es la capa de reserva, no una anulación.

Configuración de un idioma por espacio de trabajo

Si estás utilizando el modelo de espacio de trabajo de cliente de Firma.dev, cada espacio de trabajo puede tener su propio idioma. Un cliente francés recibe correos electrónicos en francés, un cliente alemán recibe correos electrónicos en alemán, todo desde la misma integración sin ninguna gestión de plantillas.

Establecer el idioma a nivel de espacio de trabajo es una única llamada PATCH:

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

Y a nivel de empresa, para establecer el valor predeterminado para todos los espacios de trabajo:

curl -X PATCH https://api.firma.dev/functions/v1/signing-request-api/company \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "language": "es" }'
curl -X PATCH https://api.firma.dev/functions/v1/signing-request-api/company \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "language": "es" }'
curl -X PATCH https://api.firma.dev/functions/v1/signing-request-api/company \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "language": "es" }'

Eso es todo. Sin creación de plantillas, sin trabajo de traducción, sin sobrecarga de mantenimiento.

Uso de los valores predeterminados como punto de partida

Para los equipos que desean localización más una ligera personalización de marca, el endpoint GET /email-templates/defaults/{language} devuelve la plantilla integrada completa para cualquier idioma admitido. Descárgala, ajusta el texto o añade el estilo HTML de tu marca y guárdala como una plantilla de espacio de trabajo personalizada usando PUT /workspace/{workspace_id}/email-templates/{email_type}.

Este patrón ofrece lo mejor de ambos mundos: no escribes traducciones desde cero y sigues controlando el aspecto y el tono de los correos electrónicos. Para la mayoría de los productos SaaS, este es el enfoque correcto una vez que hayas comprobado que los valores predeterminados integrados se leen con naturalidad para tu mercado. Ambos endpoints están documentados en el registro de cambios de la API.

Qué significa esto para los creadores de SaaS internacionales

Crear un flujo de firma para un producto global solía significar aceptar correos electrónicos solo en inglés o encargarse uno mismo de la capa de traducción. Con 7 idiomas gestionados ahora a nivel de plataforma, esa ya no es una concesión que debas hacer.

En combinación con la interfaz de usuario de firma integrada de Firma.dev, que también se adapta al idioma del firmante, ahora puedes ofrecer una experiencia de firma totalmente localizada, desde el correo electrónico de invitación hasta la confirmación final, sin escribir una sola línea de código de traducción.

A 0,049 € por sobre (o unos 5 centavos de USD) sin mínimos mensuales, no pagas más por la cobertura internacional. Viene incluida con la API.

Empieza a usar 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.