Где: Настройки → Расширенные → Подключение сторонних приложений
Перейдите по адресу: admin.<your-site>/settings/integrations/webhooks (замените <your-site> на адрес вашего сайта). Если пункта нет в меню, включите Показать все настройки в настройках.
Перед началом
- Добавлять вебхуки может только владелец сайта.
- URL получателя должен начинаться с https:// и быть доступен в интернете.
Инструкция
- Откройте Настройки → Дополнительно → Подключение сервисов → Вебхуки.
- Нажмите Добавить вебхук.
- Укажите Название (например, Zapier) и введите Адрес для приема сообщений.
- В разделе Отправлять сообщение, когда отметьте события: Материал опубликован, Опубликованный материал изменен, Материал снят с публикации, Добавлено исправление, Материал отозван, Новый комментарий, Подписка изменилась.
- Нажмите Добавить вебхук.
- Скопируйте секретный ключ подписи. Он показывается только один раз. Нажмите Я сохранил.
- Нажмите Отправить тест для проверки.
Полезно знать
- Каждое сообщение подписано. Проверяйте заголовок "Keynate-Signature", чтобы убедиться, что запрос пришел с вашего сайта.
- Ваша система должна вернуть статус 2xx в знак успешного получения.
- При ошибках попытки отправки повторяются в течение 24 часов. Если вебхук недоступен 3 дня, он отключается. Исправьте ошибку на стороне получателя и нажмите Возобновить.
- Вы можете выполнить Пауза, Возобновить или выбрать Новый секрет. Старый ключ продолжит действовать столько, сколько вы укажете.
- В списке отображается статус каждого вебхука: Работает, Еще не использовался, Не работает, На паузе, Отключен.
- Откройте отправленное сообщение, чтобы посмотреть историю попыток, и нажмите Отправить снова.
Частые проблемы
- "Адрес должен начинаться с https://."
- "Укажите название вебхука."
- "Выберите хотя бы одно событие."
- "Достигнут лимит вебхуков. Удалите один из ненужных вебхуков перед созданием нового."
Вопросы
Часто задаваемые вопросы
Как выглядит сообщение?
Это небольшой JSON-файл с типом события и данными о статье.
Что произойдет, если мой сервер недоступен?
Недоставленные сообщения будут отправляться повторно в течение 24 часов.