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

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

Como funciona (a versão curta)

As aplicações Rork são apenas de frontend, o que significa que não pode fazer chamadas diretas a APIs externas a partir da aplicação sem expor as suas credenciais no pacote da aplicação. Por isso, a integração utiliza um backend leve, normalmente uma Supabase Edge Function ou uma função serverless da 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 liga para o Firma.dev para criar um pedido de assinatura e o assinante 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á está a utilizar o Supabase como backend da sua aplicação Rork (o que muitos programadores do Rork fazem), pode reutilizar essa mesma infraestrutura. Uma Edge Function, um segredo, e já está ativo.

Por baixo do capô

Para os programadores que desejam compreender a arquitetura antes de passarem para a documentação:

La integração tem três partes. Primeiro, um endpoint de backend (a Supabase Edge Function é o caminho recomendado) que armazena a sua chave de API do Firma.dev como segredo e expõe 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 WebView do React Native que carrega o URL de assinatura incorporado do Firma.dev usando o signing_request_user_id da resposta da API. Isto permite que os assinantes preencham o documento sem sair da sua aplicação. Instala o react-native-webview via Expo, aponta-o para https://app.firma.dev/signing/{id} e a experiência de assinatura é renderizada nativamente na interface de utilizador móvel.

Terceiro, um processador de webhook (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 MCP de Docs do Firma.dev às suas ferramentas de programação com IA durante a criação, para que o seu assistente possa consultar a documentação completa da API enquanto gera o 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, na infraestrutura AWS em Paris e Estocolmo.

Se estiver a criar um produto multi-inquilino, os Espaços de Trabalho de Clientes do Firma.dev oferecem a cada um dos seus clientes o seu próprio ambiente de assinatura isolado com modelos e acompanhamento de utilização independentes.

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,029 € (aproximadamente 3 cêntimos de USD) por envelope. Sem taxas mensais, sem custos por utilizador, sem contratos. Lança a funcionalidade e só paga quando os envelopes forem realmente 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 que poderá ainda não precisar.

Começar

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