Atualizações de Produtos

Rótulos de Botões Personalizáveis na Vista de Assinatura

Escrito por

Botão roxo com o texto "Etiqueta do botão" selecionado e alças de redimensionamento, com um cursor a editá-lo, representando uma IU personalizável.

O ecrã de assinatura é a página mais visível que qualquer um dos seus signatários verá e, até agora, os botões nela continham exatamente o texto predefinido pela Firma.dev. A partir de 2026-06-24, isso muda. Os administradores de workspace podem substituir os rótulos dos botões na visualização de assinatura, por idioma, em todos os nove idiomas suportados. Se o seu produto utiliza "Aprovar" em vez de "Assinar", o botão pode dizer Aprovar.

Esta é uma funcionalidade white-label. Encontra-se a par de domínios de e-mail personalizados, controlo de notificações e assinatura incorporada como mais uma camada de controlo sobre o que os seus signatários realmente veem. Para ver o panorama completo, consulte o guia completo para construir uma API de assinatura eletrónica white-label.

O que foi lançado

Os administradores de workspace podem agora substituir os rótulos de botão predefinidos na visualização de assinatura. As substituições residem nas definições do workspace 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 assinar, o botão que avança para o campo obrigatório seguinte e a ação de conclusão que finaliza a assinatura.

Os rótulos são guardados como signing_button_label_overrides, um objeto JSON indexado primeiro por idioma e depois por chave do botão. Nada muda na lógica de assinatura. Apenas o texto que os seus signatários leem.

Por que razão o texto dos botões é importante num fluxo white-label

Quando aplica o white-label à experiência de assinatura, controla o logótipo, as cores, o domínio de e-mail e o endereço de envio. Depois, um signatário chega ao ecrã de assinatura propriamente dito e depara-se com um botão com um texto genérico que não corresponde a nada no seu produto. Essa simples discrepância é suficiente para lhe lembrar que saiu da sua aplicação.

O texto dos botões é uma superfície pequena com um efeito desproporcionado na sensação de integração nativa do fluxo. Alinhá-lo com a sua própria terminologia elimina 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 aos 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 vê os seus rótulos personalizados em francês. Um signatário em alemão vê os seus rótulos personalizados em alemão. Define cada idioma de forma independente, pelo que pode substituir apenas os idiomas que suporta ativamente e manter os restantes com os valores predefinidos da Firma.dev.

Isto combina naturalmente com as assinaturas multi-idioma. Se já localiza o fluxo de assinatura, os rótulos de botão personalizados permitem-lhe manter a sua própria voz em cada idioma que suporta, em vez de aceitar a tradução predefinida.

Como funciona

Configure as substituições através do endpoint de definições do workspace. O campo signing_button_label_overrides aceita um objeto indexado pelo código do idioma e, em seguida, pela chave do botão:

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": {
      "en": {
        "sign": "Approve and Sign",
        "next": "Continue",
        "finish": "Complete Signing"
      },
      "es": {
        "sign": "Aprobar y Firmar",
        "next": "Continuar",
        "finish": "Completar Firma"
      }
    }
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": {
      "en": {
        "sign": "Approve and Sign",
        "next": "Continue",
        "finish": "Complete Signing"
      },
      "es": {
        "sign": "Aprobar y Firmar",
        "next": "Continuar",
        "finish": "Completar Firma"
      }
    }
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": {
      "en": {
        "sign": "Approve and Sign",
        "next": "Continue",
        "finish": "Complete Signing"
      },
      "es": {
        "sign": "Aprobar y Firmar",
        "next": "Continuar",
        "finish": "Completar Firma"
      }
    }
  }'

Os signatários veem os rótulos personalizados imediatamente. Para reverter para os valores predefinidos da Firma.dev, defina o campo como null:

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": null
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": null
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": null
  }'

Algumas regras de validação que vale a pena conhecer antes de definir valores. Cada rótulo deve ser uma string de 500 carateres ou menos, as chaves de idioma devem ser códigos de idioma válidos, e quaisquer tags HTML ou carateres de controlo são removidos automaticamente. Um detalhe a ter em conta em configurações multi-tenant: as substituições de rótulos de botões são uma definição apenas ao nível do workspace, pelo que, se mantiver um workspace separado por cliente, cada um terá os seus próprios rótulos. Não existe uma substituição ao nível da empresa que se propague em cascata.

Para consultar a referência completa, incluindo todas as chaves de botões disponíveis, veja o guia de white-label na documentação.

Começar

Os rótulos de botões personalizados já estão disponíveis em todos os workspaces, com o mesmo modelo de preços pay-as-you-go de tudo o resto: 0,049 € por envelope (cerca de 5¢ USD), sem consumos mínimos mensais.

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.