Automatiza tus firmas con n8n
n8n es la plataforma de automatización de código abierto que puedes alojar tú mismo. Certyneo se conecta a ella con los nodos nativos Webhook y HTTP Request: nada que instalar, nada que validar en un marketplace. Importa nuestro workflow listo para usar, pega tu clave API, y tus eventos de firma pilotan el resto de tu stack.
Ningún nodo comunitario que instalar: la integración se basa únicamente en los nodos incluidos con n8n, por lo que también funciona en n8n Cloud, donde los nodos de terceros están restringidos.
Por qué conectar Certyneo a n8n
n8n te deja elegir: el servicio gestionado, o tu propio servidor. En ambos casos, la integración Certyneo utiliza la API pública y los webhooks, sin intermediarios propietarios entre tus contratos y tus herramientas.
Los 11 eventos, no cuatro
El nodo Webhook recibe todo el ciclo de vida de los sobres — creación, envío, apertura, firma, rechazo, cancelación, expiración, devolución al remitente. Ningún desencadenante se deja de lado, a diferencia de los conectores con lista fija.
Toda la API, sin esperar
El nodo HTTP Request llama a cualquier punto de entrada de la API Certyneo tan pronto como existe: crear un sobre, enviarlo, depositar un documento, recuperar el PDF firmado o la carpeta de prueba.
Auto-alojamiento posible
En una instancia n8n que alojas, los metadatos de tus contratos no pasan por ningún tercero: el tráfico va de tu servidor a Certyneo, y a ningún otro lugar. Un argumento de peso para equipos legales y CISOs.
Clave API y firma HMAC
La conexión se autentica mediante una clave API de alcance limitado, revocable en cualquier momento. Cada evento entrante se firma en HMAC-SHA256: tu workflow puede verificar que viene realmente de Certyneo.
Eventos disponibles
Suscribe el nodo Webhook a los eventos que elijas. Llegan en tiempo real, con el encabezado de firma X-Certyneo-Signature para verificar en n8n.
| Evento | Se dispara cuando… |
|---|---|
Sobre creadoenvelope.created | Un sobre acaba de ser creado, aún en estado de borrador. |
Sobre enviadoenvelope.sent | Un sobre sale del borrador y se envía a sus destinatarios. |
Sobre firmadoenvelope.completed | Todos los destinatarios han firmado: la envoltura está finalizada, con un enlace de descarga del PDF firmado. |
Sobre rechazadoenvelope.declined | Un destinatario se niega a firmar, con el motivo que ha indicado. |
Sobre canceladoenvelope.voided | El remitente cancela un sobre ya enviado: los enlaces de firma se vuelven inutilizables. |
Sobre expiradoenvelope.expired | La fecha límite ha pasado sin que todos los destinatarios hayan firmado. |
Sobre devuelto al remitenteenvelope.returned_to_sender | Un destinatario devuelve el sobre para corrección en lugar de firmarlo. |
Sobre reenviadoenvelope.resubmitted | El remitente corrige y reenvía un sobre que le había sido devuelto. |
Destinatario ha firmadorecipient.signed | Un destinatario completa su firma. Se dispara una vez por firmante, no solo al final. |
Destinatario ha abiertorecipient.viewed | Un destinatario abre el sobre por primera vez — útil para hacer seguimiento en el momento adecuado. |
Destinatario ha aprobadorecipient.approved | Un destinatario cuyo rol es «aprobador» valida el sobre sin estampar una firma en él. |
Lo que puede controlar
Cada línea es una llamada del nodo HTTP Request, con la autenticación Header Auth y su clave Certyneo.
Crear un sobre
POST /envelopes — compone un sobre a partir de una plantilla Certyneo o de documentos ya depositados, con sus destinatarios.
Enviar el sobre
POST /envelopes/:id/send — saca el sobre del borrador y envía las invitaciones para firmar.
Listar sobres
GET /envelopes — lista paginada, las más recientes primero, con un filtro de estado opcional.
Depositar un documento
POST /documents — envía un PDF desde cualquier nodo n8n, incluyendo un adjunto de correo electrónico o un archivo Drive.
Listar las plantillas
GET /templates — recupera los identificadores de sus plantillas para no tener que codificarlos de forma permanente en el flujo de trabajo.
Descargar el PDF firmado
GET /envelopes/:id/signed-document — recupera el documento firmado, y /audit-trail para el expediente de prueba.
Configurar la integración
El workflow que proporcionamos ya contiene el webhook, el enrutamiento por eventos, la llamada de suscripción y un ejemplo de envío. Cuente cinco minutos.
- 1
Importar el workflow
En n8n, abra el menú del workflow y luego « Import from URL… » y pegue la dirección de nuestra plantilla. También puede descargar el archivo y soltarlo en el lienzo.
- 2
Genera tu clave API
Abra Certyneo → Configuración → API REST y cree una clave con los alcances envolturas y webhooks. Cópiela: solo se muestra una sola vez.
- 3
Crear el identificador Header Auth
En n8n, agregue un identificador « Header Auth »: nombre « Authorization », valor « Bearer » seguido de su clave. Selecciónelo en los nodos HTTP Request del workflow.
- 4
Suscribirse y activar
Copie la URL de producción del nodo Webhook, péguéla en la llamada de suscripción, ejecutéla una vez, luego active el workflow. Conserve el « secret » devuelto: se utiliza para verificar la firma de los eventos.
- 5
Conectar Google Drive
La plantilla deposita el PDF firmado y su prueba de auditoría en su Drive: seleccione su cuenta de Google en los dos nodos de archivo. Puede reemplazarlos por S3, SharePoint u otro almacenamiento, consumen el mismo campo binario.
Seguridad y cumplimiento
La integración n8n se basa en la API pública Certyneo, con el mismo nivel de exigencia que el resto de la plataforma.
- Intercambios cifrados en HTTPS de extremo a extremo.
- Claves API con alcance limitado: otorga solo los derechos necesarios.
- Cada evento se firma en HMAC-SHA256 — verifíquelo antes de actuar sobre él.
- Revocación de una clave en cualquier momento desde tu panel de control.
Preguntas frecuentes
¿Es necesario instalar un nodo Certyneo en n8n?
No, y es deliberado. Los nodos Webhook y HTTP Request incluidos con n8n cubren la totalidad de nuestra API: un paquete dedicado solo añadiría una dependencia que actualizar. Como no hay nada que instalar, la integración también funciona en n8n Cloud, donde los nodos comunitarios son restringidos.
¿Qué suscripción Certyneo se necesita para usar n8n?
Una clave real (sk_live_…) requiere un plan que incluya acceso a la API (Standard y superior). Los planes Gratuito y Personal cuentan con una clave de prueba (sk_test_…) para recorrer todo el proceso con sobres de prueba, sin correo enviado a los firmantes.
¿Cómo obtengo mi clave API?
Desde Certyneo, ve a Configuración → API REST y crea una clave con los alcances envelopes:read, envelopes:write y webhooks:write. Comienza con sk_live_ (o sk_test_ para la prueba) y solo se muestra una vez: cópiala inmediatamente.
¿Funciona esto en una instancia n8n autohospedada?
Sí, y es el caso de uso más interesante. Su instancia simplemente debe ser accesible desde Internet para recibir nuestros webhooks: una URL pública en HTTPS es suficiente. Ningún dato transita entonces por un servicio de terceros.
¿Qué eventos de firma están cubiertos?
Los once eventos del ciclo de vida: sobre creado, enviado, firmado, rechazado, cancelado, expirado, devuelto al remitente, reenvíado, y destinatario que abrió, firmó o aprobó. Usted elige aquellos a los que se suscribe.
¿Cómo verificar que un evento proviene realmente de Certyneo?
Cada entrega lleva un encabezado X-Certyneo-Signature que contiene el HMAC-SHA256 del cuerpo de la solicitud, calculado con el secreto devuelto en la creación de la suscripción. Compárelo en un nodo Code antes de procesar el evento.
¿La integración de n8n es de pago?
Certyneo no cobra ningún suplemento. Por parte de n8n, una instancia autohospedada es gratuita; en n8n Cloud, cada ejecución consume la cuota de su plan.
Ir más allá
Automatice sus contratos hoy mismo
Importe el workflow, pegue su clave API y deje que sus firmas desencadenen el resto.