Глоссарий
Вебхук
Ещё называют: Webhook · HTTP-уведомление · Обратный вызов
Вебхук — это HTTP-запрос, который сервис сам отправляет на ваш адрес, когда происходит событие, чтобы другая система узнала о нём сразу.
Вместо того чтобы постоянно спрашивать сервис «что нового», ваша система ждёт, пока он сам пришлёт событие. Это быстрее и проще.
Хорошие вебхуки подписывают секретом, чтобы получатель мог проверить отправителя, и отправляют повторно, если адрес не ответил.
Как это устроено в Risti
В Настройки › Разработчикам › Вебхуки нажмите Добавить адрес (только https) и выберите группы событий: Сообщения, Разговоры, Назначения, Участники и команды.
Запросы подписаны HMAC-SHA256 в заголовке X-Risti-Signature. Секрет подписи показывается один раз; после замены старый секрет работает ещё 24 часа. Risti повторяет доставку 8 раз примерно за 22,5 часа, а после 5 неудач подряд отключает адрес и пишет об этом владельцам на почту. Есть Отправить тест и Последние доставки. Тексты сообщений в вебхуки не попадают. Подробнее — на странице для разработчиков.