Webhooks - Shifton Help

Webhooks позволяют Shifton отправлять уведомления в реальном времени во внешние системы при наступлении событий в вашей компании.

Пошаговые инструкции

Доступ к вкладке Webhooks

На левой боковой панели нажмите Интеграции.

Перейдите на страницу Разработчик → вкладка Вебхуки.

Создание нового webhook

Нажмите «Новый вебхук».

Заполните конфигурацию:

Поле	Описание
URL	Конечная точка для получения данных событий
События	События Shifton, активирующие webhook
Активные	Переключатель включения/отключения

Сохраните. Shifton будет отправлять HTTP POST-запросы на указанный URL.

Управление webhooks

Нажмите на webhook для редактирования URL, обновления событий или изменения статуса активности.

Тестирование webhook

Вызовите соответствующее событие в Shifton (например, создайте тестовую смену).

Проверьте журналы сервера — данные должны поступить.

Связанные статьи

Часто задаваемые вопросы

В: В каком формате Shifton отправляет данные?
HTTP POST с телом в формате JSON. Структуру данных по каждому типу событий см. в документации API.

В: Можно ли создать несколько Вебхуки для одного события?
Да, с разными URL.

В: Что если сервер недоступен при срабатывании webhook?
Доставка может завершиться неудачей. Подробности о политике повторных попыток — в документации API.

В: Webhook не срабатывает — почему?
Убедитесь, что переключатель Активные включён и URL публично доступен.

В: Как проверить, что webhook получает данные?
Создайте тестовое событие в Shifton (например, добавьте смену) и проверьте журналы вашего сервера на наличие входящего POST-запроса.

В: Могу ли я настроить аутентификацию webhook?
Да. Добавьте секретный ключ или токен в URL или заголовки webhook. Подробности в документации API.

В: Как выглядит тело webhook-запроса?
JSON-объект с данными события. Структура зависит от типа события — см. документацию API для примеров.

В: Может ли один webhook отслеживать несколько событий?
Да. При создании webhook выберите несколько событий — один URL будет получать уведомления по всем выбранным.

В: Что такое «политика повторных попыток» для webhook?
Если сервер возвращает ошибку (не 200), Shifton может повторить запрос. Подробности зависят от конфигурации платформы.

В: Есть ли лимит на количество Вебхуки?
Ограничений по количеству в документации не указано, но рекомендуется создавать только необходимые.

В: Нужно ли использовать HTTPS для URL webhook?
Рекомендуется. HTTP-адреса могут работать, но HTTPS обеспечивает безопасную передачу данных.

В: Можно ли получать webhook-уведомления при каждой смене расписания?
Да. Добавьте события типа «Смена создана» или «schedule updated» при настройке webhook.

В: Кто имеет доступ к созданию Вебхуки?
Только Owner. Менеджеры и сотрудники не видят раздел Developer.

В: Можно ли отключить webhook, не удаляя его?
Да. Выключите переключатель Активные в настройках webhook — он перестанет срабатывать, но сохранит конфигурацию.

В: Логируются ли срабатывания webhook в Shifton?
Подробные логи доставки webhook в интерфейсе не предоставляются. Отслеживание — на стороне вашего сервера.

В: Можно ли фильтровать webhook по проекту или расписанию?
Нет. Webhook срабатывает на все события выбранного типа по всей компании. Фильтрация — на стороне принимающего сервера.

В: Что происходит с webhook при удалении компании?
Все webhooks удаляются вместе с компанией.