Интеграции

Подключите 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.

    Читать