HoverSignal позволяет легко подключить вебхуки, которые будут уведомлять ваши приложения после появления каждого лида на вашем сайте.

Для интеграции через webhooks, вам нужно использовать ключ API HoverSignal. Чтобы получить его, нажмите «Настройки», затем кликните ниже «Добавить ключ API» по кнопке нужного вам виджета.

Скопируйте этот ключ API и перейдите по адресу https://app.hoversignal.com/docs/ui/index

Вставьте этот ключ API в поле «api_key» и нажмите кнопку «Explore».

Создайте webhook, выберите метод POST для перехвата приложений, отправьте тему и конечный адрес, как показано в примере:

{
"topic": "LeadCreated",
"url": "string"
}

Чтобы гарантировать, что конкретный адрес конечной точки действительно намеревается получать хуки от HoverSignal, подписка использует временный секрет в начальном рукопожатии.

Когда HoverSignal отвечает на ваш первый запрос POST, ответ включает заголовок X-Hook-Secret, в качестве значения которого используется уникальная строка.

Уникальное значение рассчитано для каждой новой подписки.

После получения секрета от HoverSignal вам необходимо вернуть ответ 200 с секретом, включенным в заголовок X-Hook-Secret.

Чтобы доказать подлинность последующих сообщений, HoverSignal использует общий секрет. Вы можете найти его на странице «Настройки».

HoverSignal подписывает сообщение, вычисляя хеш HMAC SHA-256 секрета, добавляя тело запроса и размещение подписи в заголовке X-Hook-Signature.

Вы можете проверить подпись, чтобы узнать, что сообщение является подлинным. Проверка так же проста, как вычисление того же HMAC и сравнение его со значением заголовка X-Hook-Signature.

Обратите внимание, что если вызов вебхука завершится неудачно 5 раз подряд, он будет удален. Также вебхук будет удален после 410 ответа.

Чтобы получить список ваших вебхуков, используйте метод GET.

Для удаления вебхука используйте метод DELETE.

Для получения дополнительной информации см. http://resthooks.org/docs/