Como Integrar Assinaturas Eletrónicas em Aplicações Criadas com o Google Antigravity

Está a criar uma aplicação com o Google Antigravity e, a certa altura, o utilizador precisa de assinar algo. Um contrato, um acordo de confidencialidade (NDA), um formulário de consentimento, uma encomenda. A resposta habitual é recorrer a um fornecedor de assinaturas pesado, passar por um ciclo de vendas e aceitar preços por utilizador que não se adequam a um produto que ainda está a definir a sua forma. Há um caminho mais limpo. O Firma.dev é uma API de assinatura eletrónica que chama a partir da aplicação que já está a programar, e os passos completos de implementação encontram-se no guia de integração do Antigravity para que os possa entregar diretamente a quem escreve o código.

Se ainda não o utilizou, o Antigravity é a ferramenta de desenvolvimento focada em agentes da Google, construída em torno de agentes de IA que conseguem ler o contexto e agir sobre ele, em vez de se limitarem ao preenchimento automático. Este artigo destina-se a fundadores e avaliadores que estão a decidir se esta abordagem de assinatura é adequada. Fica de fora do código e foca-se no que obtém, quanto custa e como as peças se encaixam.

Integração de assinaturas eletrónicas numa aplicação Antigravity

O resultado em primeiro lugar: um produto desenvolvido com o Antigravity pode enviar documentos legalmente vinculativos para assinatura e recolhê-los de volta, sem ter de criar uma plataforma de assinatura própria e sem negociações contratuais para lá chegar. A sua aplicação envia um documento, o assinante recebe um link, assina e o utilizador obtém um ficheiro concluído e uma pista de auditoria que regista quem assinou e quando.

Como não existe nenhum fornecedor de assinaturas entre si e os seus utilizadores, a experiência permanece dentro do seu produto. Os assinantes não são reencaminhados para uma marca de terceiros. O ecrã de assinatura pode ser incorporado na sua própria interface de utilizador, pelo que o fluxo parece fazer parte da aplicação e não um desvio pela ferramenta de outra pessoa.

O caminho principal: Firma.dev na aplicação que está a criar

A principal forma de utilizar o Firma.dev é como uma API que a sua aplicação chama. Quando a sua aplicação necessita de uma assinatura, envia o documento para o Firma.dev, que trata da entrega ao assinante, da experiência de assinatura e do registo final. Pode colocar um editor de assinaturas incorporado diretamente na sua interface, para que os utilizadores nunca saiam do seu produto para concluir uma assinatura.

O Firma.dev também disponibiliza dois servidores MCP, um Docs MCP e um Data MCP. Ligados dentro do Antigravity, permitem que o agente leia a documentação em direto e trabalhe com a API à medida que cria, o que significa que a integração é escrita sem que tenha de programar manualmente cada chamada REST. É o mesmo produto em qualquer uma das vias. O caminho do MCP apenas altera a forma como a integração é escrita. Os passos de construção para ambos estão no guia oficial do Antigravity, que é onde se encontram os detalhes técnicos, incluindo como migrar se estivesse a utilizar a CLI do Gemini.

A alternativa: deixar que o agente do Antigravity envie o próprio contrato

O Antigravity é orientado por agentes, pelo que, além de escrever a integração, um agente ligado aos servidores MCP do Firma.dev também pode operar diretamente sobre os seus dados do Firma. Pode enviar um pedido de assinatura, gerir modelos e agir sobre um documento quando solicitado em linguagem natural, em vez de esperar que um botão na sua interface de utilizador dispare a chamada.

Isto é útil se estiver a criar algo em que a interface natural é uma conversa ou um fluxo de trabalho automatizado, em vez de um ecrã fixo. É uma opção que vale a pena conhecer, não a opção predefinida. A maioria dos produtos quererá que a própria aplicação controle quando os documentos são enviados, com o caminho do agente adicionado onde for genuinamente útil. De qualquer forma, a chamada subjacente ao Firma.dev é a mesma.

Porque é que isto é mais barato do que a alternativa

O Firma.dev funciona num modelo pré-pago a 0,029 EUR por envelope, o que equivale a sensivelmente 3 cêntimos de USD. Paga pelos documentos que efetivamente envia, sem custos iniciais, sem mínimos mensais e sem contratos anuais a assinar antes de poder começar. Um envelope é um único pedido de assinatura, pelo que um documento enviado para um ou vários assinantes conta como um único envelope.

Compare isto com o modelo de assinatura empresarial, onde os preços são estruturados em torno de licenças por utilizador e planos anuais por escalões. Essa estrutura pressupõe um conjunto fixo de utilizadores internos a enviar documentos, o que não se adequa a um produto SaaS onde o volume de assinaturas aumenta e diminui de acordo com a atividade dos seus próprios clientes. Pagar por envelope significa que o seu custo de assinatura acompanha diretamente a utilização, e um mês mais calmo custa-lhe quase zero. Para um produto em crescimento, esta diferença acumula-se.

Concebido para produtos com muitos clientes

Se a sua aplicação Antigravity serve vários clientes, vai querer que os documentos e modelos deles fiquem separados. O Firma.dev lida com isto através de Customer Workspaces (Espaços de Trabalho de Clientes), que são espaços privados e particionados dentro da sua conta. Cada cliente obtém modelos isolados e a sua própria utilização de envelopes, para que os contratos e a atividade de assinatura de um cliente nunca se misturem com os de outro.

Isto é importante por duas razões. A primeira é a separação limpa, que mantém os dados de cada cliente onde pertencem e simplifica os relatórios por cliente. A segunda é que acompanha o seu crescimento. À medida que adiciona clientes, adiciona espaços de trabalho, sem ter de reestruturar o funcionamento das assinaturas na sua aplicação. A estrutura foi pensada para cenários de vários clientes desde o início, em vez de ser adaptada mais tarde.

Conformidade, em poucas palavras

O Firma.dev foi concebido para os principais enquadramentos de assinatura eletrónica. Nos Estados Unidos, isso significa a lei ESIGN e a UETA. Na Europa, significa o eIDAS, suportando Assinaturas Eletrónicas Simples e Assinaturas Eletrónicas Avançadas, e foi construído para o ajudar a cumprir o RGPD no que diz respeito aos dados pessoais envolvidos num fluxo de assinatura.

Cada assinatura concluída vem acompanhada de uma pista de auditoria que regista os eventos de assinatura, que é o registo a que recorreria se uma assinatura fosse alguma vez contestada. Se o seu caso de utilização específico tiver requisitos regulamentares que vão além dos enquadramentos comuns, vale a pena confirmar os detalhes com a sua própria assessoria jurídica antes de avançar para a programação. O ponto essencial aqui é que a assinatura legalmente vinculativa é a base, e não um extra que tenha de programar por conta própria.

Dar os primeiros passos

Se está a desenvolver com o Antigravity e quer assinaturas dentro do seu produto, o caminho é curto. Comece com o guia de integração do Antigravity para a implementação, quer faça a ligação direta da API ou a construa através dos servidores MCP. A mesma abordagem também funciona noutras ferramentas de criação de IA, pelo que a camada de assinatura eletrónica que adiciona a uma Lovable app ou a um projeto no Cursor será muito semelhante.

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