Автоматизуйте ваші підписи за допомогою n8n
n8n — це платформа автоматизації з відкритим кодом, яку можна розміщувати самостійно. Два шляхи до Certyneo: імпортуйте наш готовий робочий процес, який використовує лише вузли Webhook і HTTP Request, що постачаються з n8n, і тому не потребує ніякого встановлення, або встановіть вузол спільноти n8n-nodes-certyneo, якщо ви бажаєте вузол Certyneo на панелі. У будь-якому випадку вставте свій ключ API, і ваші події підписання керуватимуть рештою вашого стека.
Робочий процес не потребує встановлення: він використовує лише вузли, що постачаються з n8n, тому працює скрізь, включаючи n8n Cloud. Вузол спільноти n8n-nodes-certyneo опубліковано на npm і встановлюється з Settings → Community nodes на самостійно розміщеній екземплярі; n8n Cloud натомість пропонує лише вузли, які n8n перевірив.
Чому підключити Certyneo до n8n
n8n дає вам вибір: керований сервіс або ваш власний сервер. У будь-якому випадку інтеграція Certyneo використовує публічний API та вебгачки без власного посередника між вашими контрактами та вашими інструментами.
11 подій, а не чотири
Вузол Webhook отримує весь цикл життя конвертів — створення, відправлення, відкриття, підпис, відмова, скасування, закінчення строку, повернення відправнику. Жоден тригер не залишається без уваги, на відміну від сполучників із фіксованим списком.
Весь API без затримок
Вузол HTTP Request викликає будь-яку точку входу API Certyneo, як тільки вона з'явиться: створити конверт, відправити його, завантажити документ, отримати підписаний PDF або папку доказів.
Можливе самостійне розміщення
На екземплярі n8n, який ви розміщуєте, метадані ваших контрактів не передаються жодному третьому боку: трафік йде від вашого сервера до Certyneo і нікуди більше. Вагомий аргумент для юридичних команд і керівників IT.
Ключ API та підпис HMAC
Підключення автентифікується обмеженим ключем API, який можна відкликати будь-коли. Кожна вхідна подія підписується в HMAC-SHA256: ваш робочий процес може перевірити, що вона дійсно з Certyneo.
Доступні события
Підпишіть вузол Webhook на события на ваш вибір. Вони надходять у реальному часі з заголовком підпису X-Certyneo-Signature, який потрібно перевірити на стороні n8n.
| Подія | Викликається, коли… |
|---|---|
Конверт створенийenvelope.created | Конверт щойно створений, все ще у стані чернетки. |
Пакет відправленоenvelope.sent | Конверт залишає чернетку і йде до своїх одержувачів. |
Пакет підписаноenvelope.completed | Усі одержувачі підписали: конверт завершено, з посиланням для завантаження підписаного PDF. |
Пакет відхиленийenvelope.declined | Одержувач відмовляється підписувати з вказаною причиною. |
Конверт скасованийenvelope.voided | Відправник скасовує конверт, який уже був надісланий: посилання для підпису стають непридатними. |
Конверт із закінченим терміном діїenvelope.expired | Дата закінчення пройшла, але не всі одержувачі підписали. |
Конверт повернено відправникуenvelope.returned_to_sender | Одержувач повертає конверт на виправлення замість того, щоб його підписати. |
Конверт повторно поданийenvelope.resubmitted | Відправник виправляє та повторно надсилає конверт, який йому був повернено. |
Отримувач підписавсяrecipient.signed | Отримувач завершує своє підписання. Запускається один раз для кожного підписанта, а не тільки в кінці. |
Одержувач відкривrecipient.viewed | Одержувач відкриває конверт уперше — корисно для напоумінання у потрібний момент. |
Одержувач схваливrecipient.approved | Одержувач, роль якого «затверджувач», затверджує конверт без накладання підпису. |
Адреса недосяжнаrecipient.bounced | Адреса одержувача повертає постійну помилку (скринька не існує, домен мертвий). Повторні спроби припиняються: виправте адресу та повторно надішліть конверт. |
Що ви можете контролювати
Кожен рядок — це виклик вузла HTTP Request з автентифікацією Header Auth та вашим ключем Certyneo.
Створити пакет
POST /envelopes — створює конверт із шаблону Certyneo або вже завантажених документів з його одержувачами.
Надіслати конверт
POST /envelopes/:id/send — виводить конверт із чернеток та надсилає запрошення на підпис.
Перелічити конверти
GET /envelopes — список із розбиттям на сторінки, найновіші спочатку, з опціональним фільтром статусу.
Завантажити документ
POST /documents — надсилає PDF із будь-якого вузла n8n, включаючи вкладення електронного листа або файл Drive.
Список шаблонів
GET /templates — отримує ідентифікатори ваших шаблонів, щоб не потрібно було їх жорстко кодувати у workflow.
Завантажити підписаний PDF
GET /envelopes/:id/signed-document — отримує підписаний документ, а /audit-trail для папки доказів.
Встановити інтеграцію
Робочий процес, який ми надаємо, уже містить webhook, маршрутизацію за подіями, виклик підписки та приклад відправлення. Розраховуйте на п'ять хвилин.
- 1
Імпортувати робочий процес
У n8n відкрийте меню робочого процесу та « Import from URL… » і вставте адресу нашого шаблону. Ви також можете завантажити файл і перетягти його на полотно.
- 2
Створити вашу ключ API
Відкрийте Certyneo → Параметри → API REST і створіть ключ із областями envelopes та webhooks. Скопіюйте його: він відображається лише один раз.
- 3
Створити ідентифікатор Header Auth
У n8n додайте ідентифікатор « Header Auth » : назва « Authorization », значення « Bearer » з подальшим вашим ключем. Виберіть його на вузлах HTTP Request робочого процесу.
- 4
Підписатися та активувати
Скопіюйте URL виробництва вузла Webhook, вставте його у виклик підписки, виконайте його один раз, а потім активуйте робочий процес. Збережіть повернутий « secret » : він служить для перевірки підпису подій.
- 5
Підключити Google Drive
Шаблон розміщує підписаний PDF та його доказ аудиту на вашому Drive: виберіть свій обліковий запис Google на двох вузлах архівування. Ви можете замінити їх на S3, SharePoint або будь-яким іншим сховищем; вони споживають те саме бінарне поле.
Безпека та відповідность
Інтеграція n8n спирається на публічний API Certyneo з тим самим рівнем вимог, що й решта платформи.
- Зашифровані обміни HTTPS наскрізь.
- Ключі API з обмеженим доступом: надавайте лише необхідні права.
- Кожна подія підписана в HMAC-SHA256 — перевіряйте її перед тим, як діяти відповідно до неї.
- Скасування ключа будь-коли з вашої приборної панелі.
Часто задаються питання
Чи потрібно встановлювати вузол Certyneo в n8n ?
Це не обов'язково. Робочий процес, який ми публікуємо, використовує лише вузли Webhook і HTTP Request, що постачаються з n8n: нічого встановлювати, і він працює так само добре на n8n Cloud. Вузол спільноти існує, якщо ви його надаєте перевагу — n8n-nodes-certyneo на npm, з вузлом дії, вузлом тригера та його ідентифікатором — і встановлюється з Settings → Community nodes на самостійно розміщеній екземплярі. Документація n8n резервує n8n Cloud для вузлів, які вона перевірила.
Який абонемент Certyneo потрібен для використання n8n ?
Реальний ключ (sk_live_…) вимагає тарифу, що включає доступ до API (Standard та вище). Тарифи Безплатно та Особистий мають тестовий ключ (sk_test_…) для проходження всього процесу з тестовими конвертами без електронних листів, відправлених підписувачам.
Як отримати моє ключ API?
У Certyneo перейдіть до Параметри → API REST і створіть ключ із областями envelopes:read, envelopes:write та webhooks:write. Він починається з sk_live_ (або sk_test_ для пісочниці) і відображається лише один раз: скопіюйте його негайно.
Це працює на екземплярі n8n, розміщеному власноруч ?
Так, і це найцікавіший сценарій використання. Ваш екземпляр просто має бути доступним з Інтернету для отримання наших webhooks : публічної URL-адреси HTTPS достатньо. Жодні дані не проходять через сторонній сервіс.
Які події підпису охоплені?
Одинадцять подій циклу життя : конверт створений, відправлений, підписаний, відхилений, скасований, спроектував, повернений відправнику, переподаний, а отримувач відкрив, підписав або затвердив. Ви обираєте ті, на які підписуєтеся.
Як перевірити, що подія дійсно походить від Certyneo?
Кожна доставка містить заголовок X-Certyneo-Signature, який містить HMAC-SHA256 тіла запиту, обчислений за допомогою секрету, повернутого при створенні підписки. Порівняйте його у вузлі Code перед обробкою події.
Чи платна інтеграція n8n?
Certyneo не стягує додаткові збори. На стороні n8n самостійно розміщений екземпляр безплатний; на n8n Cloud кожне виконання споживає квоту вашого плану.
Виходити далі
Автоматизуйте ваші договори зараз
Імпортуйте workflow, вставте свій API-ключ і дозвольте своїм підписам запустити решту.