使用n8n自动化您的签名
n8n是一个可以自行托管的开源自动化平台。通往Certyneo有两条路：导入我们现成的工作流，它仅使用n8n附带的Webhook和HTTP Request节点，无需任何安装；或者如果您更喜欢在面板中使用Certyneo节点，可以安装社区节点n8n-nodes-certyneo。无论哪种情况，粘贴您的API密钥，您的签名事件将驱动其余堆栈。
该工作流无需任何安装：它仅使用n8n附带的节点，因此无处不在，包括n8n Cloud。社区节点n8n-nodes-certyneo发布在npm上，可在自托管实例上从Settings → Community nodes安装；n8n Cloud仅提供n8n已验证的节点。
为什么要将Certyneo连接到n8n
n8n让您有选择权：托管服务或您自己的服务器。无论哪种情况，Certyneo集成都使用公共API和webhooks，您的合同和工具之间没有专有中介。
11个事件，而不是四个
Webhook节点接收信封的整个生命周期——创建、发送、打开、签署、拒绝、取消、过期、返回给发件人。没有任何触发器被遗漏，这与列表固定的连接器不同。
完整的API，无需等待
HTTP Request 节点调用 Certyneo API 的任何端点，只要存在：创建信封、发送信封、存储文档、获取已签署的 PDF 或证明文件夹。
自主托管成为可能
在您托管的 n8n 实例上，您合同的元数据不会通过任何第三方：流量直接从您的服务器到 Certyneo，不经过其他地方。这对法律团队和信息主管来说是一个重要论据。
API 密钥和 HMAC 签名
连接通过范围有限且随时可撤销的 API 密钥进行身份验证。每个传入事件都由 HMAC-SHA256 签名：您的工作流可以验证它确实来自 Certyneo。
可用事件
将 Webhook 节点订阅到您选择的事件。它们实时到达，带有需要在 n8n 端验证的 X-Certyneo-Signature 签名标头。
| 事件 | Se déclenche quand… |
|---|---|
信封已创建envelope.created | 刚刚创建了一个信封，仍处于草稿状态。 |
信封已发出envelope.sent | 信封离开草稿状态并发送给其收件人。 |
信封已签署envelope.completed | Tous les destinataires ont signé : l'enveloppe est finalisée, avec un lien de téléchargement du PDF signé. |
信封已拒绝envelope.declined | 收件人拒绝签署，并说明了其指定的原因。 |
信封已取消envelope.voided | 发件人取消了已发送的信封：签署链接变为不可用。 |
信封已过期envelope.expired | 截止日期已过，但并非所有收件人都已签署。 |
Enveloppe renvoyée à l'expéditeurenvelope.returned_to_sender | 收件人返回信封要求更正，而不是签署信封。 |
信封重新提交envelope.resubmitted | L'expéditeur corrige puis renvoie une enveloppe qui lui avait été retournée. |
收件人已签署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.
创建信封
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.
列出信封
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.
建立集成
我们提供的工作流已包含 webhook、事件路由、订阅调用和发送示例。预计需要五分钟。
- 1
导入工作流
在 n8n 中，打开工作流菜单，选择「Import from URL…」并粘贴我们模板的地址。您也可以下载文件并将其拖放到画布上。
- 2
生成您的 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
创建 Header Auth 标识符
在 n8n 中，添加一个「Header Auth」标识符：名称为「Authorization」，值为「Bearer」后跟您的密钥。在工作流的 HTTP Request 节点上选择它。
- 4
订阅然后激活
复制 Webhook 节点的生产 URL，将其粘贴到订阅调用中，执行一次，然后激活工作流。保存返回的「secret」：它用于验证事件的签名。
- 5
连接 Google Drive
该模板将签署的 PDF 及其审计证明放在您的 Drive 中：在两个存档节点上选择您的 Google 账户。您可以将它们替换为 S3、SharePoint 或任何其他存储，它们使用相同的二进制字段。
安全与合规性
n8n 集成基于 Certyneo 公共 API，与平台其余部分的要求级别相同。
- 端到端 HTTPS 加密交换。
- Clés API à portée limitée : accordez uniquement les droits nécessaires.
- 每个事件都用 HMAC-SHA256 签署——在对其采取行动前验证它。
- Révocation d'une clé à tout moment depuis votre tableau de bord.
常见问题
Faut-il installer un nœud Certyneo dans n8n ?
Ce n'est pas obligatoire. Le workflow que nous publions n'utilise que les nœuds Webhook et HTTP Request livrés avec n8n : rien à installer, et il fonctionne aussi bien sur n8n Cloud. Un nœud communautaire existe si vous le préférez — n8n-nodes-certyneo sur npm, avec un nœud d'action, un nœud déclencheur et son identifiant — et s'installe depuis Settings → Community nodes sur une instance auto-hébergée. La documentation n8n réserve n8n Cloud aux nœuds qu'elle a vérifiés.
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 ?
从 Certyneo，转到设置 → API REST，并创建一个具有 envelopes:read、envelopes:write 和 webhooks:write 范围的密钥。它以 sk_live_ 开头（或沙箱的 sk_test_），只显示一次：立即复制它。
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.
涵盖了哪些签名事件？
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.
进一步发展
Automatisez vos contrats dès aujourd'hui
导入工作流，粘贴您的 API 密钥，让您的签名触发其余流程。