Інтеграції

Під’єднайте VG·Sign до своїх інструментів.

Публікуйте події комплектів у каналі Slack або Microsoft Teams чи надсилайте підписаний JSON на будь-яку адресу HTTPS, зокрема Zapier, Make та n8n. Усе це налаштовується в розділі «Налаштування», у підрозділі «Інтеграції».

На цій сторінці

Адресами вебхуків керує власник простору в Налаштування, Інтеграції, на всіх планах. Простір може мати до 10 адрес. Для токена API на тій самій сторінці потрібен план «Про», «Команда» або «Корпоративний». Докладніше: API та розробники.

Slack

  1. У Slack відкрийте Apps, потім Incoming Webhooks, натисніть Add to Slack, виберіть канал і скопіюйте адресу, яку дає Slack.
  2. У VG·Sign у розділі Адреси вебхуків натисніть Додати адресу й виберіть Slack.
  3. Вставте адресу в поле Адреса отримання. Це має бути адреса hooks.slack.com. Назва (необов’язково) допоможе розрізняти адреси.
  4. Позначте потрібні події, натисніть Зберегти адресу, а потім Надіслати перевірку. Перевірка надходить протягом хвилини.

Кожне повідомлення називає подію та комплект і містить посилання на його журнал аудиту у VG·Sign.

Microsoft Teams

  1. У Teams відкрийте Workflows і виберіть Post to a channel when a webhook request is received. Power Automate дасть вам адресу.
  2. У VG·Sign натисніть Додати адресу й виберіть Microsoft Teams.
  3. Вставте адресу. Це має бути адреса потоку на logic.azure.com. Урядові середовища на logic.azure.us не приймаються.
  4. Позначте події, натисніть Зберегти адресу й Надіслати перевірку.

VG·Sign надсилає адаптивну картку, яку потік публікує в каналі.

Вебхуки

Виберіть Адреса HTTPS, щоб отримувати події у власній системі.

  • Адреса має використовувати https і бути доступною з інтернету. Локальні адреси та адреси приватних мереж не приймаються.
  • Є 19 типів подій у трьох групах: «Життя комплекту», «Дії одержувачів» та «Особа». Нова адреса починає з позначених подій «Надіслано одержувачам», «Завершено», «Відхилено» та «Скасовано». Події з позначкою Часто можуть траплятися багато разів для одного комплекту.
  • Після збереження ключ з’являється в розділі Секретний ключ, показується один раз. Скопіюйте його одразу. Замінити ключ створює новий.
  • Кожна доставка є запитом POST із JSON і заголовком X-VG-Signature, де sha256= стоїть перед HMAC-SHA256 необробленого тіла, обчисленим із цим ключем, а також заголовком X-VG-Delivery-Id, який не змінюється під час повторів.
  • Невдалу доставку повторюють до 3 разів, а потім позначають як невдалу. Останні п’ять доставок показано під кожною адресою, а невдала має кнопку Надіслати знову. Призупинити зупиняє доставки, не видаляючи адресу.

Вміст доставки описано на сторінці Вебхуки.

Zapier, Make та n8n

Ці інструменти підключаються через вебхук: кожен може запускати робочий процес за адресою отримання, яку VG·Sign вважає звичайною адресою HTTPS.

  1. У Zapier, Make або n8n почніть робочий процес із запуску через вебхук і скопіюйте його адресу.
  2. У VG·Sign натисніть Додати адресу, залиште Адреса HTTPS, вставте адресу й позначте події.
  3. Натисніть Зберегти адресу, а потім Надіслати перевірку, щоб надіслати пробну подію на нову адресу.

Назад до довідки

  • Створюйте з тих самих елементів, що й ми.

    API REST від VG·Sign створює, надсилає та відстежує комплекти за допомогою токена простору. Він входить до планів «Про», «Команда» та «Корпоративний», а повна довідка є на сторінці API.

    Читати
  • Підготуйте один раз, надсилайте завжди.

    Шаблон зберігає документи комплекту, розміщення полів і ролі підписання. Введіть імена й електронні адреси, щоб створити з нього новий комплект, або надішліть окремий комплект для кожного рядка файлу CSV.

    Читати