Como adicionar assinaturas eletrónicas à sua app Databutton

O Databutton permite-lhe criar aplicações web full-stack descrevendo o que pretende a um agente de IA. Gera backends Python (FastAPI) com frontends 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, a Firma.dev integra-se diretamente na arquitetura de backend do Databutton.

Como funciona (a versão curta)

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

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

Nos bastidores

Para programadores que querem compreender a arquitetura antes de mergulhar na documentação:

A integração tem três partes. Primeiro, um endpoint FastAPI (/send-signing-request) que lê a sua chave de API da Firma.dev 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 usa modelos Pydantic para validação de entrada, por isso tem verificação de tipos logo à partida.

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

Terceiro, um componente de assinatura incorporado opcional. Assim que tiver o signing_request_user_id do destinatário na resposta da API, apresenta a experiência de assinatura da Firma.dev num iframe. Em Streamlit, isso é st.components.v1.iframe(); em React, é um componente iframe padrão. O signatário conclui o documento sem sair da sua app.

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 código de integração para si.

O que obtém

Depois de ligado, a sua aplicação Databutton pode enviar documentos para assinatura a partir de qualquer modelo da Firma.dev, incorporar a assinatura diretamente na sua interface, acompanhar atualizações de estado em tempo real através de webhooks e acionar fluxos de trabalho subsequentes quando os documentos estiverem concluídos.

Todas as assinaturas são juridicamente vinculativas ao abrigo do ESIGN Act, UETA e eIDAS (SES e AdES). Todos os dados dos documentos são armazenados na UE na infraestrutura AWS em Paris e Estocolmo.

Se estiver a criar um produto multi-tenant, os Customer Workspaces da Firma.dev dão a cada cliente o seu próprio ambiente de assinatura isolado, com modelos separados e acompanhamento de utilização.

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

A preços baseados em créditos do Databutton significam 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 encargos por utilizador e sem contratos. Lança a funcionalidade de assinatura e só paga quando os envelopes são efetivamente enviados.

A maioria dos fornecedores de assinaturas eletrónicas cobra $25 a $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 entre muitas funcionalidades, esse modelo de preços não faz sentido. Com a Firma.dev, pode lançar assinaturas eletrónicas desde o primeiro dia sem uma subscrição SaaS separada a reduzir as suas margens.

Comece já

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

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