Guias

Atualizações de Produtos

Envie Emails de Assinatura em 7 Línguas: Suporte de Email Multilíngue da Firma.dev

"Logótipo da Firma.dev centrado, rodeado por bandeiras: França, Reino Unido, Alemanha, implicando alcance internacional."

Localizou a sua aplicação. A sua interface é apresentada em francês para os utilizadores franceses, em alemão para os utilizadores alemães, em português para os utilizadores brasileiros. Mas no momento em que é feito um pedido de assinatura, o seu signatário recebe um e-mail em inglês que diz "Please review and sign this document". É um pequeno pormenor que estraga a experiência precisamente no momento mais importante.

A Firma.dev envia agora e-mails de notificação de assinatura em 7 idiomas de forma integrada, sem necessidade de configuração de modelos personalizados.

O Problema dos E-mails de Assinatura Apenas em Inglês

A maior parte das APIs de assinatura eletrónica predefinem o inglês e deixam a localização como um problema para o programador resolver. Isso significa escrever e manter modelos de e-mail traduzidos para cada idioma suportado pelo seu produto, para cada tipo de e-mail no fluxo de trabalho de assinatura, e mantê-los atualizados sempre que o seu texto for alterado.

Para um fluxo de assinatura com 5 tipos de e-mail em 4 idiomas, são 20 modelos para criar, testar e manter. E se se esquecer de um, um signatário em Lyon ou Lisboa recebe um e-mail do sistema num idioma que não escolheu.

Para além do fardo da manutenção, existe uma dimensão de confiança. Um e-mail de assinatura que não corresponda ao idioma da interface do signatário parece um erro, mesmo que o documento em si esteja correto. Para contratos de elevado valor, esse atrito é importante.

Como Funciona o Suporte de Idiomas da Firma.dev

A Firma.dev adicionou um campo language às definições de Empresa (Company) e de Espaço de Trabalho (Workspace). Quando este campo é definido, a plataforma utiliza modelos localizados integrados para todos os 5 tipos de e-mail de notificação de assinatura: signing_invite, next_signer, signing_expired, signing_cancelled e signing_declined.

Os 7 idiomas suportados são:

Código

Idioma

pt

Inglês (predefinido)

es

Espanhol

it

Italiano

pt

Português

fr

Francês

de

Alemão

el

Grego

A definição de idioma propaga-se da mesma forma que os modelos de e-mail: o nível do pedido de assinatura tem precedência, seguido do espaço de trabalho e, por fim, da empresa. Defina-o uma vez ao nível da empresa e todos os espaços de trabalho o herdarão, ou substitua-o por espaço de trabalho para um controlo mais granular.

Um esclarecimento importante: o campo language apenas afeta os modelos predefinidos integrados. Se um espaço de trabalho tiver um modelo de e-mail personalizado configurado para um determinado tipo de e-mail, esse modelo personalizado será utilizado independentemente da definição de idioma. O campo de idioma é a camada de recurso (fallback), não uma sobreposição.

Definir um Idioma por Espaço de Trabalho

Se estiver a utilizar o modelo de espaço de trabalho de cliente da Firma.dev, cada espaço de trabalho pode ter o seu próprio idioma. Um cliente francês recebe e-mails em francês, um cliente alemão recebe e-mails em alemão, tudo a partir da mesma integração sem qualquer gestão de modelos.

Definir o idioma ao nível do espaço de trabalho é uma única chamada 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" }'

E ao nível da empresa, para definir a predefinição para todos os espaços de trabalho:

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" }'

E já está. Sem criação de modelos, sem trabalho de tradução, sem custos de manutenção.

Utilizar as Predefinições como Ponto de Partida

Para as equipas que pretendem localização e uma ligeira personalização da marca, o ponto de extremidade GET /email-templates/defaults/{language} devolve o modelo integrado completo para qualquer idioma suportado. Obtenha-o, ajuste o texto ou adicione a estilização HTML da sua marca, e guarde-o como um modelo de espaço de trabalho personalizado utilizando PUT /workspace/{workspace_id}/email-templates/{email_type}.

Este padrão oferece-lhe o melhor de dois mundos: não escreve traduções do zero e continua a controlar o aspeto e o tom dos e-mails. Para a maioria dos produtos SaaS, esta é a abordagem correta assim que validar que as predefinições integradas soam naturais para o seu mercado. Ambos os pontos de extremidade estão documentados no registo de alterações da API.

O Que Isto Significa para Criadores de SaaS Internacionais

Criar um fluxo de trabalho de assinatura para um produto global costumava significar aceitar e-mails apenas em inglês ou gerir a camada de tradução por si próprio. Com 7 idiomas agora tratados ao nível da plataforma, essa já não é uma escolha que tenha de fazer.

Combinado com a interface de assinatura incorporada da Firma.dev, que também se localiza no idioma do signatário, pode agora proporcionar uma experiência de assinatura totalmente localizada desde o e-mail de convite até à confirmação final, sem escrever uma única linha de código de tradução.

A $0.049 por envelope (ou cerca de 5 cêntimos de USD) sem mínimos mensais, não está a pagar mais pela cobertura internacional. Está incluído na API.

Comece a utilizar a Firma.dev gratuitamente, sem necessidade de cartão de crédito.

  1. Cabeçalho

Artigos relacionados

A nossa plataforma foi projetada para capacitar empresas de todos os tamanhos a trabalhar de forma mais inteligente e alcançar seus objetivos com confiança.

Imagem de Fundo

Pronto para adicionar assinaturas eletrónicas à sua aplicação?

Comece gratuitamente. Não é necessário cartão de crédito. Pague apenas 0,049 € por envelope quando estiver pronto para começar.

Imagem de Fundo

Pronto para adicionar assinaturas eletrónicas à sua aplicação?

Comece gratuitamente. Não é necessário cartão de crédito. Pague apenas 0,049 € por envelope quando estiver pronto para começar.

Imagem de Fundo

Pronto para adicionar assinaturas eletrónicas à sua aplicação?

Comece gratuitamente. Não é necessário cartão de crédito. Pague apenas 0,049 € por envelope quando estiver pronto para começar.