Вебхукs - Shifton Help

Вебхукs дозволяють Shifton надсилати сповіщення в реальному часі до зовнішніх систем при настанні подій у вашій компанії.

Покрокова інструкція

Доступ до вкладки Вебхукs

На лівій бічній панелі натисніть Інтеграції.

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

Створення нового webhook

Натисніть «Новий вебхук».

Заповніть конфігурацію:

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

Збережіть. Shifton надсилатиме HTTP POST-запити на вказаний URL.

Управління webhooks

Натисніть на webhook для редагування URL, оновлення подій або зміни статусу активності.

Тестування webhook

Викличте відповідну подію в Shifton (наприклад, створіть тестову зміну).

Перевірте журнали сервера — дані мають надійти.

Пов’язані статті

Часті запитання

П: У якому форматі Shifton надсилає дані?
HTTP POST з тілом у форматі JSON. Структуру даних по кожному типу подій див. у документації API.

П: Чи можна створити кілька Вебхуки для однієї події?
Так, з різними URL.

П: Що якщо сервер недоступний при спрацюванні webhook?
Доставка може завершитися невдало. Деталі про політику повторних спроб — у документації API.

П: Вебхук не спрацьовує — чому?
Переконайтеся, що перемикач Активний увімкнено і URL публічно доступний.

П: Як перевірити, що webhook отримує дані?
Створіть тестову подію в Shifton (наприклад, додайте зміну) і перевірте журнали вашого сервера на наявність вхідного POST-запиту.

П: Чи можу я налаштувати аутентифікацію webhook?
Так. Додайте секретний ключ або токен в URL або заголовки webhook. Деталі в документації API.

П: Як виглядає тіло webhook-запиту?
JSON-об’єкт з даними події. Структура залежить від типу події — див. документацію API для прикладів.

П: Чи може один webhook відстежувати кілька подій?
Так. При створенні webhook оберіть кілька подій — один URL отримуватиме сповіщення по всіх обраних.

П: Що таке «політика повторних спроб» для webhook?
Якщо сервер повертає помилку (не 200), Shifton може повторити запит. Деталі залежать від конфігурації платформи.

П: Чи є ліміт на кількість Вебхуки?
Обмежень за кількістю в документації не вказано, але рекомендується створювати лише необхідні.

П: Чи потрібно використовувати HTTPS для URL webhook?
Рекомендується. HTTP-адреси можуть працювати, але HTTPS забезпечує безпечну передачу даних.

П: Чи можна отримувати webhook-сповіщення при кожній зміні розкладу?
Так. Додайте події типу «зміна created» або «schedule updated» при налаштуванні webhook.

П: Хто має доступ до створення Вебхуки?
Лише Власник та Адміністратор. Менеджери та співробітники не бачать розділ Розробник.

П: Чи можна вимкнути webhook, не видаляючи його?
Так. Вимкніть перемикач Активний у налаштуваннях webhook — він перестане спрацьовувати, але збереже конфігурацію.

П: Чи логуються спрацювання webhook у Shifton?
Детальні логи доставки webhook в інтерфейсі не надаються. Відстеження — на стороні вашого сервера.

П: Чи можна фільтрувати webhook за проєктом або розкладом?
Ні. Вебхук спрацьовує на всі події обраного типу по всій компанії. Фільтрація — на стороні приймаючого сервера.

П: Що відбувається з webhook при видаленні компанії?
Усі webhooks видаляються разом з компанією.