Автоматизируйте свои подписи с помощью 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 и больше нигде. Веский аргумент для юридических отделов и ИТ-директоров.
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 — получает идентификаторы ваших шаблонов, чтобы не нужно было жёстко кодировать их в workflow.
Скачать подписанный PDF
GET /envelopes/:id/signed-document — получает подписанный документ, и /audit-trail для файла доказательства.
Установить интеграцию
Предоставляемый нами рабочий процесс уже содержит webhook, маршрутизацию по событиям, вызов подписки и пример отправки. Отведите пять минут.
- 1
Импортировать рабочий процесс
В n8n откройте меню рабочего процесса, затем « Import from URL… » и вставьте адрес нашего шаблона. Вы также можете скачать файл и перетащить его на холст.
- 2
Сгенерировать ваш API ключ
Откройте Certyneo → Параметры → REST API и создайте ключ с областями конвертов и webhook'ов. Скопируйте его: он отображается только один раз.
- 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 и выше). Планы Free и Personal имеют ключ песочницы (sk_test_…) для прохождения всего процесса на тестовых конвертах без отправки писем подписантам.
Как получить мой API ключ?
В Certyneo перейдите в Réglages → 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 и позвольте вашим подписям запустить остальное.