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

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

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

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

A maioria das APIs de assinatura eletrónica assume o inglês por predefinição e deixa a localização como um problema a ser resolvido pelo programador. 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 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 de sistema num idioma que não escolheu.

Além do encargo de manutenção, existe uma questã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 alto valor, esse atrito faz a diferença.

Como Funciona o Suporte de Idiomas da Firma.dev

A Firma.dev adicionou um campo language às definições da Empresa e do Espaço de Trabalho (Workspace). Quando 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:

A definição do idioma funciona em cascata da mesma forma que os modelos de e-mail: o nível do pedido de assinatura tem precedência, seguido pelo espaço de trabalho e, por fim, pela empresa. Configure-o uma vez ao nível da empresa para que todos os espaços de trabalho o herdem, ou substitua 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 funciona como uma camada de recurso (fallback), não como uma substituição obrigatória.

Definir um Idioma por Espaço de Trabalho

Se estiver a utilizar o modelo de espaços de trabalho de clientes 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 requer apenas uma 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 o padrã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 tarefas de tradução, sem sobrecarga de manutenção.

Utilizar as Predefinições como Ponto de Partida

Para equipas que pretendem localização associada a uma leve personalização de marca, o endpoint GET /email-templates/defaults/{language} devolve o modelo integrado completo para qualquer idioma suportado. Basta obtê-lo, ajustar o texto ou adicionar o estilo HTML da sua marca e guardá-lo como um modelo personalizado do espaço de trabalho através de PUT /workspace/{workspace_id}/email-templates/{email_type}.

Este padrão oferece o melhor de dois mundos: não cria 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 no seu mercado. Ambos os endpoints estão documentados no registo de alterações da API.

O Que Isto Significa para Criadores de SaaS Internacionais

Criar um fluxo de assinatura para um produto global significava anteriormente aceitar e-mails exclusivamente em inglês ou gerir a camada de tradução por conta própria. Com 7 idiomas agora suportados diretamente na plataforma, já não tem de fazer essa concessão.

Combinado com a IU de assinatura incorporada da Firma.dev, que também se adapta ao idioma do signatário, pode agora oferecer 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 valores mínimos mensais, não paga mais pela cobertura internacional. Já vem incluída na API.

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