Como adicionar assinaturas eletrónicas à sua app Databutton

O Databutton permite construir aplicações web full-stack descrevendo o que deseja a um agente de IA. Este gera backends em Python (FastAPI) com frontends em Streamlit ou React, e trata da 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, o Firma.dev liga-se diretamente à arquitetura de backend do Databutton.

Como funciona (a versão curta)

As aplicações Databutton têm uma separação clara entre frontend e backend. A sua chave de API vai para o painel de Segredos do Databutton (nunca exposta ao navegador) e o utilizador cria um endpoint HTTP em Python que chama a API do Firma.dev. O seu frontend, quer seja Streamlit ou React, chama esse endpoint quando um utilizador ativa uma ação de assinatura. O signatário recebe o documento por e-mail ou diretamente na sua aplicação através de uma iframe incorporada.

Quando o documento é assinado, o Firma.dev envia um webhook para outro endpoint 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 detrás dos panos

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

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

Segundo, um manipulador 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 incorporado 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 do Firma.dev numa iframe. No Streamlit isso corresponde a st.components.v1.iframe(); no React é um componente iframe padrão. O signatário conclui o documento sem sair da sua aplicação.

Também pode ligar o servidor Docs MCP do 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 ligado, a sua aplicação Databutton pode enviar documentos para assinatura a partir de qualquer modelo do Firma.dev, incorporar a assinatura diretamente na sua interface de utilizador, acompanhar atualizações de estado em tempo real através de webhooks e acionar fluxos de trabalho subsequentes quando os documentos estiverem concluídos.

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

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

Preços que fazem sentido para criadores de apps

O modelo de preços baseado em créditos do Databutton significa que só paga pelo que consome. O Firma.dev funciona da mesma forma: €0,049 (aproximadamente 5 cêntimos de USD) por envelope, sem taxas mensais, sem custos por utilizador e sem contratos. Lança a funcionalidade de assinatura e só paga quando os envelopes forem efetivamente enviados.

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

Começar

O guia completo de integração do Databutton em docs.firma.dev detalha cada passo: armazenar a sua chave de API, criar o endpoint de backend, ligar o seu frontend e gerir os webhooks. Se já construiu uma função de backend no Databutton anteriormente, terá os pedidos de assinatura a funcionar em menos de uma hora.

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