Адресами вебхуків керує власник простору в Налаштування, Інтеграції, на всіх планах. Простір може мати до 10 адрес. Для токена API на тій самій сторінці потрібен план «Про», «Команда» або «Корпоративний». Докладніше: API та розробники.
Slack
- У Slack відкрийте
Apps, потімIncoming Webhooks, натиснітьAdd to Slack, виберіть канал і скопіюйте адресу, яку дає Slack. - У VG·Sign у розділі Адреси вебхуків натисніть Додати адресу й виберіть Slack.
- Вставте адресу в поле Адреса отримання. Це має бути адреса
hooks.slack.com. Назва (необов’язково) допоможе розрізняти адреси. - Позначте потрібні події, натисніть Зберегти адресу, а потім Надіслати перевірку. Перевірка надходить протягом хвилини.
Кожне повідомлення називає подію та комплект і містить посилання на його журнал аудиту у VG·Sign.
Microsoft Teams
- У Teams відкрийте
Workflowsі виберітьPost to a channel when a webhook request is received. Power Automate дасть вам адресу. - У VG·Sign натисніть Додати адресу й виберіть Microsoft Teams.
- Вставте адресу. Це має бути адреса потоку на
logic.azure.com. Урядові середовища наlogic.azure.usне приймаються. - Позначте події, натисніть Зберегти адресу й Надіслати перевірку.
VG·Sign надсилає адаптивну картку, яку потік публікує в каналі.
Вебхуки
Виберіть Адреса HTTPS, щоб отримувати події у власній системі.
- Адреса має використовувати https і бути доступною з інтернету. Локальні адреси та адреси приватних мереж не приймаються.
- Є 19 типів подій у трьох групах: «Життя комплекту», «Дії одержувачів» та «Особа». Нова адреса починає з позначених подій «Надіслано одержувачам», «Завершено», «Відхилено» та «Скасовано». Події з позначкою Часто можуть траплятися багато разів для одного комплекту.
- Після збереження ключ з’являється в розділі Секретний ключ, показується один раз. Скопіюйте його одразу. Замінити ключ створює новий.
- Кожна доставка є запитом POST із JSON і заголовком
X-VG-Signature, деsha256=стоїть перед HMAC-SHA256 необробленого тіла, обчисленим із цим ключем, а також заголовкомX-VG-Delivery-Id, який не змінюється під час повторів. - Невдалу доставку повторюють до 3 разів, а потім позначають як невдалу. Останні п’ять доставок показано під кожною адресою, а невдала має кнопку Надіслати знову. Призупинити зупиняє доставки, не видаляючи адресу.
Вміст доставки описано на сторінці Вебхуки.
Zapier, Make та n8n
Ці інструменти підключаються через вебхук: кожен може запускати робочий процес за адресою отримання, яку VG·Sign вважає звичайною адресою HTTPS.
- У Zapier, Make або n8n почніть робочий процес із запуску через вебхук і скопіюйте його адресу.
- У VG·Sign натисніть Додати адресу, залиште Адреса HTTPS, вставте адресу й позначте події.
- Натисніть Зберегти адресу, а потім Надіслати перевірку, щоб надіслати пробну подію на нову адресу.