Guias
Atualizações de Produtos
Rótulos de Botões Personalizáveis na Vista de Assinatura
O ecrã de assinatura é a página individual mais visível que qualquer um dos seus signatários irá ver, e até agora os botões nela continham exatamente o texto definido pela Firma.dev. A partir de 24-06-2026, isso muda. Os administradores do espaço de trabalho podem substituir as etiquetas dos botões da vista de assinatura, por idioma, em todos os nove idiomas suportados. Se o seu produto lhe chama "Aprovar" em vez de "Assinar", o botão pode dizer Aprovar.
Esta é uma funcionalidade white-label. Enquadra-se juntamente com os domínios de e-mail personalizados, o controlo de notificações e a assinatura incorporada como mais um nível de controlo sobre o que os seus signatários realmente veem. Para obter uma visão global, consulte o guia completo para construir uma API de assinatura eletrónica white-label.
O que foi lançado
Os administradores do espaço de trabalho podem agora substituir as etiquetas padrão dos botões na vista de assinatura. As substituições residem nas definições do espaço de trabalho e aplicam-se aos botões com os quais um signatário interage à medida que avança num documento, incluindo a ação principal de assinatura, o botão que avança para o próximo campo obrigatório e a ação de finalização que conclui a assinatura.
As etiquetas são armazenadas como signing_button_label_overrides, um objeto JSON indexado primeiro por idioma e depois pela chave do botão. Nada muda na lógica de assinatura. Apenas o texto que os seus signatários leem.
Porque é que o texto dos botões é importante num fluxo white-label
Quando personaliza a experiência de assinatura com white-label, controla o logótipo, as cores, o domínio de e-mail e o endereço de envio. Depois, o signatário chega ao ecrã de assinatura real e depara-se com um botão com um texto genérico que não condiz com mais nada no seu produto. Essa única discrepância é suficiente para o lembrar de que saiu da sua aplicação.
O texto do botão é uma superfície pequena com um efeito desmesurado no quão nativo o fluxo parece. Adequá-lo à sua própria terminologia fecha uma das últimas lacunas visíveis entre o seu produto e o motor de assinatura subjacente.
Substituições por idioma
As substituições são definidas por idioma e aplicam-se a todos os nove idiomas suportados: inglês, espanhol, italiano, português, francês, alemão, grego, russo e polaco. Um signatário que visualize o fluxo em francês verá as suas etiquetas francesas personalizadas. Um signatário em alemão verá as suas etiquetas alemãs personalizadas. Define cada idioma de forma independente, pelo que pode substituir apenas os idiomas que apoia ativamente e deixar os restantes com os valores padrão da Firma.dev.
Isto combina perfeitamente com assinaturas multi-idioma. Se já localiza o fluxo de assinatura, as etiquetas de botão personalizadas permitem-lhe manter a sua própria voz em todos os idiomas que disponibiliza, em vez de aceitar a tradução padrão.
Como funciona
Defina as substituições através do endpoint de definições do espaço de trabalho. O campo signing_button_label_overrides aceita um objeto indexado pelo código do idioma e depois pela chave do botão:
Os signatários veem as etiquetas personalizadas imediatamente. Para reverter para os valores padrão da Firma.dev, defina o campo como null:
Algumas regras de validação que vale a pena conhecer antes de definir os valores. Cada etiqueta deve ser uma string de 500 caracteres ou menos, as chaves de idioma devem ser códigos de idioma válidos e quaisquer tags HTML ou caracteres de controlo são removidos automaticamente. Algo a ter em conta para configurações multi-tenant: as substituições de etiquetas de botão são uma definição apenas ao nível do espaço de trabalho, por isso, se tiver um espaço de trabalho separado por cliente, cada um terá as suas próprias etiquetas. Não existe uma substituição ao nível da empresa que se aplique em cascata.
Para consultar a referência completa, incluindo todas as chaves de botão disponíveis, consulte o guia de white-labeling na documentação.
Comece a utilizar
As etiquetas de botão personalizadas estão agora disponíveis em todos os espaços de trabalho, com o mesmo modelo de preços pré-pago: 0,029 € por envelope (cerca de 3¢ USD), sem mínimos mensais.
Comece a utilizar a Firma.dev gratuitamente, sem necessidade de cartão de crédito.
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.
