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

Localizaste a tua aplicação. A tua interface aparece em francês para os utilizadores franceses, alemão para utilizadores alemães, português para utilizadores brasileiros. Mas no momento em que um pedido de assinatura é enviado, o assinante recebe um email que diz "Por favor, reveja e assine este documento" em inglês. É uma pequena coisa que quebra a experiência exatamente no momento em que mais importa.

A Firma.dev agora envia notificações de assinatura por email em 7 idiomas, sem necessidade de configuração de templates personalizados.

O Problema Com Emails de Assinatura Apenas em Inglês

A maioria das APIs de assinatura eletrónica tem o inglês como padrão e deixa a localização como um problema para o programador resolver. Isso significa escrever e manter templates de email traduzidos para cada idioma que o teu produto suporta, para cada tipo de email no fluxo de assinatura, e mantê-los atualizados sempre que o texto muda.

Para um fluxo de assinatura com 5 tipos de email em 4 idiomas, são 20 templates para criar, testar e manter. E se falhares um, um assinante em Lyon ou Lisboa recebe um email do sistema num idioma que não escolheu.

Além do fardo da manutenção, existe uma dimensão de confiança. Um email de assinatura que não corresponde ao idioma da interface do assinante parece um erro, mesmo que o documento em si esteja correto. Para contratos de alto valor, essa fricção importa.

Como Funciona o Suporte de Idiomas da Firma.dev

A Firma.dev adicionou um campo language para as configurações de Empresa e Espaço de Trabalho. Quando está definido, a plataforma usa templates localizados incorporados para todos os 5 tipos de emails de notificação de assinatura: signing_invite, next_signer, signing_expired, signing_cancelled, e signing_declined.

Os 7 idiomas suportados são:

A configuração de idioma é aplicada da mesma forma que os templates de email: o nível de pedido de assinatura tem precedência, depois o espaço de trabalho, depois a empresa. Define-a uma vez ao nível da empresa e todos os espaços de trabalho a herdam, ou substitui por espaço de trabalho para um controlo mais granular.

Uma clarificação importante: o campo language afeta apenas os templates padrão integrados. Se um espaço de trabalho tiver um template de email personalizado configurado para um determinado tipo de email, esse template personalizado será usado independentemente da configuração de idioma. O campo de idioma é a camada de fallback, não uma substituição.

Definindo um Idioma por Espaço de Trabalho

Se estás a usar o modelo de espaço de cliente da Firma.dev, cada espaço de trabalho pode ter o seu próprio idioma. Um cliente francês recebe emails em francês, um cliente alemão recebe emails em alemão, tudo a partir da mesma integração sem qualquer gestão de templates.

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

É isso mesmo. Sem criação de templates, sem trabalho de tradução, sem sobrecarga de manutenção.

Usando os Padrões como Ponto de Partida

Para as equipas que querem localização mais personalização leve de marca, o endpoint GET /email-templates/defaults/{language} retorna o template completo incorporado para qualquer idioma suportado. Puxa-o, ajusta o texto ou adiciona o estilo HTML da tua marca e guarda-o como um template de espaço de trabalho personalizado usando PUT /workspace/{workspace_id}/email-templates/{email_type}.

Este padrão dá-te o melhor dos dois mundos: não escreves traduções do zero e ainda controlas a aparência e o som dos emails. Para a maioria dos produtos SaaS, esta é a abordagem certa depois de validar que os padrões incorporados são naturalmente lidos para o teu mercado. Ambos os endpoints estão documentados na changelog da API.

O Que Isto Significa para Construtores SaaS Internacionais

Construir um fluxo de assinatura para um produto global costumava significar aceitar emails apenas em inglês ou assumir o nível de tradução por ti mesmo. Com 7 idiomas agora tratados ao nível da plataforma, essa troca já não é necessária.

Combinado com a UI de assinatura incorporada da Firma.dev, que também se localiza para o idioma do assinante, agora podes entregar uma experiência de assinatura totalmente localizada desde o email de convite até à confirmação final, sem escrever uma única linha de código de tradução.

Por $0.029 por envelope (ou cerca de 3 cêntimos USD) sem mínimos mensais, não estás a pagar extra por cobertura internacional. É fornecido com a API.

Começa com a Firma.dev gratuitamente, sem necessidade de cartão de crédito.