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

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

Cómo funciona el parámetro ?lang=

El parámetro ?lang= se puede añadir a cualquier enlace de firma de Firma.dev. Obliga a que toda la experiencia de firma esté en el idioma especificado, anulando tanto la detección automática del navegador como cualquier configuración predeterminada 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 compatibles son los siguientes:

Una 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 sobrescritura 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 adicionales a la API, sin modificaciones de plantilla, sin configuración por firmante.

Una solicitud de firma, varios enlaces localizados

El patrón práctico para documentos multipartitos o internacionales: cree una única solicitud de firma con los correos electrónicos automatizados de Firma.dev desactivados, obtenga las URLs de firma para cada destinatario, y luego agregue el parámetro ?lang= apropiado para cada uno antes de enviarlo a través de su 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. Usted maneja la construcción del enlace, Firma.dev maneja la representación. Cambie ?lang=fr por el código de idioma que corresponda a cada destinatario.

Este patrón es particularmente útil cuando los correos electrónicos automatizados de Firma.dev están desactivados y está distribuyendo enlaces de firma a través de su propio sistema de notificaciones. Usted ya controla la entrega, por lo que agregar el parámetro ?lang= es una adición trivial.

Fallback automático sin el parámetro

Cuando no hay presente un parámetro ?lang=, Firma.dev lee la configuración del idioma del navegador del firmante y lo iguala con el 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 al inglés.

Este fallback funciona bien para enlaces directos donde usted no controla el contexto de la entrega. Pero para la firma integrada en iframes, o cualquier escenario en el que esté construyendo URLs del lado del servidor, pasar explícitamente ?lang= es el enfoque más fiable. La detección del 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: use ?lang= en contextos embebidos y cuando conozca el idioma del firmante, deje que la detección del navegador lo maneje para enlaces directos donde no lo controle.

La imagen completa de la localización

El parámetro ?lang= es una pieza de la pila de localización de Firma.dev. Para un flujo de trabajo de firma totalmente localizado, las piezas se ensamblan de esta manera:

Idioma de la experiencia de firma se controla mediante ?lang= en el enlace, o por la detección del navegador como respaldo. 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. Configure el espacio de trabajo en francés y todos los correos electrónicos de firma automatizados se envían en francés, sin necesidad de una plantilla personalizada.

Estilos de firma se manejan automáticamente según el 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 entrantes, el flujo de firma en sí, y cómo se ve la firma en el documento. La guía de localización de Firma.dev cubre las tres en detalle.

Obtenga su clave API y comience a construir gratis, no se requiere tarjeta de crédito.