Как настроить вебхук в Konso CMS
Создайте вебхук за несколько минут, чтобы получать уведомления о событиях контента на нужный вам URL.
Попробовать arrow_forwardTL;DR
- check_circleВебхук отправляет HTTP POST-запрос на указанный URL при выбранных событиях в CMS
- check_circleНастройка занимает несколько минут: Настройки → Вебхуки → Добавить
- check_circleВы сами выбираете, какие события должны вызывать отправку
- check_circleПри необходимости можно добавить кастомные заголовки или form-data для авторизации
- check_circleПосле сохранения список вызовов и статус доставки доступны на странице вебхука
Что потребуется
- check_circleАктивный проект в Konso с доступом к разделу настроек
- check_circleURL, на который должны приходить уведомления (ваш сервис, интеграция или обработчик)
- check_circleПрава на изменение настроек проекта в Konso
Откройте раздел «Вебхуки»
В Konso перейдите в ваш проект, затем откройте Настройки → Вебхуки. Здесь отображается список всех настроенных вебхуков с количеством событий, активностью за последние 7 дней и процентом ошибок.
Создайте новый вебхук
Нажмите кнопку «Добавить» в правом верхнем углу. Откроется диалог «Add webhook endpoint».
Укажите Endpoint URL и описание
В поле Endpoint URL введите адрес, на который должны приходить уведомления. В поле Description добавьте короткое описание назначения вебхука, чтобы позже было понятно, за что он отвечает.
Выберите события для триггера
В поле «Events to listen to» выберите события, при которых должен срабатывать вебхук — например cms.content.created, cms.content.updated, cms.content.deleted. Если нужны уведомления и об изменениях страниц, добавьте также cms.page.created, cms.page.updated, cms.page.deleted.
При необходимости настройте Form data или Custom headers
Если получатель ожидает секретный токен в заголовке запроса — добавьте его через секцию Custom headers (например, X-Auth-Token: ваш-токен). Если токен должен передаваться в теле запроса form-encoded — используйте секцию Form data.
Сохраните и проверьте вебхук
Убедитесь, что переключатель Active включён, затем нажмите «Save». Вебхук появится в списке. Чтобы проверить работу, создайте или обновите любой материал в CMS и откройте историю вызовов на странице вебхука.
Скрин: список вебхуков
[SCREENSHOT: страница Настройки → Вебхуки со списком настроенных вебхуков — отображается домен endpoint, количество подписанных событий, активность за 7 дней, статус Active]
Скрин: диалог создания вебхука
[SCREENSHOT: открытый диалог Add webhook endpoint с заполненными полями Endpoint URL, Description и выбранными событиями cms.content.created, cms.content.updated, cms.content.deleted]
Скрин: Custom headers и Form data
[SCREENSHOT: развёрнутые секции Custom headers и Form data в диалоге вебхука с примером добавленного заголовка]
Совет: несколько вебхуков на разные адреса
Если уведомления должны приходить в несколько систем, создайте отдельный вебхук для каждого получателя — со своим Endpoint URL и, при необходимости, своим набором событий.
Как отслеживать доставку вебхуков
В списке вебхуков Konso показывает количество вызовов за последние 7 дней и процент ошибок (Error Rate). Если вебхук не доходит — проверьте, что endpoint доступен и возвращает 2xx. Кликните по строке вебхука в списке, чтобы открыть историю вызовов с HTTP-кодами и сообщениями об ошибках.
Скрин: история вызовов вебхука
[SCREENSHOT: страница деталей вебхука с историей вызовов — HTTP-статус каждого запроса, время отправки, сообщение об ошибке при неуспешной доставке]
Готовы настроить свой первый вебхук?
Подключите Konso CMS к своим системам за несколько минут
Начать бесплатно arrow_forward