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 fase, se alcanza una fecha de renovación y se activa un flujo de trabajo. La pieza que suele faltar es la propia firma. Con Firma.dev, solo tienes que soltar un nodo HTTP Request en cualquier flujo de trabajo, guardar tu clave de API una vez y enviar firmas electrónicas legalmente vinculantes sin salir de n8n.

Dado que 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 envía por ráfaga 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 entrado. Esa es la diferencia entre la automatización que ahorra dinero y la automatización que, de forma silenciosa, dispara la factura.

Este post analiza tres formas de conectar Firma.dev en n8n: el nodo HTTP Request para realizar envíos, un activador de Webhook para reaccionar a los documentos firmados y Firma.dev como herramienta para el agente de IA de n8n.

Camino 1: enviar con el nodo HTTP Request

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

En primer lugar, crea la credencial. En el editor de n8n, abre Credentials, haz clic en Add Credential y elige Header Auth. Ponle de nombre a la credencial Firma API, establece el Name de la cabecera en Authorization y pega tu clave de API de Firma.dev como Value. n8n encripta 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 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: On, JSON

El cuerpo extrae valores de los nodos ascendentes 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 a lo que sea que dirija el flujo de trabajo. Un activador Form Trigger envía un contrato en el momento en que un cliente lo envía. Un activador Webhook Trigger inicia la solicitud cuando tu aplicación informa de que un trato cambia de fase. Un activador Schedule Trigger ejecuta un lote nocturno de renovaciones contra una consulta de 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 nada, crea un borrador con POST /signing-requests, suelta un nodo de aprobación en medio del flujo de trabajo y, a continuación, llama a POST /signing-requests/{id}/send una vez que se autorice.

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

Enviar es solo la mitad del ciclo. La otra mitad es hacer algo en el momento en que se firma un documento. Añade un nodo 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 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 al equipo de 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 herramienta para el agente de IA de n8n

Si ejecutas el nodo AI Agent, puedes proporcionarle Firma.dev como una herramienta ejecutable y dejar que decida cuándo realizar el envío. Añade un nodo HTTP Request Tool como entrada de herramienta, configúralo exactamente como en el Camino 1 y ponle de nombre a la herramienta send_signing_request. Dale una descripción que le diga al agente cuándo debe 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 que apunte a GET /templates si quieres que el agente elija la plantilla adecuada por sí solo.

Firmar dentro de otra aplicación

Si tu flujo termina con el firmante completando el documento dentro de tu propio producto en lugar de por correo electrónico, extrae el signing_request_user_id del destinatario de la respuesta de la API e integra 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 construyas seguirá siendo defendible legalmente.

📘 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, se encuentra en la documentación: https://docs.firma.dev/guides/n8n-integration

Primeros pasos

Puedes tener el primer camino funcionando en el tiempo que se tarda en crear una credencial y un nodo. Comienza con Firma.dev de forma gratuita, sin necesidad de tarjeta de crédito, y añade firmas electrónicas a los flujos de trabajo que ya ejecutas.