Atualizações do produto de maio de 2026

Este mês lançamos seis atualizações, abrangendo a imagem de marca, a experiência de utilizador (UX) de assinatura e um controlo de API mais granular sobre a experiência de assinatura. Eis as novidades.

Carregamento de Logótipo de Empresa e de Espaço de Trabalho

Agora já pode carregar o seu próprio logótipo para aparecer nos certificados de assinatura e nos e-mails de notificação. Carregue um ficheiro PNG ou JPEG (até 2 MB) através de Configurações > Aspeto, ou gira os logótipos programaticamente através da API. Os logótipos são apresentados com um tamanho máximo de 180x50 px nos certificados, mantendo a sua proporção original.

A cadeia de prioridade funciona da mesma forma que outras definições em cascata no Firma.dev: o logótipo do espaço de trabalho sobrepõe-se ao logótipo da empresa, que por sua vez se sobrepõe ao padrão. Se estiver a gerir uma configuração multimarca com Espaços de Trabalho de Clientes, cada espaço de trabalho pode ter a sua própria imagem de marca. Quando não é definido um logótipo personalizado, os certificados revertem para o valor predefinido do Firma.dev.

Endpoints da API: POST /company/logo e DELETE /company/logo para imagem de marca ao nível da empresa. POST /workspaces/{id}/logo e DELETE /workspaces/{id}/logo para imagem de marca ao nível do espaço de trabalho. O campo icon_url nas respostas GET devolve um URL publicamente acessível para compatibilidade com e-mail. Todos os detalhes no Changelog da API v1.19.0.

Controlo de Navegação Guiada

Por predefinição, o Firma.dev faz avançar automaticamente os signatários para o campo obrigatório seguinte após a conclusão de cada um. Isto funciona bem para formulários curtos, mas pode ser desorientador em documentos mais longos onde os signatários precisam de ler o conteúdo sequencialmente.

Agora pode desativar este comportamento de deslocamento automático com um único botão. Quando a navegação guiada está desativada, os signatários movem-se pelo documento ao seu próprio ritmo. O botão "Campo Obrigatório Seguinte" continua disponível para quem o pretender utilizar, pelo que nada se altera para os signatários que preferem o fluxo guiado.

À semelhança de outras definições do Firma.dev, esta aplica-se em cascata em quatro níveis: empresa, espaço de trabalho, modelo e pedido de assinatura. Cada nível sobrepõe-se ao anterior, proporcionando-lhe um controlo preciso sobre a experiência de assinatura por documento ou por cliente.

O novo parâmetro disable_guided_navigation está disponível em POST/PATCH /signing-requests, POST/PATCH /templates, e nos endpoints de configurações de espaço de trabalho/empresa. O mesmo padrão em cascata que require_otp_verification. Todos os detalhes no Changelog da API v1.20.0.

Fluxo de Assinatura Guiado

A vista de assinatura agora orienta os signatários através dos documentos, campo a campo. Quando um signatário aceita os termos e o documento é carregado, o primeiro campo obrigatório é automaticamente destacado e focado no ecrã.

Depois de preencher um campo, a vista avança automaticamente para o seguinte após um breve atraso. Uma etiqueta flutuante acima do campo ativo indica exatamente ao signatário o que é necessário: "Assine aqui", "Introduza texto", "Selecione uma data" ou "Carregue um ficheiro". Uma barra de progresso no topo monitoriza quantos campos obrigatórios já foram preenchidos em relação ao total.

A navegação pelo teclado também funciona. Os signatários podem premir Tab para percorrer os campos na ordem de leitura e premir Enter para avançar, pelo que toda a experiência de assinatura pode ser concluída sem tocar no rato. Trata-se de uma melhoria significativa para documentos com muitos campos, nos quais anteriormente os signatários tinham de andar a navegar de um lado para o outro para descobrir o que tinham deixado por preencher.

Campos de Dados Pré-preenchidos Editáveis

Os campos de dados pré-preenchidos agora podem ser opcionalmente editáveis pelos signatários, em vez de estarem sempre bloqueados. Um novo botão prefilledEditable nas regras de formatação do campo controla se os signatários podem modificar o valor pré-preenchido durante a assinatura.

Isto está disponível no editor de modelos, no editor de pedidos de assinatura, em ambos os editores incorporados e na API REST completa. Na interface do editor, surge como uma caixa de seleção "Permitir que o signatário edite este valor" quando são selecionados dados pré-preenchidos.

O caso de utilização típico: contratos em que os dados do formulário pré-configuram os campos (nome, morada, ID do funcionário), mas os signatários podem precisar de corrigir algo antes de assinar. Os campos pré-preenchidos existentes permanecem bloqueados por predefinição, pelo que nada muda a menos que ative explicitamente esta opção.

Valores de Campo Explícitos via API

Os utilizadores da API podem agora definir um value explícito em qualquer campo ao criar pedidos de assinatura, independentemente do mecanismo de dados pré-preenchidos ou das definições de apenas leitura. Transmita o value em qualquer objeto de campo em POST /signing-requests ou POST /signing-requests/create-and-send, e este terá precedência sobre os dados do destinatário preenchidos automaticamente.

Isto oferece-lhe uma forma limpa de preencher programaticamente valores específicos do contrato, tais como montantes, datas ou números de referência no momento da criação, sem necessidade de configurar mapeamentos de dados pré-preenchidos. A API valida a exclusividade mútua, pelo que receberá um erro claro 400 VALIDATION_ERROR se forem definidos recursos de valor conflituantes num único campo.

Campos de Identidade Editáveis

Os signatários podem agora rever e editar os seus detalhes de identidade (nome, empresa, cargo, telefone, morada) através de uma caixa de diálogo de confirmação antes de assinar. Uma nova configuração identity_editable_fields aceita uma lista de chaves de campos para tornar editáveis, ou null para desativar completamente a funcionalidade.

Pode definir diferentes campos editáveis por destinatário, permitindo que um signatário atualize o seu cargo e empresa enquanto outro permanece com os dados bloqueados. Quando um signatário altera a sua identidade, o Firma.dev pode notificá-lo através de um novo evento de webhook signing_request.signer_identity_changed e de notificações opcionais por e-mail. Ambas são controladas através das definições notify_identity_change_webhook e notify_identity_change_email.

Desativado por predefinição, totalmente compatível com versões anteriores.

Referência da API

O carregamento de logótipo e o controlo de navegação guiada fazem parte da API v1.19.0 e v1.20.0, respetivamente. As outras quatro funcionalidades foram lançadas na v1.18.0. Se já tem a integração feita, atualize a sua versão da API para aceder aos novos endpoints e propriedades de campo.

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