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

n8n es donde muchos equipos ya ejecutan su lógica de contratos: llega un formulario, un trato cambia de etapa, llega una fecha de renovación y se dispara un flujo de trabajo. La pieza que suele faltar es la firma en sí. Con Firma.dev, añades un nodo de HTTP Request en cualquier flujo de trabajo, almacenas tu clave de API una vez y envías firmas electrónicas legalmente vinculantes sin salir de n8n.

Como Firma.dev factura 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 lanza cincuenta contratos de renovación de la noche a la mañana, pagas por cincuenta sobres, no por una tarifa de nivel superior en la que hayas tenido que entrar. Esa es la diferencia entre la automatización que ahorra dinero y la automatización que, silenciosamente, dispara la factura.

Esta publicación recorre tres formas de conectar Firma.dev en n8n: el nodo HTTP Request para enviar, un activador de Webhook para reaccionar a los documentos firmados y Firma.dev como una herramienta para el AI Agent de n8n.

Camino 1: enviar con el nodo HTTP Request

Este es el camino que necesitan la mayoría de los flujos de trabajo. Almacenas tu clave de API de Firma.dev una vez como credencial y, a continuación, cualquier nodo HTTP Request en cualquier flujo de trabajo puede reutilizarla.

Primero, crea la credencial. En el editor de n8n, abre Credentials, haz clic en Add Credential y elige Header Auth. Nombra la credencial Firma API, establece el header Name como Authorization y pega tu clave de API de Firma.dev como Value. n8n cifra las credenciales con tu clave de instancia, por lo que hacer referencia a la credencial mantiene tu clave fuera del JSON del flujo de trabajo exportado. Nunca pegues la clave directamente en el campo de un nodo.

Ahora añade un nodo de HTTP Request y apúntalo al endpoint de creación y envío, que crea una solicitud de firma a partir de una plantilla y la envía en una sola llamada:

• Method: POST

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

• Authentication: Generic Credential Type, Header Auth, utilizando la credencial Firma API

• Send Body: Activado, JSON

El cuerpo extrae valores de los nodos anteriores con expresiones de n8n:

{
  "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
    }
  ]
}

Conecta ese nodo con lo que sea que impulse el flujo de trabajo. Un activador de formulario (Form Trigger) envía un contrato en el momento en que un cliente lo envía. Un activador de Webhook dispara la solicitud cuando tu aplicación informa de que un contrato cambia de etapa. Un activador de programación (Schedule Trigger) ejecuta un lote nocturno de renovaciones comparándolo con una consulta de la base de datos. La respuesta incluye el id de la nueva solicitud de firma, para que puedas registrarla, almacenarla o hacer referencia a ella más adelante.

Si necesitas un paso de revisión humana antes de que salga algo, crea un borrador con POST /signing-requests, coloca un nodo de Aprobación en medio del flujo de trabajo y luego llama a POST /signing-requests/{id}/send una vez que se apruebe.

Camino 2: reaccionar a los documentos firmados con un activador de Webhook

Enviar es la mitad del bucle. La otra mitad es hacer algo en el momento en que se firma un documento. Añade un nodo de Webhook como activador, establece su método en POST y copia la URL de producción. En el panel de control de Firma.dev, en Settings → Webhooks, añade esa URL y suscríbete a los eventos que te interesen, empezando por signing_request.completed.

De vuelta en n8n, añade un nodo de Switch después del activador y dirígelo a {{ $json.body.type }}. Una firma completada puede actualizar tu CRM e iniciar el aprovisionamiento. Una rechazada puede notificar a ventas. Una caducada puede volver a enviarse o mover el trato a perdido. El documento firmado reside en {{ $json.body.data.signing_request.signed_document_url }}, por lo que puedes pasarlo directamente a un nodo de Google Drive, S3 o Notion y archivarlo sin un paso adicional.

Camino 3: Firma.dev como una herramienta para el AI Agent de n8n

Si ejecutas el nodo de AI Agent, puedes proporcionarle Firma.dev como una herramienta invocable y dejar que decida cuándo enviar. Añade un nodo de HTTP Request Tool como entrada de herramienta, configúralo exactamente como en el Camino 1 y nombra la herramienta send_signing_request. Dale una descripción que le indique al agente cuándo recurrir a ella y define un esquema de entrada con template_id, signer_email, signer_first_name y signer_last_name. El agente ahora enviará contratos directamente a partir de una instrucción en lenguaje natural. Combínalo con una segunda herramienta apuntando a GET /templates si quieres que el agente elija la plantilla correcta por sí mismo.

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, extrae el signing_request_user_id de la respuesta de la API e incrusta la interfaz 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 una infraestructura alojada en la UE y genera un registro de auditoría completo, por lo que la automatización que construyas seguirá siendo defendible.

📘 Lee la guía de integración completa de n8n
La configuración completa, que incluye cada campo de nodo, detalles de credenciales y eventos de webhook, reside en la documentación: https://docs.firma.dev/guides/n8n-integration

Comenzando

Puedes tener el primer camino en funcionamiento en el tiempo que te lleva crear una credencial y un nodo. Empieza con Firma.dev gratis, sin necesidad de tarjeta de crédito, y añade firmas electrónicas a los flujos de trabajo que ya ejecutas.