Añada firmas electrónicas a cualquier flujo de trabajo de n8n con Firma.dev

n8n es el lugar donde muchos equipos ya ejecutan la lógica de sus contratos: llega un formulario, un trato cambia de etapa, llega una fecha de renovación y se activa un flujo de trabajo. La pieza que falta suele ser la propia firma. Firma.dev ahora ofrece un nodo comunitario dedicado n8n-nodes-firma con 83 operaciones, un desencadenador que gestiona sus propios webhooks y una herramienta integrada para el agente de IA de n8n, por lo que rara vez necesitará volver a conectar manualmente un nodo de solicitud HTTP.

Debido a que Firma.dev cobra por sobre a 0,049 € (~5¢ USD) sin licencias de usuario ni mínimos mensuales, se adapta especialmente bien al envío automatizado. Cuando un flujo de trabajo envía cincuenta contratos de renovación de la noche a la mañana, usted paga por cincuenta sobres, no por un nivel de tarifa al que haya escalado. Esa es la diferencia entre una automatización que ahorra dinero y una automatización que silenciosamente acumula una factura.

Esta publicación cubre cuatro formas de conectar Firma.dev en n8n: el nodo dedicado para enviar y gestionar documentos, el nodo desencadenador para reaccionar a contratos firmados, Firma.dev como herramienta para el agente de IA y una configuración manual de Webhook más solicitud HTTP si prefiere evitar por completo los nodos comunitarios.

Camino 1: instalar el nodo 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 la solicitud y la paginación por usted, con campos desplegables en lugar de JSON sin procesar.

Desde el editor de flujos de trabajo, haga clic en el + para añadir un nodo, busque "Firma" y seleccione Instalar en Nodos comunitarios. El nodo se instala y se coloca en su lienzo en un solo paso. Si prefiere instalarlo con anticipación, vaya a Ajustes > Nodos comunitarios, haga clic en Instalar e introduzca n8n-nodes-firma. Las instancias autohospedadas también pueden instalarlo manualmente:

cd ~/.n8n/nodes && npm install n8n-nodes-firma

cd ~/.n8n/nodes && npm install n8n-nodes-firma

cd ~/.n8n/nodes && npm install n8n-nodes-firma

Reinicie n8n después de una instalación manual.

A continuación, configure las credenciales. Haga clic en Credenciales en la barra lateral, añada una nueva y busque Firma API. Necesitará su clave de API de los Ajustes del espacio de trabajo > API y, opcionalmente, un secreto de webhook de los Ajustes del espacio de trabajo > Webhooks si tiene previsto validar los eventos entrantes más adelante. Deje el campo Entorno configurado en Producción.

El nodo cubre 83 operaciones en recursos que incluyen Solicitud de firma, Plantilla, Webhook, Espacio de trabajo, Empresa, Dominio y Plantilla de correo electrónico, por lo que la mayoría de los flujos de trabajo nunca necesitan salir de él. Un envío típico tiene este aspecto:

1. Añada un nodo Firma y seleccione su credencial de Firma API

2. Establezca el Recurso en Solicitud de firma y la Operación en Crear y enviar

3. Establezca el Origen del documento en Plantilla e introduzca su ID de plantilla

4. En Destinatarios, añada el correo electrónico del firmante, el nombre, el cargo y el orden utilizando expresiones como {{ $json.signer_email }}

La respuesta incluye el id de la nueva solicitud de firma, que puede registrar o pasar al siguiente paso. Para flujos de aprobación, utilice la operación Crear para guardar un borrador, inserte un paso de aprobación o espera y luego llame a Enviar una vez que se haya aprobado.

Una cosa que vale la pena señalar antes de conectar esto a un flujo de trabajo con mucho movimiento: las operaciones de escritura de Firma (Crear, Crear y enviar, Enviar y Reenviar) no llevan una clave de idempotencia. Si un nodo vuelve a intentarlo automáticamente tras un tiempo de espera, puede terminar enviando el mismo contrato dos veces, y ambas copias son legalmente vinculantes una vez firmadas. Desactive la opción Reintentar en caso de fallo en estas operaciones y gestione los reintentos con su propia lógica si los necesita.

Camino 2: reaccionar a documentos firmados con el nodo Firma Trigger

El nodo desencadenador hace algo que un nodo Webhook genérico no puede hacer: registra y cancela el registro del webhook con Firma.dev automáticamente cuando activa o desactiva el flujo de trabajo. No hay ningún paso del que acordarse en el panel de control y no queda nada residual si desactiva un flujo de trabajo.

Añada un nodo Firma Trigger a un nuevo flujo de trabajo, seleccione su credencial de Firma API y elija qué eventos desea escuchar en Eventos, como Solicitud de firma completada o Destinatario de solicitud de firma rechazado. Puede limitar el desencadenador a un único ID de espacio de trabajo si ejecuta varios. Al activar el flujo de trabajo, se crea el webhook que apunta a su instancia de n8n; al desactivarlo, se elimina, y los webhooks huérfanos de ejecuciones anteriores se detectan y se reutilizan en lugar de duplicarse.

El desencadenador cubre los 27 eventos de webhook de Firma.dev en solicitudes de firma, destinatarios, plantillas, espacios de trabajo y dominios. Enrútelos con un nodo Switch en {{ $json.type }}:

• signing_request.completed actualiza su CRM e inicia la prestación del servicio

• signing_request.recipient.declined notifica a ventas

• signing_request.expired vuelve a enviar o mueve el trato a perdido

Si añadió un secreto de webhook a su credencial, el desencadenador valida el encabezado X-Firma-Signature con HMAC-SHA256 automáticamente, incluido el encabezado de período de gracia utilizado durante la rotación de secretos. Las solicitudes que no superan la validación se rechazan antes de llegar a la lógica de su flujo de trabajo. Para ver en detalle cómo se asignan los eventos de webhook a los espacios de trabajo multiinquilino, consulte la guía de webhooks del espacio de trabajo.

Si su siguiente paso es archivar el documento finalizado automáticamente, el tutorial de Google Drive cubre exactamente esa compilación de cuatro pasos, desde el desencadenador hasta la subida, en una guía dedicada.

La API de webhook de Firma.dev requiere HTTPS. n8n Cloud se encarga de eso por usted; 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. Y los webhooks todavía deben estar activados en el panel de control de Firma.dev en Ajustes del espacio de trabajo > Webhooks. El botón Probar de cada webhook omite ese interruptor principal, por lo que una prueba exitosa no garantiza que los eventos reales estén fluyendo.

Camino 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 del agente de IA, sin necesidad de configuración HTTP personalizada. En un flujo de trabajo del agente de IA, añada un nodo Firma como entrada de herramienta, seleccione su credencial y elija el recurso y la operación que desea exponer, como Solicitud de firma > Crear y enviar.

Exponga más de una operación si desea que el agente tenga opciones reales en lugar de una sola herramienta. Una combinación común es Plantilla > Listar, para que el agente pueda buscar la plantilla correcta por sí mismo, junto con Solicitud de firma > Crear y enviar para despacharla y Solicitud de firma > Obtener para comprobar el estado cuando se le solicite. El agente decide a qué herramienta llamar en función de la conversación, por lo que una solicitud como "enviar el acuerdo de confidencialidad a jane@acme.com" se resuelve sin que usted tenga que escribir esa lógica a mano.

Este camino requiere n8n v1.47 o posterior.

Configuración manual: Webhook más solicitud HTTP

Si su equipo evita los nodos comunitarios, o si utiliza una versión de n8n anterior a estos, de todos modos puede conectar Firma.dev directamente a la API. Esta es la misma integración que la anterior, solo que montada a partir de los nodos genéricos de n8n en lugar de los dedicados.

Para el envío, añada un nodo HTTP Request con una credencial de autenticación de encabezado llamada Firma API, encabezado Authorization, valor su clave de API, y apúntelo al extremo de creación y envío:

POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/create-and-send

POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/create-and-send

POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/create-and-send

{
  "template_id": "{{ $json.template_id }}",
  "recipients": [
    {
      "first_name": "{{ $json.signer_first_name }}",
      "last_name": "{{ $json.signer_last_name }}",
      "email": "{{ $json.signer_email }}",
      "designation": "Signer",
      "order": 1
    }
  ]
}

{
  "template_id": "{{ $json.template_id }}",
  "recipients": [
    {
      "first_name": "{{ $json.signer_first_name }}",
      "last_name": "{{ $json.signer_last_name }}",
      "email": "{{ $json.signer_email }}",
      "designation": "Signer",
      "order": 1
    }
  ]
}

{
  "template_id": "{{ $json.template_id }}",
  "recipients": [
    {
      "first_name": "{{ $json.signer_first_name }}",
      "last_name": "{{ $json.signer_last_name }}",
      "email": "{{ $json.signer_email }}",
      "designation": "Signer",
      "order": 1
    }
  ]
}

Se aplica el mismo patrón de borrador y envío: POST /signing-requests para crear un borrador, POST /signing-requests/{id}/send una vez que esté listo para enviarse.

Para reaccionar a los documentos firmados, añada un nodo desencadenador de tipo Webhook, copie su URL de producción y péguela en el panel de control de Firma.dev en Ajustes > Webhooks junto con los eventos que desee. Enrute la carga útil con un nodo Switch en {{ $json.body.type }} y extraiga el archivo firmado de {{ $json.body.data.signing_request.signed_document_url }} para archivarlo en Google Drive, S3 o Notion. A diferencia del nodo desencadenador, usted es responsable de registrar y eliminar este webhook por sí mismo cuando un flujo de trabajo cambie.

Firma dentro de otra aplicación

Si su flujo termina con el firmante completando el documento dentro de su propio producto en lugar de por correo electrónico, extraiga el signing_request_user_id del destinatario de la respuesta de la API e integre la interfaz de usuario de firma de Firma.dev:

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Document Signing"
></iframe>

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Document Signing"
></iframe>

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Document Signing"
></iframe>

Todo se ejecuta en infraestructura alojada en la UE y produce un registro de auditoría completo, por lo que la automatización que cree seguirá siendo defendible.

📘 Lea la guía de integración completa de n8n
La configuración completa, que incluye cada campo de nodo, detalle de credencial y evento de webhook, se encuentra en la documentación: https://docs.firma.dev/guides/n8n-integration

Primeros pasos

Puede tener el nodo Firma.dev instalado y su primera solicitud de firma enviada en el tiempo que lleva crear una credencial. Comience a usar Firma.dev de forma gratuita, sin necesidad de tarjeta de crédito, y añada firmas electrónicas a los flujos de trabajo que ya ejecuta.