Como adicionar assinaturas eletrónicas à sua app Databutton

O Databutton permite-lhe construir aplicações web de pilha completa (full-stack) descrevendo o que deseja a um agente de IA. Gera terminais (backends) em Python (FastAPI) com interfaces (frontends) em Streamlit ou React, e lida com a implementação com um único clique. Quando a sua aplicação precisa de enviar contratos, recolher assinaturas ou fechar negócios com documentos juridicamente vinculativos, a Firma.dev liga-se diretamente à arquitetura de terminal do Databutton.

Como funciona (a versão curta)

As aplicações Databutton têm uma separação clara entre a interface e o terminal. A sua chave de API vai para o painel de Segredos (Secrets) do Databutton (nunca exposta ao navegador) e cria um ponto de extremidade HTTP Python que chama a API da Firma.dev. A sua interface, seja ela Streamlit ou React, chama esse ponto de extremidade quando um utilizador aciona uma ação de assinatura. O signatário recebe o documento por correio eletrónico ou diretamente na sua aplicação através de um iframe incorporado.

Quando o documento é assinado, a Firma.dev envia um webhook para outro ponto de extremidade do Databutton que atualiza o estado da sua aplicação. Também pode pedir ao chat de IA do Databutton para interligar tudo isto por si, descrevendo o fluxo em inglês simples.

Por baixo do capô

Para programadores que pretendem compreender a arquitetura antes de saltarem para a documentação:

A integração tem três partes. Primeiro, um ponto de extremidade FastAPI (/send-signing-request) que lê a sua chave de API da Firma.dev a partir dos segredos do Databutton, chama o ponto de extremidade create-and-send com os detalhes do modelo e do destinatário, e devolve o ID do pedido de assinatura. O ponto de extremidade utiliza modelos Pydantic para validação de entradas, pelo que obtém verificação de tipos imediata.

Segundo, um processador de webhook (/firma-webhook) que escuta eventos como signing_request.completed e atualiza a base de dados da sua aplicação ou aciona o passo seguinte no seu fluxo de trabalho utilizando o armazenamento integrado do Databutton.

Terceiro, um componente opcional de assinatura incorporado. Assim que tiver o signing_request_user_id do destinatário a partir da resposta da API, renderiza a experiência de assinatura da Firma.dev num iframe. No Streamlit, trata-se de st.components.v1.iframe(); no React, é um componente iframe normal. O signatário conclui o documento sem sair da sua aplicação.

Também pode ligar o servidor Docs MCP da Firma.dev às suas ferramentas de desenvolvimento, para que o assistente de IA do Databutton possa consultar a documentação completa da API enquanto gera o código de integração para si.

O que obtém

Uma vez ligada, a sua aplicação Databutton pode enviar documentos para assinatura a partir de qualquer modelo da Firma.dev, incorporar a assinatura diretamente no seu ecran, acompanhar atualizações de estado em tempo real através de webhooks e acionar fluxos de trabalho a jusante quando os documentos forem concluídos.

Cada assinatura é juridicamente vinculativa ao abrigo do ESIGN Act, UETA e eIDAS (SES e AdES). Todos os dados dos documentos são armazenados na UE em infraestrutura AWS em Paris e Estocolmo.

Se estiver a construir um produto multi-inquilino (multi-tenant), os Workspaces de Clientes da Firma.dev dão a cada um dos seus clientes o seu próprio ambiente de assinatura isolado com modelos e rastreio de utilização separados.

Preços que fazem sentido para criadores de aplicações

O modelo de preços baseado em créditos do Databutton significa que só paga pelo que utiliza. A Firma.dev funciona da mesma forma: €0,029 (cerca de 3 cêntimos de USD) por envelope, sem mensalidades, sem taxas por utilizador e sem contratos. Lança a funcionalidade de assinatura e só paga quando os envelopes forem realmente enviados.

A maioria dos fornecedores de assinatura eletrónica cobra entre $25 e $50 por utilizador, por mês, antes de enviar um único documento. Se estiver a criar uma aplicação em que a assinatura é apenas uma funcionalidade entre muitas, esse modelo de preços não faz sentido. Com a Firma.dev, pode lançar a sua aplicação com assinaturas eletrónicas logo no primeiro dia, sem que uma subscrição SaaS separada consuma as suas margens.

Como começar

O guia de integração completo do Databutton em docs.firma.dev explica cada passo: guardar a sua chave de API, criar o ponto de extremidade de backend, ligar a sua interface e gerir webhooks. Se já criou uma função de backend no Databutton anteriormente, terá pedidos de assinatura a funcionar em menos de uma hora.

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