Адресами вебхуков управляет владелец пространства в Настройки, Интеграции, на всех планах. В пространстве может быть до 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, вставьте адрес и отметьте события.
- Нажмите Сохранить адрес, а затем Отправить проверку, чтобы отправить пробное событие на новый адрес.