Cómo añadir firmas electrónicas a tu app de Rork

Rork crea aplicaciones de React Native listas para producción a partir de una descripción. Describes lo que quieres y genera una aplicación operativa para iOS y Android. Pero cuando esa aplicación necesita enviar contratos, recopilar firmas o gestionar documentos de conformidad, necesitas algo diseñado específicamente para ello. Firma.dev se conecta a las aplicaciones de Rork a través de un backend serverless ligero, lo que proporciona a tu aplicación móvil un sistema de firma electrónica completo sin tener que recurrir a una costosa herramienta empresarial.

Cómo funciona (versión corta)

Las aplicaciones de Rork son solo de frontend, lo que significa que no puedes llamar a API externas directamente desde la aplicación sin exponer tus credenciales en el paquete de la aplicación. Por lo tanto, la integración utiliza un backend ligero, normalmente una Supabase Edge Function o una función serverless de Vercel, que se sitúa entre tu aplicación de Rork y la API de Firma.dev.

El flujo es sencillo: tu aplicación móvil envía una solicitud a tu backend, el backend llama a Firma.dev para crear una solicitud de firma y el firmante recibe el documento por correo electrónico o directamente dentro de tu aplicación a través de un WebView integrado. Cuando se firma el documento, Firma.dev envía un webhook a tu backend para que puedas actualizar tu base de datos o activar una notificación push.

Si ya estás utilizando Supabase como backend de tu aplicación de Rork (como hacen muchos desarrolladores de Rork), puedes reutilizar esa misma infraestructura. Una Edge Function, un secreto y ya estás en producción.

Bajo el capó

Para los desarrolladores que quieran entender la arquitectura antes de profundizar en la documentación:

La integración consta de tres partes. En primer lugar, un endpoint de backend (la ruta recomendada es Supabase Edge Function) que almacena tu clave de API de Firma.dev como un secreto y expone una función send-signing-request. Esta función llama al endpoint create-and-send de Firma.dev con los detalles de la plantilla y del destinatario, y luego devuelve el ID de la solicitud de firma a tu aplicación móvil.

En segundo lugar, un componente WebView de React Native que carga la URL de firma integrada de Firma.dev utilizando el signing_request_user_id de la respuesta de la API. Esto permite a los firmantes completar el documento sin salir de tu aplicación. Instalas react-native-webview a través de Expo, lo apuntas a https://app.firma.dev/signing/{id} y la experiencia de firma se renderiza de forma nativa en la interfaz de usuario de tu móvil.

En tercer lugar, un controlador de webhook (otra Edge Function, desplegada con --no-verify-jwt) que escucha eventos como signing_request.completed y actualiza tu base de datos o envía notificaciones push en consecuencia.

También puedes conectar el Docs MCP server de Firma.dev a tus herramientas de programación de IA mientras construyes, de modo que tu asistente pueda hacer referencia a la documentación completa de la API a medida que genera el código de integración para tu aplicación de Rork.

Qué obtienes

Una vez conectada, tu aplicación de Rork puede enviar documentos para su firma desde cualquier plantilla que hayas creado en Firma.dev, incrustar la experiencia de firma directamente en un WebView móvil, realizar el seguimiento del estado de la firma a través de webhooks y activar acciones posteriores como notificaciones push cuando los documentos se hayan completado.

Cada firma es legalmente vinculante según la ley ESIGN, UETA y eIDAS (SES y AdES). Todos los datos de los documentos se almacenan en la UE en la infraestructura de AWS en París y Estocolmo.

Si estás creando un producto multiinquilino, los Customer Workspaces de Firma.dev ofrecen a cada uno de tus clientes su propio entorno de firma aislado con plantillas y seguimiento de uso independientes.

Precios adaptados a las aplicaciones móviles

La mayoría de los proveedores de firma electrónica cobran por usuario al mes, lo que no tiene ningún sentido para una aplicación móvil donde la firma es solo una función entre muchas. Firma.dev cobra 0,029 € (aproximadamente 3 centavos de dólar) por sobre. Sin cuotas mensuales, sin cargos por usuario, sin contratos. Publicas la función y solo pagas cuando realmente se envían los sobres.

Para una aplicación de Rork que acaba de empezar a traccionar, eso significa que puedes lanzarla con firmas electrónicas desde el primer día sin comprometerte con un contrato SaaS de 300 $/mes que quizás aún no necesites.

Primeros pasos

La guía completa de integración de Rork en docs.firma.dev detalla cada paso: configurar tu endpoint de backend, llamarlo desde tu código de React Native, incrustar el WebView de firma y gestionar webhooks. Si ya has publicado una aplicación de Rork con un backend de Supabase anteriormente, tendrás las solicitudes de firma funcionando en menos de una hora.

Empieza a usar Firma.dev gratis, sin necesidad de tarjeta de crédito.