Автоматизирайте вашите подписи с n8n
n8n е платформата за автоматизация с отворен код, която можете да хостирате сами. Два пътя към Certyneo: импортирайте нашия готов за употреба workflow, който използва само възлите Webhook и HTTP Request, доставени с n8n и не изисква никаква инсталация, или инсталирайте общностния възел n8n-nodes-certyneo, ако предпочитате възел Certyneo в панела си. И в двата случая залепете вашия API ключ и вашите събития за подписване управляват останалата част от вашия stack.
Workflow-ът не изисква никаква инсталация: използва само възлите, доставени с n8n, така че функционира навсякъде, включително на n8n Cloud. Общностният възел n8n-nodes-certyneo е публикуван на npm и се инсталира от Settings → Community nodes на самохостирана инстанция; n8n Cloud предлага само възлите, които n8n е проверил.
Защо да свържете Certyneo с n8n
n8n ви оставя избор: управляваната услуга или вашия собствен сървър. И в двата случая интеграцията на Certyneo използва публичния API и webhooks, без собствен посредник между вашите договори и вашите инструменти.
11 събития, не четири
Възелът Webhook получава целия жизнен цикъл на пликовете — създаване, изпращане, отваряне, подпис, отказ, отмяна, изтичане, връщане към изпращача. Нито един спусък не е пропуснат, за разлика от съединителите с фиксиран списък.
Целият API, без чакане
Възелът HTTP Request извиква всяка точка входа на API Certyneo веднага щом съществува: създаване на плик, изпращането му, вложуване на документ, получаване на подписания PDF или папката с доказателство.
Възможен е самостоятелен хостинг
На инстанция n8n, която хоствате, метаданните на вашите договори не преминават през никой трети: трафикът идва от вашия сървър към Certyneo и никъде другаде. Силен аргумент за юридическите екипи и CIO.
API ключ и HMAC подпис
Връзката се удостоверява чрез API ключ с ограничен обхват, отзовав по всяко време. Всяко входящо събитие е подписано в HMAC-SHA256: вашият workflow може да проверри, че идва от 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 — извлича идентификаторите на вашите шаблони, за да не е необходимо да ги кодирате в работния процес.
Изтегляне на подписания PDF
GET /envelopes/:id/signed-document — извлича подписания документ, и /audit-trail за папката с доказателства.
Наложете интеграцията
Работния процес, който предоставяме, вече съдържа webhook, маршрутизацията по събитие, абонаментното повикване и пример за изпращане. Очаквайте пет минути.
- 1
Импортиране на работния процес
В n8n отворете меню на работния процес, след това « Import from URL… » и поставете адреса на нашия шаблон. Можете също да изтеглите файла и да го пуснете върху платното.
- 2
Генерирайте вашата API ключа
Отворете Certyneo → Настройки → API REST и създайте ключ с обхвати за пликове и вебхукове. Копирайте го: той се показва само един път.
- 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?
Това не е задължително. Workflow-ът, който публикуваме, използва само възлите Webhook и HTTP Request, доставени с n8n: нищо за инсталиране и функционира еднакво добре на n8n Cloud. Общностният възел съществува, ако го предпочитате — n8n-nodes-certyneo на npm, с възел за действие, възел за спусък и неговия идентификатор — и се инсталира от Settings → Community nodes на самохостирана инстанция. Документацията на n8n запазва n8n Cloud за възлите, които е проверила.
Кой абонамент Certyneo е необходим за използване на n8n?
Реален ключ (sk_live_…) изисква план, включващ API достъп (Standard и по-горе). Планите Free и Personal имат тестов ключ (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, всяко изпълнение консумира квотата на вашия пакет.
Да отидем по-далеч
Автоматизирайте вашия контракт днес
Импортирайте работния поток, вставете вашия API ключ и позволете вашите подписи да задействат останалото.