Envía a los firmantes a una experiencia de firma localizada con un parámetro de URL

Si estás enviando contratos a firmantes en múltiples países, aquí está el camino más rápido hacia una experiencia localizada para cada uno de ellos. Añade ?lang=fr al enlace del firmante francés, ?lang=de al enlace del firmante alemán, y Firma.dev se encarga del resto. Cada pantalla que vean, desde las instrucciones y los botones hasta el texto legal, se carga en ese idioma desde la primera página. No se requiere cuenta en su parte ni configuraciones en la tuya.

Cómo funciona el parámetro ?lang=

El parámetro ?lang= puede ser añadido a cualquier enlace de Firma.dev para firmar. Obliga a que toda la experiencia de firma esté en el idioma especificado, anulando tanto la detección automática del navegador como cualquier predeterminado a nivel de espacio de trabajo. El firmante no necesita hacer nada, solo sigue el enlace y la interfaz ya está en el idioma correcto.

Los siete códigos de idioma soportados son:

Un URL estándar de firma se ve así:

https://app.firma.dev/signing/{signing_request_user_id}

https://app.firma.dev/signing/{signing_request_user_id}

https://app.firma.dev/signing/{signing_request_user_id}

Con una anulación de idioma:

https://app.firma.dev/signing/{signing_request_user_id}?lang=fr

https://app.firma.dev/signing/{signing_request_user_id}?lang=fr

https://app.firma.dev/signing/{signing_request_user_id}?lang=fr

Ese es todo el cambio. Sin llamadas API adicionales, sin modificaciones de plantillas, sin configuraciones por firmante.

Una solicitud de firma, múltiples enlaces localizados

El patrón práctico para documentos multiparte o internacionales: crea una sola solicitud de firma con los correos automatizados de Firma.dev desactivados, obten los URLs de firma para cada destinatario, luego añade el parámetro ?lang= apropiado para cada uno antes de enviar a través de tu propio sistema.

El siguiente código es de la guía de marca blanca, con ?lang= añadido según la guía de localización:

// Create signing request with emails disabled
const response = await fetch(
  'https://api.firma.dev/functions/v1/signing-request-api/signing-requests',
  {
    method: 'POST',
    headers: {
      'Authorization': API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      workspace_id: workspaceId,
      template_id: templateId,
      settings: {
        send_signing_email: false,
        send_finish_email: false
      },
      recipients: [
        { first_name: 'Jane', last_name: 'Smith', email: 'jane@example.com', designation: 'Signer', order: 1 }
      ]
    })
  }
)
const signingRequest = await response.json()

// Get signing URLs for each recipient
const usersResponse = await fetch(
  `https://api.firma.dev/functions/v1/signing-request-api/signing-requests/${signingRequest.id}/users`,
  {
    headers: { 'Authorization': API_KEY }
  }
)
const { results: users } = await usersResponse.json()

// Send emails through your own system with ?lang= appended
for (const user of users) {
  const signingUrl = `https://app.firma.dev/signing/${user.id}?lang=fr`
  await yourEmailService.send({
    to: user.email,
    subject: 'Please sign your document',
    body: `Click here to sign: ${signingUrl}`
  })
}

// Create signing request with emails disabled
const response = await fetch(
  'https://api.firma.dev/functions/v1/signing-request-api/signing-requests',
  {
    method: 'POST',
    headers: {
      'Authorization': API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      workspace_id: workspaceId,
      template_id: templateId,
      settings: {
        send_signing_email: false,
        send_finish_email: false
      },
      recipients: [
        { first_name: 'Jane', last_name: 'Smith', email: 'jane@example.com', designation: 'Signer', order: 1 }
      ]
    })
  }
)
const signingRequest = await response.json()

// Get signing URLs for each recipient
const usersResponse = await fetch(
  `https://api.firma.dev/functions/v1/signing-request-api/signing-requests/${signingRequest.id}/users`,
  {
    headers: { 'Authorization': API_KEY }
  }
)
const { results: users } = await usersResponse.json()

// Send emails through your own system with ?lang= appended
for (const user of users) {
  const signingUrl = `https://app.firma.dev/signing/${user.id}?lang=fr`
  await yourEmailService.send({
    to: user.email,
    subject: 'Please sign your document',
    body: `Click here to sign: ${signingUrl}`
  })
}

// Create signing request with emails disabled
const response = await fetch(
  'https://api.firma.dev/functions/v1/signing-request-api/signing-requests',
  {
    method: 'POST',
    headers: {
      'Authorization': API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      workspace_id: workspaceId,
      template_id: templateId,
      settings: {
        send_signing_email: false,
        send_finish_email: false
      },
      recipients: [
        { first_name: 'Jane', last_name: 'Smith', email: 'jane@example.com', designation: 'Signer', order: 1 }
      ]
    })
  }
)
const signingRequest = await response.json()

// Get signing URLs for each recipient
const usersResponse = await fetch(
  `https://api.firma.dev/functions/v1/signing-request-api/signing-requests/${signingRequest.id}/users`,
  {
    headers: { 'Authorization': API_KEY }
  }
)
const { results: users } = await usersResponse.json()

// Send emails through your own system with ?lang= appended
for (const user of users) {
  const signingUrl = `https://app.firma.dev/signing/${user.id}?lang=fr`
  await yourEmailService.send({
    to: user.email,
    subject: 'Please sign your document',
    body: `Click here to sign: ${signingUrl}`
  })
}

El documento es el mismo para todos. La experiencia de firma que cada persona ve está en su idioma. Tú manejas la construcción del enlace, Firma.dev maneja la representación. Cambia ?lang=fr por el código de idioma que coincida con cada destinatario.

Este patrón es especialmente útil cuando los correos electrónicos automatizados de Firma.dev están desactivados y estás distribuyendo enlaces de firma a través de tu propio sistema de notificación. Ya controlas la entrega, añadir el parámetro ?lang= es una adición trivial.

Fallo automático sin el parámetro

Cuando no se presenta un parámetro ?lang=, Firma.dev lee la configuración de idioma del navegador del firmante y ajusta al idioma soportado más cercano. Si su navegador está configurado en francés, verá una interfaz en francés. Si su idioma no está soportado, se predetermina a inglés.

Este retroceso funciona bien para enlaces directos donde no controlas el contexto de entrega. Pero para la firma incrustada en iframes, o cualquier escenario donde estás construyendo URLs desde el servidor, pasar ?lang= explícitamente es el enfoque más confiable. La detección de idioma del navegador dentro de un iframe puede ser inconsistente dependiendo de cómo está configurada la aplicación principal.

La recomendación de los documentos es sencilla: usa ?lang= en contextos incrustados y cuando conozcas el idioma del firmante, deje que la detección del navegador lo maneje para enlaces directos donde no lo haces.

El cuadro completo de localización

El parámetro ?lang= es una pieza del conjunto de localización de Firma.dev. Para un flujo de firma completamente localizado, los elementos encajan así:

Idioma de la experiencia de firma está controlado por ?lang= en el enlace, o por la detección del navegador como un retroceso. Esto cubre todo lo que el firmante ve durante el flujo de firma.

Correos electrónicos de notificación están controlados por el campo language en la configuración del espacio de trabajo. Establece el espacio de trabajo a francés y todos los correos electrónicos automatizados de firma se envían en francés, sin necesidad de plantillas personalizadas.

Estilos de firma se manejan automáticamente en función del nombre de cada firmante. Los nombres griegos, cirílicos, japoneses y coreanos obtienen fuentes de firma construidas para su sistema de escritura sin ninguna configuración.

Juntas estas tres capas cubren la experiencia completa: los correos electrónicos que ingresan, el flujo de firma en sí, y cómo luce la firma en el documento. La guía de localización de Firma.dev cubre los tres en detalle.

Obtén tu clave API y comienza a construir gratis, sin necesidad de tarjeta de crédito.