n8n + AllSign

n8n es una plataforma de automatización open source que te permite crear flujos de trabajo complejos sin código. Integra AllSign para automatizar completamente tus procesos de firma electrónica.

Configuración inicial

1. Instalar n8n

# Usando npm
npm install n8n -g

# Usando Docker
docker run -it --rm --name n8n -p 5678:5678 n8nio/n8n

# Usando n8n Cloud
# Visita https://n8n.cloud

2. Configurar credenciales AllSign

En n8n, ve a Settings → Credentials
Crea nueva credencial tipo HTTP Header Auth
Configura:
- Name: AllSign API
- Header Name: Authorization
- Header Value: Bearer TU_API_KEY_AQUI

Templates disponibles

Crear documento con Base64

Este flujo convierte un PDF a Base64 y lo envía a AllSign para crear un documento.

Importar JSON: Copia el siguiente JSON y pégalo en n8n usando Import from JSON:

{
  "meta": {
    "instanceId": "allsign-create-document"
  },
  "nodes": [
    {
      "parameters": {
        "operation": "binaryToText",
        "options": {
          "encoding": "base64"
        }
      },
      "id": "convert-pdf-base64",
      "name": "Convertir PDF a Base64",
      "type": "n8n-nodes-base.convertToFile",
      "typeVersion": 1,
      "position": [380, 240]
    },
    {
      "parameters": {
        "url": "https://api.enterprise.allsign.io/v1/documents/create_document_base64",
        "authentication": "predefinedCredentialType",
        "nodeCredentialType": "httpHeaderAuth",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Content-Type", 
              "value": "application/json"
            }
          ]
        },
        "sendBody": true,
        "bodyParameters": {
          "parameters": [
            {
              "name": "document_name",
              "value": "={{ $json.document_name || 'Documento desde n8n' }}"
            },
            {
              "name": "description",
              "value": "={{ $json.description || 'Documento creado automáticamente' }}"
            },
            {
              "name": "file_base64",
              "value": "={{ $node['Convertir PDF a Base64'].binary.data.data }}"
            },
            {
              "name": "file_name",
              "value": "={{ $json.file_name || 'documento.pdf' }}"
            }
          ]
        },
        "options": {}
      },
      "id": "create-document-allsign",
      "name": "Crear Documento AllSign",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.1,
      "position": [600, 240]
    }
  ],
  "connections": {
    "Convertir PDF a Base64": {
      "main": [
        [
          {
            "node": "Crear Documento AllSign",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

Flujo completo: Documento + Firmantes + Campos

Template avanzado que crea un documento, añade firmantes y configura campos de firma:

{
  "meta": {
    "instanceId": "allsign-complete-flow"
  },
  "nodes": [
    {
      "parameters": {
        "operation": "binaryToText",
        "options": {
          "encoding": "base64"
        }
      },
      "id": "convert-pdf",
      "name": "1. Convertir PDF",
      "type": "n8n-nodes-base.convertToFile",
      "typeVersion": 1,
      "position": [200, 300]
    },
    {
      "parameters": {
        "url": "https://api.enterprise.allsign.io/v1/documents/create_document_base64",
        "authentication": "predefinedCredentialType",
        "nodeCredentialType": "httpHeaderAuth",
        "sendBody": true,
        "bodyParameters": {
          "parameters": [
            {
              "name": "document_name",
              "value": "={{ $json.document_name }}"
            },
            {
              "name": "file_base64",
              "value": "={{ $node['1. Convertir PDF'].binary.data.data }}"
            },
            {
              "name": "file_name",
              "value": "={{ $json.file_name }}"
            }
          ]
        }
      },
      "id": "create-document",
      "name": "2. Crear Documento",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.1,
      "position": [400, 300]
    },
    {
      "parameters": {
        "url": "=https://api.enterprise.allsign.io/api/documents/{{ $node['2. Crear Documento'].json.document_id }}/send-bulk-invites",
        "authentication": "predefinedCredentialType",
        "nodeCredentialType": "httpHeaderAuth",
        "sendBody": true,
        "bodyParameters": {
          "parameters": [
            {
              "name": "signers",
              "value": "={{ $json.signers }}"
            },
            {
              "name": "email_subject",
              "value": "={{ $json.email_subject }}"
            },
            {
              "name": "send_immediately",
              "value": true
            }
          ]
        }
      },
      "id": "send-invites",
      "name": "3. Enviar Invitaciones",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.1,
      "position": [600, 300]
    }
  ],
  "connections": {
    "1. Convertir PDF": {
      "main": [
        [
          {
            "node": "2. Crear Documento",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "2. Crear Documento": {
      "main": [
        [
          {
            "node": "3. Enviar Invitaciones",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

Configuración de Webhooks

Para recibir notificaciones cuando se complete una firma:

1. Crear webhook en n8n

Añade nodo Webhook
Configura método POST
Copia la URL del webhook

2. Configurar en AllSign

curl -X POST "https://api.enterprise.allsign.io/v1/webhooks" \
  -H "Authorization: Bearer TU_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-n8n.com/webhook/allsign",
    "events": ["document.signed", "document.completed"],
    "active": true
  }'