Março de 2026: Cinco lançamentos de API, lógica condicional e integração de IA

Março foi, até agora, o maior mês de sempre da Firma.dev. Cinco versões da API foram lançadas em menos de quatro semanas, da v1.8.0 à v1.12.0. Eis o que foi disponibilizado.

Documentos Mais Inteligentes

Lógica condicional de campos é a funcionalidade principal da v1.10.0. Os campos podem agora ser obrigatórios ou visíveis de forma dinâmica com base no que os signatários introduzem noutros campos. Um campo "Nome do Cônjuge" que só aparece quando alguém assinala "Casado", ou uma secção de divulgação que se torna obrigatória com base numa seleção de lista pendente. As condições usam lógica AND/OR combinável com 10 operadores de comparação, e são aplicadas no servidor, pelo que não podem ser contornadas.

Etiquetas âncora (v1.11.0) permitem posicionar automaticamente campos em documentos usando marcadores de texto. Incorpore cadeias como {{SIGN_HERE}} no seu PDF, e a Firma.dev converte-as em campos de assinatura posicionados durante a criação. Suporta até 100 âncoras por pedido com opções de correspondência flexíveis. Se estiver a gerar documentos programaticamente a partir de um CRM ou ferramenta documental, isto elimina por completo o posicionamento manual de campos.

Campos de carregamento de ficheiros são um novo tipo de campo que permite aos signatários anexar ficheiros (imagens ou PDFs, até 10MB) diretamente durante o fluxo de assinatura. Pense em verificação de identidade, comprovativo de seguro, ou recibos recolhidos juntamente com um acordo assinado. Os ficheiros são validados pelo conteúdo (magic bytes), e não apenas pela extensão.

Cores de fundo dos campos permitem definir uma cor hex em qualquer campo para o destacar visualmente. Útil para codificar por cores por destinatário ou chamar a atenção para campos que os signatários tendem a falhar.

Flexibilidade de Documentos

Suporte a DOCX chegou na v1.10.0. Todos os endpoints de carregamento de documentos aceitam agora ficheiros Word além de PDF. Os documentos são convertidos automaticamente no servidor, e não são necessárias alterações para integrações existentes baseadas em PDF.

Substituição de documento de modelo (v1.9.0) permite trocar o PDF ou DOCX de um modelo sem perder posicionamentos de campos, atribuições de signatários ou definições. Útil quando a sua equipa jurídica atualiza um contrato e não quer reconstruir o modelo do zero.

Segurança e Verificação

Início de sessão com passkey já está disponível. Os utilizadores podem registar até 10 passkeys (Face ID, Touch ID, Windows Hello, chaves físicas) para iniciar sessão com um toque, com sincronização na cloud via iCloud Keychain e Google Password Manager.

Verificação OTP do signatário adiciona uma camada opcional em que os signatários verificam o seu email com um código de 6 dígitos antes de visualizar ou assinar. Configurável ao nível do workspace e do pedido de assinatura, com expiração de 10 minutos e apresentação mascarada do email.

Molduras de verificação de assinatura adicionam uma pequena sobreposição visual em cada assinatura em PDFs concluídos, mostrando um ID de signatário truncado. Configurável ao nível da empresa, do workspace e do pedido de assinatura. Útil para setores regulados, ou pode desativá-la totalmente para cenários white-label.

Endpoint de trilho de auditoria (v1.10.0) devolve eventos cronológicos (criado, visualizado, assinado, recusado, descarregado) com carimbos temporais, identidade do interveniente e endereços IP via GET /signing-requests/{id}/audit. Criado para relatórios de conformidade e pacotes de prova legal.

White-Label e Localização

Modelos de email personalizados dão-lhe controlo total de HTML sobre todos os 5 emails de notificação que a Firma.dev envia (convite para assinatura, próximo signatário, expirado, cancelado, recusado). Defina-os ao nível da empresa ou do workspace com marcadores dinâmicos como {{signer_name}} e {{signing_link}}.

Definições de idioma do workspace permitem definir um idioma predefinido por workspace para controlar emails enviados. Sete idiomas suportados: Inglês, Espanhol, Italiano, Português, Francês, Alemão e Grego.

Ferramentas para Programadores

Integração MCP (v1.12.0) liga a Firma.dev a assistentes de IA como o Claude. Gere modelos, crie e envie pedidos de assinatura, configure workspaces e muito mais através de linguagem natural. Funciona com Claude Code, Claude Desktop e Claude.ai usando a sua chave de API existente ou OAuth. Veja o guia de integração MCP para instruções de configuração.

Nos Bastidores

Mais algumas coisas a destacar de março:

• Captcha legado totalmente removido e substituído

• Interface de recarga automática de crédito renovada

• Páginas de expiração com marca para pedidos de assinatura expirados

• Todas as novas funcionalidades são lançadas com traduções nos 7 idiomas suportados

• O esquema de webhook inclui agora consecutive_failures e auto_disabled_at para melhor observabilidade

• As respostas Template GET incluem agora destinatários e campos em linha, reduzindo chamadas extra à API

• Todos os lançamentos foram não disruptivos, sem necessidade de migração

A Chegar Esta Semana

PAdES Baseline B-LTA chega esta semana. Este é um passo importante para validação de assinaturas a longo prazo, dando aos seus documentos assinados prova criptográfica que permanece verificável durante anos. Mais detalhes em breve.

Todas as versões desde a v1.8.0 estão totalmente documentadas no nosso registo de alterações da API e em atualizações da plataforma. Todas as alterações foram aditivas, sem alterações disruptivas.

Comece a usar a Firma.dev gratuitamente, sem necessidade de cartão de crédito.