Automatisez vos signatures avec n8n
n8n est la plateforme d'automatisation open source que l'on peut héberger soi-même. Certyneo s'y branche avec les nœuds natifs Webhook et HTTP Request : rien à installer, rien à faire valider par une marketplace. Importez notre workflow prêt à l'emploi, collez votre clé API, et vos événements de signature pilotent le reste de votre stack.
Aucun nœud communautaire à installer : l'intégration repose uniquement sur les nœuds livrés avec n8n, donc elle fonctionne aussi sur n8n Cloud, où les nœuds tiers sont restreints.
Pourquoi connecter Certyneo à n8n
n8n vous laisse le choix : le service géré, ou votre propre serveur. Dans les deux cas, l'intégration Certyneo utilise l'API publique et les webhooks, sans intermédiaire propriétaire entre vos contrats et vos outils.
Les 11 événements, pas quatre
Le nœud Webhook reçoit l'intégralité du cycle de vie des enveloppes — création, envoi, ouverture, signature, refus, annulation, expiration, retour à l'expéditeur. Aucun déclencheur n'est laissé de côté, contrairement aux connecteurs à liste figée.
Toute l'API, sans attendre
Le nœud HTTP Request appelle n'importe quel point d'entrée de l'API Certyneo dès qu'il existe : créer une enveloppe, l'envoyer, déposer un document, récupérer le PDF signé ou le dossier de preuve.
Auto-hébergement possible
Sur une instance n8n que vous hébergez, les métadonnées de vos contrats ne transitent par aucun tiers : le trafic va de votre serveur à Certyneo, et nulle part ailleurs. Un argument de poids pour les équipes juridiques et les DSI.
Clé API et signature HMAC
La connexion s'authentifie par une clé API à portée limitée, révocable à tout moment. Chaque événement entrant est signé en HMAC-SHA256 : votre workflow peut vérifier qu'il vient bien de Certyneo.
Événements disponibles
Abonnez le nœud Webhook aux événements de votre choix. Ils arrivent en temps réel, avec l'en-tête de signature X-Certyneo-Signature à vérifier côté n8n.
| Événement | Se déclenche quand… |
|---|---|
Enveloppe crééeenvelope.created | Une enveloppe vient d'être créée, encore à l'état de brouillon. |
Enveloppe envoyéeenvelope.sent | Une enveloppe quitte le brouillon et part vers ses destinataires. |
Enveloppe signéeenvelope.completed | Tous les destinataires ont signé : l'enveloppe est finalisée, avec un lien de téléchargement du PDF signé. |
Enveloppe refuséeenvelope.declined | Un destinataire refuse de signer, avec le motif qu'il a indiqué. |
Enveloppe annuléeenvelope.voided | L'expéditeur annule une enveloppe déjà partie : les liens de signature deviennent inutilisables. |
Enveloppe expiréeenvelope.expired | La date limite est passée sans que tous les destinataires aient signé. |
Enveloppe renvoyée à l'expéditeurenvelope.returned_to_sender | Un destinataire renvoie l'enveloppe pour correction au lieu de la signer. |
Enveloppe resoumiseenvelope.resubmitted | L'expéditeur corrige puis renvoie une enveloppe qui lui avait été retournée. |
Destinataire a signérecipient.signed | Un destinataire termine sa signature. Se déclenche une fois par signataire, pas seulement à la fin. |
Destinataire a ouvertrecipient.viewed | Un destinataire ouvre l'enveloppe pour la première fois — utile pour relancer au bon moment. |
Destinataire a approuvérecipient.approved | Un destinataire dont le rôle est « approbateur » valide l'enveloppe sans y apposer de signature. |
Ce que vous pouvez piloter
Chaque ligne est un appel du nœud HTTP Request, avec l'authentification Header Auth et votre clé Certyneo.
Créer une enveloppe
POST /envelopes — compose une enveloppe depuis un modèle Certyneo ou des documents déjà déposés, avec ses destinataires.
Envoyer l'enveloppe
POST /envelopes/:id/send — sort l'enveloppe du brouillon et envoie les invitations à signer.
Lister les enveloppes
GET /envelopes — liste paginée, les plus récentes en premier, avec un filtre de statut optionnel.
Déposer un document
POST /documents — envoie un PDF depuis n'importe quel nœud n8n, y compris une pièce jointe d'e-mail ou un fichier Drive.
Lister les modèles
GET /templates — récupère les identifiants de vos modèles pour ne pas avoir à les coder en dur dans le workflow.
Télécharger le PDF signé
GET /envelopes/:id/signed-document — récupère le document signé, et /audit-trail pour le dossier de preuve.
Mettre en place l'intégration
Le workflow que nous fournissons contient déjà le webhook, l'aiguillage par événement, l'appel d'abonnement et un exemple d'envoi. Comptez cinq minutes.
- 1
Importer le workflow
Dans n8n, ouvrez le menu du workflow puis « Import from URL… » et collez l'adresse de notre modèle. Vous pouvez aussi télécharger le fichier et le déposer sur le canevas.
- 2
Générer votre clé API
Ouvrez Certyneo → Réglages → API REST et créez une clé avec les portées enveloppes et webhooks. Copiez-la : elle n'est affichée qu'une seule fois.
- 3
Créer l'identifiant Header Auth
Dans n8n, ajoutez un identifiant « Header Auth » : nom « Authorization », valeur « Bearer » suivi de votre clé. Sélectionnez-le sur les nœuds HTTP Request du workflow.
- 4
Abonner puis activer
Copiez l'URL de production du nœud Webhook, collez-la dans l'appel d'abonnement, exécutez-le une fois, puis activez le workflow. Conservez le « secret » renvoyé : il sert à vérifier la signature des événements.
Sécurité et conformité
L'intégration n8n repose sur l'API publique Certyneo, avec le même niveau d'exigence que le reste de la plateforme.
- Échanges chiffrés en HTTPS de bout en bout.
- Clés API à portée limitée : accordez uniquement les droits nécessaires.
- Chaque événement est signé en HMAC-SHA256 — vérifiez-le avant d'agir dessus.
- Révocation d'une clé à tout moment depuis votre tableau de bord.
Questions fréquentes
Faut-il installer un nœud Certyneo dans n8n ?
Non, et c'est volontaire. Les nœuds Webhook et HTTP Request livrés avec n8n couvrent l'intégralité de notre API : un paquet dédié n'ajouterait qu'une dépendance à mettre à jour. Comme rien n'est à installer, l'intégration fonctionne aussi sur n8n Cloud, où les nœuds communautaires sont restreints.
Quel abonnement Certyneo faut-il pour utiliser n8n ?
Une clé réelle (sk_live_…) nécessite une offre incluant l'accès API (Standard et plus). Les offres Gratuit et Personnel disposent d'une clé bac à sable (sk_test_…) pour dérouler tout le parcours sur des enveloppes de test, sans e-mail envoyé aux signataires.
Comment obtenir ma clé API ?
Depuis Certyneo, allez dans Réglages → API REST et créez une clé avec les portées envelopes:read, envelopes:write et webhooks:write. Elle commence par sk_live_ (ou sk_test_ pour le bac à sable) et n'est affichée qu'une seule fois : copiez-la immédiatement.
Cela fonctionne-t-il sur une instance n8n auto-hébergée ?
Oui, et c'est le cas d'usage le plus intéressant. Votre instance doit simplement être joignable depuis Internet pour recevoir nos webhooks : une URL publique en HTTPS suffit. Aucune donnée ne transite alors par un service tiers.
Quels événements de signature sont couverts ?
Les onze événements du cycle de vie : enveloppe créée, envoyée, signée, refusée, annulée, expirée, retournée à l'expéditeur, resoumise, et destinataire ayant ouvert, signé ou approuvé. Vous choisissez ceux auxquels vous vous abonnez.
Comment vérifier qu'un événement vient bien de Certyneo ?
Chaque livraison porte un en-tête X-Certyneo-Signature qui contient le HMAC-SHA256 du corps de la requête, calculé avec le secret renvoyé à la création de l'abonnement. Comparez-le dans un nœud Code avant de traiter l'événement.
L'intégration n8n est-elle payante ?
Certyneo ne facture pas de supplément. Côté n8n, une instance auto-hébergée est gratuite ; sur n8n Cloud, chaque exécution consomme le quota de votre forfait.
Aller plus loin
Automatisez vos contrats dès aujourd'hui
Importez le workflow, collez votre clé API, et laissez vos signatures déclencher le reste.