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."

Você localizou sua app. Sua interface de utilizador renderiza em francês para utilizadores franceses, alemão para utilizadores alemães, português para utilizadores brasileiros. Mas no momento em que uma solicitação de assinatura é enviada, seu assinante recebe um email que diz "Please review and sign this document" em inglês. É uma pequena coisa que quebra a experiência justamente quando mais importa.

Firma.dev agora envia emails de notificação de assinatura em 7 idiomas prontos para uso, sem necessidade de configuração de modelo personalizado.

O Problema Com Emails de Assinatura Apenas em Inglês

A maioria das APIs de assinatura eletrônica padrão são em inglês e deixam a localização como um problema para o desenvolvedor resolver. Isso significa escrever e manter modelos de email traduzidos para cada idioma que seu produto suporta, para cada tipo de email no fluxo de assinatura, e mantê-los atualizados sempre que o seu texto muda.

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

Além do ônus de manutenção, há 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, esse atrito importa.

Como Funciona o Suporte de Idiomas do Firma.dev

Firma.dev adicionou um campo language tanto às configurações da Empresa quanto do Espaço de Trabalho. Quando configurado, a plataforma usa modelos 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:

Código

Idioma

pt

Inglês (padrão)

es

Espanhol

it

Italiano

pt

Português

fr

Francês

de

Alemão

el

Grego

A configuração de idioma se propaga da mesma forma que os modelos de email: o nível de solicitação de assinatura tem precedência, depois espaço de trabalho, e por último empresa. Configurá-lo uma vez no nível da empresa faz com que cada espaço de trabalho o herde, ou pode ser substituído por espaço de trabalho para um controle mais granular.

Uma importante clarificação: o campo language afeta apenas modelos padrão integrados. Se um espaço de trabalho possui um modelo de email personalizado configurado para um determinado tipo de email, esse modelo personalizado é 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 você está usando o modelo de espaço de trabalho do cliente da Firma.dev, cada espaço de trabalho pode ter 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 modelos.

Definir o idioma no 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 no 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. Sem criação de modelos, sem trabalho de tradução, sem sobrecarga de manutenção.

Usando os Padrões Como Ponto de Partida

Para equipes que querem localização mais personalização leve de marca, o ponto endpoint GET /email-templates/defaults/{language} retorna o modelo completo incorporado para qualquer idioma suportado. Puxe-o, ajuste o texto ou adicione o estilo HTML da sua marca, e salve-o como um modelo de espaço de trabalho personalizado usando PUT /workspace/{workspace_id}/email-templates/{email_type}.

Esse padrão oferece o melhor dos dois mundos: você não escreve traduções do zero e ainda controla como os emails parecem e soam. Para a maioria dos produtos SaaS, essa é a abordagem certa assim que você valida que os padrões integrados soam naturalmente para seu mercado. Ambos os endpoints estão documentados no changelog da API.

O Que Isso Significa Para Construtores de SaaS Internacionais

Construir um fluxo de assinatura para um produto global costumava significar aceitar emails apenas em inglês ou assumir a camada de tradução você mesmo. Com 7 idiomas agora tratados ao nível da plataforma, isso não é mais uma troca que você precisa fazer.

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

A $0.029 por envelope (ou cerca de 3 centavos USD) sem mínimos mensais, você não paga extra pela cobertura internacional. Ele vem junto com a API.

Comece com 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,029 por envelope quando estiver pronto para começar ao vivo.

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,029 por envelope quando estiver pronto para começar ao vivo.

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,029 por envelope quando estiver pronto para começar ao vivo.