Вебхуки
Вебхук надсилає дані на вашу URL-адресу щоразу, коли в if.team відбувається подія: створено лід, змінено статус завдання, додано транзакцію. Так if.team зв’язується з n8n, Make, Zapier або вашим бекендом без постійного опитування API.
Вебхук надсилає повідомлення на вашу URL-адресу щоразу, коли в системі відбувається певна подія. Це основний спосіб звʼязати if.team із зовнішніми сервісами автоматизації (n8n, Make, Zapier) або з власним бекендом — без періодичного опитування API.
Натисніть «+» навпроти «Вебхуки» — і відкриється вікно «Підписатися на вебхук»:
- Вебхук (обовʼязково) — подія, на яку ви підписуєтесь.
- Ваше посилання (обовʼязково) — URL, на який система надсилатиме дані про подію.
Кнопка «Згенерувати» створює підписку, «Скасувати» закриває вікно.

Події та їх коди
Доступні події охоплюють основні сутності системи. Код у колонці праворуч приходить у полі type payload — саме за ним ваш обробник розрізняє події.
Ліди
- Створення ліда —
LEAD_CREATED - Оновлення назви ліда —
LEAD_NAME_UPDATED - Оновлення статусу ліда —
LEAD_STATUS_UPDATED - Оновлення відповідального за ліда —
LEAD_RESPONSIBLE_UPDATED - Оновлення кастомного поля ліда —
LEAD_CUSTOM_FIELD_UPDATED
Дії по лідах
- Створення дії по ліду —
LEAD_ACTION_CREATED - Оновлення дії по ліду —
LEAD_ACTION_UPDATED - Завершення дії по ліду —
LEAD_ACTION_FINISHED - Дедлайн дії по ліду —
LEAD_ACTION_DEADLINE
Завдання
- Створення завдання —
TASK_CREATED - Оновлення завдання —
TASK_UPDATED - Оновлення статусу завдання —
TASK_STATUS_UPDATED - Оновлення кастомного поля завдання —
TASK_CUSTOM_FIELD_UPDATED - Завершення завдання —
TASK_FINISHED - Нагадування про завершення завдання за дедлайном —
TASK_DEADLINE_FINISHED_REMIND
Проєкти та ітерації
- Створення проєкту —
PROJECT_CREATED - Оновлення проєкту —
PROJECT_UPDATED - Створення ітерації —
ITERATION_CREATED - Оновлення ітерації —
ITERATION_UPDATED
Клієнти
- Створення клієнта —
CLIENT_CREATED - Оновлення клієнта —
CLIENT_UPDATED
Команда
- Створення учасника —
PARTICIPANT_CREATED - Оновлення учасника —
PARTICIPANT_UPDATED - Створення графіку учасника —
PARTICIPANT_GRAPHIC_CREATED
Фінанси
- Створення транзакції —
TRANSACTION_CREATED - Оновлення транзакції —
TRANSACTION_UPDATED

Зверніть увагу
Назви проєктів у вашій компанії можуть відрізнятися — якщо в налаштуваннях задано власний термін замість «проєкт», у списку подій буде саме він.
Типові сценарії: сповіщення в Slack або Telegram про новий лід, синхронізація завдань із зовнішньою системою чи запуск ланцюжка автоматизації під час зміни статусу транзакції.
Створені підписки виводяться таблицею з колонками Тип, Статус, Посилання та Дії:
- Тип — подія, на яку оформлено підписку.
- Статус — перемикач, який тимчасово вимикає надсилання без видалення підписки.
- Посилання — URL-адреса; іконка поруч копіює його повністю.
- Дії — «✏» редагувати та «🗑» видалити.
Іконка «⚙» над таблицею відкриває «Налаштування полів»: перемикачами вмикаються та вимикаються колонки, а перетягуванням за «⠿» змінюється їхній порядок. Зміни застосовуються кнопкою «Зберегти». Під таблицею — вибір кількості рядків на сторінці та лічильник записів.

Іконка «✏» у рядку відкриває вікно «Редагувати вебхук». Змінити тут можна тільки посилання — поле «Вебхук» із типом події показане для довідки та недоступне для редагування. Щоб підписатися на іншу подію, створіть новий вебхук, а старий видаліть або вимкніть перемикачем у списку.

Формат даних вебхука
Коли подія настає, if.team надсилає на вказану вами адресу JSON із двома полями:
- type — код події;
- entity — дані сутності, з якою сталася подія. Набір полів залежить від типу події.
Приклад для оновлення статусу ліда:
{ "type": "LEAD_STATUS_UPDATED", "entity": { "id": 1, "name": "Lead 123", "status": { "id": 1, "name": "Processing" } }}
Приклад для створення запису в графіку учасника:
{ "type": "PARTICIPANT_GRAPHIC_CREATED", "entity": { "type": 3, "creator": { "id": 1, "name": "user1" }, "participant": { "id": 2, "name": "user2" }, "from": "2026-01-01", "to": "2026-01-07" }}
Тут participant — співробітник, якому створено запис, creator — хто його створив, from і to — межі періоду, а type — числовий код типу дня (відпустка, лікарняний абощо).
Зверніть увагу
Подія «Створення графіку учасника» стосується записів у графіку відсутностей співробітника — відпусток, лікарняних і подібних періодів, а не робочого розкладу компанії.
Технічні деталі доставки
Дані надсилаються методом POST із заголовком Content-Type: application/json; тіло запиту — JSON описаної вище структури.
Доставка вважається успішною, якщо ваш сервер відповів кодом 2xx. Якщо сервер не відповів або повернув інший код, система робить до чотирьох спроб поспіль, без пауз між ними. Після цього подія вважається недоставленою й повторно не надсилається.
Зверніть увагу
Повторні спроби не рятують від недоступності сервера. Оскільки всі чотири спроби йдуть одна за одною за частки секунди, вони захищають лише від миттєвого збою мережі. Якщо ваш сервер перезавантажується, перевантажений або лежить хоча б кілька секунд — усі чотири спроби проваляться, і подію буде втрачено назавжди. Не покладайтеся на вебхуки як на єдине джерело даних для критичних процесів: періодично звіряйте стан через API if.team.
Безпека та повторні події
Запити не підписуються. if.team не додає до вебхука підпис або секретний токен, тож ваш сервер не може криптографічно перевірити, що запит справді надійшов від if.team. Якщо на вашій адресі відбуваються значущі дії, подбайте про захист самостійно: зробіть URL непередбачуваним (додайте довгий випадковий сегмент і перевіряйте його), обмежте приймання за IP, звіряйте дані з API перед незворотними діями.
Ваш обробник має бути ідемпотентним: повторне надходження тієї самої події не повинно створювати дублікати. Payload не містить ідентифікатора доставки, тож розрізняти повтори доведеться за вмістом entity.
Ще є питання?
Можливо, ми ще не додали цю інформацію. Але ви завжди можете звернутися: