Como Adicionar Assinaturas Eletrónicas à Sua Aplicação Rork

O Rork cria aplicações React Native prontas para produção a partir de um prompt. Descreve o que pretende, e ele gera uma aplicação iOS e Android funcional. No entanto, quando essa aplicação precisa de enviar contratos, recolher assinaturas ou gerir documentos de conformidade, precisa de algo concebido especificamente para esse fim. O Firma.dev liga-se às aplicações Rork através de um backend serverless leve, proporcionando à sua aplicação móvel um sistema completo de assinatura eletrónica sem precisar de adicionar uma ferramenta empresarial dispendiosa.

Como funciona (a versão curta)

As aplicações Rork são apenas frontend, o que significa que não pode chamar APIs externas diretamente da aplicação sem expor as suas credenciais no bundle da aplicação. Por isso, a integração utiliza um backend leve, normalmente uma Supabase Edge Function ou uma função serverless Vercel, que se posiciona entre a sua aplicação Rork e a API do Firma.dev.

O fluxo é simples: a sua aplicação móvel envia um pedido para o seu backend, o backend chama o Firma.dev para criar um pedido de assinatura, e o signatário recebe o documento por e-mail ou diretamente dentro da sua aplicação através de uma WebView incorporada. Quando o documento é assinado, o Firma.dev envia um webhook para o seu backend para que possa atualizar a sua base de dados ou acionar uma notificação push.

Se já estiver a utilizar o Supabase como backend da sua aplicação Rork (o que muitos programadores de Rork fazem), pode reutilizar essa mesma infraestrutura. Uma Edge Function, um segredo, e já está ativo.

Por detrás do pano

Para programadores que queiram compreender a arquitetura antes de avançarem para a documentação:

La integração tem três partes. Primeiro, um endpoint de backend (recomenda-se a Supabase Edge Function) que armazena a sua chave de API do Firma.dev como um segredo e disponibiliza uma função send-signing-request. Esta função chama o endpoint create-and-send do Firma.dev com os detalhes do modelo e do destinatário, e depois devolve o ID do pedido de assinatura à sua aplicação móvel.

Segundo, um componente React Native WebView que carrega o URL de assinatura incorporado do Firma.dev utilizando o signing_request_user_id da resposta da API. Isto permite que os signatários preencham o documento sem saírem da sua aplicação. Instala o react-native-webview através do Expo, aponta-o para https://app.firma.dev/signing/{id}, e a experiência de assinatura é renderizada nativamente na UI do seu telemóvel.

Terceiro, um processador de webhooks (outra Edge Function, implementada com --no-verify-jwt) que escuta eventos como signing_request.completed e atualiza a sua base de dados ou envia notificações push em conformidade.

Também pode ligar o servidor Docs MCP do Firma.dev às suas ferramentas de programação com IA enquanto desenvolve, para que o seu assistente possa consultar toda a documentação da API à medida que gera código de integração para a sua aplicação Rork.

O que obtém

Uma vez ligado, a sua aplicação Rork pode enviar documentos para assinatura a partir de qualquer modelo que tenha criado no Firma.dev, incorporar a experiência de assinatura diretamente numa WebView móvel, acompanhar o estado da assinatura através de webhooks e acionar ações posteriores, como notificações push, quando os documentos forem concluídos.

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

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

Preços que funcionam para aplicações móveis

A maioria dos fornecedores de assinatura eletrónica cobra por utilizador por mês, o que não faz qualquer sentido para uma aplicação móvel onde a assinatura é apenas uma funcionalidade entre muitas. O Firma.dev cobra €0.049 (aproximadamente 5 cêntimos de USD) por envelope. Sem mensalidades, sem custos por utilizador, sem contratos. Lança a funcionalidade e só paga quando os envelopes forem efetivamente enviados.

Para uma aplicação Rork que está agora a ganhar tração, isso significa que pode lançar com assinaturas eletrónicas logo no primeiro dia, sem se comprometer com um contrato SaaS de $300/mês de que poderá ainda não precisar.

Como começar

O guia completo de integração do Rork em docs.firma.dev explica todos os passos: configurar o seu endpoint de backend, chamá-lo a partir do seu código React Native, incorporar a WebView de assinatura e gerir webhooks. Se já lançou uma aplicação Rork com um backend Supabase antes, terá 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.