Guías
Añada firmas electrónicas a cualquier flujo de trabajo de n8n con Firma.dev
Escrito por

n8n es donde muchos equipos ya ejecutan su lógica de contratos: llega un formulario, una oportunidad cambia de fase, se alcanza una fecha de renovación y se activa un flujo de trabajo. La pieza que suele faltar es la propia firma. Firma.dev ahora incluye un nodo de la comunidad dedicado n8n-nodes-firma con 83 operaciones, un disparador que gestiona sus propios webhooks y una herramienta integrada para el agente de IA de n8n, por lo que rara vez necesitarás volver a conectar manualmente un nodo HTTP Request.
Dado que Firma.dev factura por sobre a 0,049 € (~5 ¢ USD) sin coste por usuario ni mínimos mensuales, se adapta especialmente bien a los envíos automatizados. Cuando un flujo de trabajo envía cincuenta contratos de renovación de la noche a la mañana, pagas por cincuenta sobres, no por un plan superior al que te hayas visto obligado a cambiar. Esa es la diferencia entre una automatización que ahorra dinero y otra que dispara silenciosamente la factura.
Este artículo cubre cuatro formas de conectar Firma.dev con n8n: el nodo dedicado para enviar y gestionar documentos, el nodo disparador para reaccionar a contratos firmados, Firma.dev como herramienta para el agente de IA y una configuración manual con Webhook más HTTP Request si prefieres evitar los nodos de la comunidad por completo.
Opción 1: instalar el nodo de Firma.dev
Esta es la forma más rápida de poner en marcha Firma.dev en n8n. El nodo se encarga de la autenticación, el formato de las solicitudes y la paginación por ti, con campos desplegables en lugar de JSON sin procesar.
Desde el editor de flujos de trabajo, haz clic en + para añadir un nodo, busca "Firma" y selecciona Install en Community Nodes. El nodo se instala y se añade a tu lienzo en un solo paso. Si prefieres instalarlo con antelación, ve a Settings > Community Nodes, haz clic en Install e introduce n8n-nodes-firma. Las instancias autohospedadas también pueden instalarlo manualmente:
Reinicia n8n tras una instalación manual.
A continuación, configura las credenciales. Haz clic en Credentials en la barra lateral, añade una nueva y busca Firma API. Necesitarás tu clave de API de Workspace Settings > API y, opcionalmente, un secreto de webhook de Workspace Settings > Webhooks si tienes previsto validar los eventos entrantes más adelante. Deja Environment configurado en Production.
El nodo cubre 83 operaciones en diversos recursos, incluidos Signing Request, Template, Webhook, Workspace, Company, Domain y Email Template, por lo que la mayoría de los flujos de trabajo nunca necesitarán salir de él. Un envío habitual tiene el siguiente aspecto:
Añade un nodo Firma y selecciona tu credencial de Firma API
Establece Resource en Signing Request y Operation en Create and Send
Establece Document Source en Template e introduce tu Template ID
En Recipients, añade el correo electrónico, el nombre, el cargo y el orden del firmante mediante expresiones como
{{ $json.signer_email }}
La respuesta incluye el id de la nueva solicitud de firma, que puedes registrar o transferir a pasos posteriores. Para los flujos de aprobación, utiliza la operación Create para guardar un borrador, inserta un paso de aprobación o espera y luego llama a Send una vez aprobado.
Un detalle importante antes de conectar esto en un flujo de trabajo con mucho volumen: las operaciones de escritura de Firma (Create, Create and Send, Send y Resend) no incluyen una clave de idempotencia. Si un nodo vuelve a intentar la operación automáticamente tras un tiempo de espera agotado, puedes terminar enviando el mismo contrato dos veces, y ambas copias son legalmente vinculantes una vez firmadas. Desactiva Retry On Fail en estas operaciones y gestiona los reintentos con tu propia lógica si los necesitas.
Opción 2: reaccionar a documentos firmados con el nodo Firma Trigger
El nodo disparador hace algo que un nodo Webhook genérico no puede: registra y cancela el registro del webhook con Firma.dev automáticamente al activar o desactivar el flujo de trabajo. No hay ningún paso que recordar en el panel y no queda nada residual si desactivas un flujo de trabajo.
Añade un nodo Firma Trigger a un nuevo flujo de trabajo, selecciona tu credencial de Firma API y elige qué eventos escuchar en Events, como Signing Request Completed o Signing Request Recipient Declined. Puedes limitar el alcance del disparador a un único ID de espacio de trabajo si utilizas varios. Al activar el flujo de trabajo, se crea el webhook que apunta a tu instancia de n8n; al desactivarlo, se elimina, y los webhooks huérfanos de ejecuciones anteriores se detectan y reutilizan en lugar de duplicarse.
El disparador cubre los 27 eventos de webhook de Firma.dev en solicitudes de firma, destinatarios, plantillas, espacios de trabajo y dominios. Enrútalos con un nodo Switch evaluando {{ $json.type }}:
signing_request.completedactualiza tu CRM e inicia el aprovisionamientosigning_request.recipient.declinednotifica al equipo de ventassigning_request.expiredreenvía o mueve la oportunidad a perdida
Si añadiste un secreto de webhook a tu credencial, el disparador valida la cabecera X-Firma-Signature con HMAC-SHA256 automáticamente, incluida la cabecera de periodo de gracia utilizada durante la rotación de secretos. Las solicitudes que no superan la validación se rechazan antes de llegar a la lógica de tu flujo de trabajo. Para ver en mayor detalle cómo se asignan los eventos de webhook a los espacios de trabajo multiinquilino, consulta la guía de webhooks para espacios de trabajo.
Si tu siguiente paso es archivar el documento completado automáticamente, el tutorial de Google Drive cubre esa misma configuración en cuatro pasos, desde el disparador hasta la subida, en una sola guía dedicada.
La API de webhooks de Firma.dev requiere HTTPS. n8n Cloud se encarga de ello automáticamente; las instancias autohospedadas necesitan un proxy inverso con TLS o un túnel como cloudflared tunnel --url http://localhost:5678 o ngrok http 5678 durante el desarrollo. Además, los webhooks deben estar habilitados en el panel de Firma.dev en Workspace Settings > Webhooks. El botón Test de cada webhook ignora ese interruptor principal, por lo que una prueba correcta no garantiza que los eventos reales se estén enviando.
Opción 3: Firma.dev como herramienta para el agente de IA de n8n
El nodo Firma también puede actuar como una herramienta nativa para el nodo AI Agent, sin necesidad de configuraciones HTTP personalizadas. En un flujo de trabajo con AI Agent, añade un nodo Firma como entrada de herramienta (tool input), selecciona tu credencial y elige el recurso y la operación que deseas exponer, como Signing Request > Create and Send.
Expón más de una operación si quieres que el agente disponga de opciones reales en lugar de un único recurso. Una combinación habitual es Template > List, para que el agente pueda buscar la plantilla adecuada por sí mismo, junto con Signing Request > Create and Send para enviarla y Signing Request > Get para comprobar el estado cuando se le solicite. El agente decide qué herramienta invocar en función de la conversación, de modo que una instrucción como "envía el acuerdo de confidencialidad a jane@acme.com" se resuelve sin que tengas que programar esa lógica manualmente.
Esta opción requiere n8n v1.47 o posterior.
Configuración manual: Webhook más HTTP Request
Si tu equipo no utiliza nodos de la comunidad o estás en una versión de n8n anterior a su introducción, puedes conectar Firma.dev directamente a través de la API. Se trata de la misma integración explicada anteriormente, solo que construida con los nodos genéricos de n8n en lugar de los dedicados.
Para el envío, añade un nodo HTTP Request con una credencial de tipo Header Auth llamada Firma API, la cabecera Authorization, tu clave de API como valor, y apúntalo al endpoint de creación y envío:
Se aplica el mismo patrón de borrador y envío: POST /signing-requests para crear un borrador y POST /signing-requests/{id}/send una vez que esté listo para enviarse.
Para reaccionar a documentos firmados, añade un nodo disparador Webhook, copia su URL de producción y pégala en el panel de Firma.dev en Settings > Webhooks junto con los eventos que desees. Enruta la carga útil con un nodo Switch evaluando {{ $json.body.type }} y obtén el archivo firmado desde {{ $json.body.data.signing_request.signed_document_url }} para archivarlo en Google Drive, S3 o Notion. A diferencia del nodo disparador, serás responsable de registrar y eliminar este webhook manualmente cuando cambie un flujo de trabajo.
Firmar dentro de otra aplicación
Si tu flujo finaliza con el firmante completando el documento dentro de tu propio producto en lugar de por correo electrónico, obtén el signing_request_user_id del destinatario a partir de la respuesta de la API e incrusta la interfaz de firma de Firma.dev:
Todo se ejecuta en infraestructura alojada en la UE y genera una pista de auditoría completa, lo que garantiza la validez legal de las automatizaciones que construyas.
📘 Lee la guía completa de integración con n8n
La configuración completa, incluido cada campo del nodo, los detalles de las credenciales y los eventos de webhook, está disponible en la documentación: https://docs.firma.dev/guides/n8n-integration
Primeros pasos
Puedes tener el nodo de Firma.dev instalado y tu primera solicitud de firma enviada en lo que tardas en crear una credencial. Empieza a utilizar Firma.dev gratis, sin necesidad de tarjeta de crédito, y añade firmas electrónicas a los flujos de trabajo que ya utilizas.
Artículos relacionados
Nuestra plataforma está diseñada para capacitar a las empresas de todos los tamaños para trabajar de manera más inteligente y alcanzar sus objetivos con confianza.







