Інтеграції
Блок містить технічні механізми, через які if.team обмінюється даними із зовнішніми сервісами. Він складається з трьох частин: Вебхуки, API-інтеграції та Конектори. Лічильник біля заголовка блока показує кількість цих частин, а не кількість налаштованих інтеграцій.

Зверніть увагу
Це не єдине місце з інтеграціями в системі. Підключення банків і платіжних систем налаштовується у «Фінанси» → «Інтеграції», а джерела лідів (наприклад, Google Forms) — у модулі «Ліди» на вкладці «Інтеграції». У панелі адміністратора зібрані загальносистемні механізми: вебхуки, 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.
API-інтеграції
Тут створюються токени для доступу до API if.team — щоб зовнішня система могла читати та записувати дані від імені конкретного користувача.
Натисніть «+» навпроти «API-інтеграції». У вікні «Згенерувати токен» заповніть поля:
- Користувач (обовʼязково) — від чийого імені працюватиме інтеграція. Токен успадковує права доступу цього користувача.
- Посилання на API — базова адреса для запитів (виду
https://api.<ваш-домен>/api).

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

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

Зверніть увагу
Значення токена доступне для копіювання будь-коли — і зі списку, і з вікна редагування. Але змінити користувача в наявного токена означає змінити права, з якими працює вже підключена інтеграція, тож робіть це свідомо.
Підключення AI-асистентів (MCP)
API-ключ можна використати й для підключення AI-асистента. MCP-сервер if.team дає Claude або ChatGPT доступ до даних компанії: можна попросити показати прострочені завдання за проєктами, проаналізувати завантаження команди чи порівняти витрачений час із планом.
- Створіть API-ключ у блоці «API-інтеграції» вище.
- Відкрийте сторінку підключення MCP, вставте ключ і виберіть режим: «Лише читати» або «Читати й змінювати».
- Додайте отримане посилання як MCP-підключення у своєму AI-асистенті.
Режим читання підходить для пошуку й аналізу. Доступ до змін потрібен, щоб асистент створював або редагував завдання, ліди, транзакції чи проєкти, — такі дії варто виконувати лише після вашого погодження. Для першого запиту оберіть просте читання, наприклад попросіть знайти прострочені завдання, і звірте результат зі звітом в if.team.
Зверніть увагу
Посилання на підключення працює як пароль: не публікуйте його й не пересилайте іншим. Щоб відкликати доступ, перевипустіть API-ключ.
Конектори
Конектори підключають зовнішні сховища файлів. Наразі конектор використовується в автоматизаціях — щоб система могла автоматично створити папку в підключеному Google Drive.
Натисніть «+» навпроти «Конектори» та заповніть вікно «Додати конектор»:
- Назва (обовʼязково) — довільна назва, за якою ви впізнаєте підключення.
- Тип (обовʼязково) — наразі доступний Google Drive.

Після натискання «Додати» конектор зʼявляється у списку, але ще не підʼєднаний — потрібен окремий крок авторизації. Відкрийте його іконкою «✏»: у вікні «Редагувати конектор» під полями відображається стан «Не підʼєднано» та кнопка «Підʼєднати».

Кнопка відкриває стандартне вікно «Вхід через Google» — виберіть обліковий запис, з якого надаєте доступ, і підтвердіть дозволи для застосунку if.team.

Після успішної авторизації у вікні редагування замість стану та кнопки зʼявляється поле E-mail із адресою підключеного облікового запису. Поле інформаційне — змінити обліковий запис через нього не можна.

Список конекторів має колонки Назва, Тип і Дії («✏» редагувати та «🗑» видалити). Поки жодного конектора не створено, у блоці відображається «Наразі немає даних для відображення».

Зверніть увагу
Підключений обліковий запис видно лише у вікні редагування конкретного конектора. Якщо ви плануєте кілька підключень, давайте конекторам назви, що містять адресу чи призначення, — інакше в списку їх буде не розрізнити.
Підключений конектор використовується в автоматизаціях — у дії «Створити папку» (група «Зовнішні сервіси»). У налаштуваннях цієї дії є обовʼязкове поле «Конектори», де вибирається одне з підключень, а в полі «Назва» задається шлях і змінні, з яких формується назва створюваної папки.

Автоматизації відкриваються з меню «...» у верхній навігації → «Автоматизації». Детальніше — у розділі «Автоматизації».

Зверніть увагу
Якщо видалити конектор, дії «Створити папку» в наявних автоматизаціях лишаться без сховища та перестануть відпрацьовувати. Перед видаленням перевірте, чи не використовується він в активних автоматизаціях.
Права доступу до інтеграцій
Доступ налаштовується в панелі адміністратора: «Команда» → «Ролі», група «Системні налаштування». Група охоплює компанію, налаштування, вебхуки, API-ключі й автоматизації, і кожен її рядок налаштовується окремо:
- API ключі — створення та керування API-ключами інтеграцій
- Вебхуки — керування вебхуками системи
- Автоматизації — створення, перегляд і керування автоматизаціями та їхніми логами
- Профіль компанії — редагування основної інформації компанії
- Діалоги — інтеграція з месенджерами через EasyBusy для спілкування з клієнтами та роботи з лідами й контактами
Права задаються за чотирма діями — Створювати, Переглядати, Редагувати та Видаляти — але у різних рядків різні елементи керування:
- API ключі та Вебхуки — перемикачі «Повний доступ» для кожної з чотирьох дій;
- Автоматизації — списки зі значеннями «Немає прав», «Повний доступ» і «Власні» (для «Переглядати», «Редагувати», «Видаляти»; для «Створювати» — лише перші два);
- Профіль компанії — лише дія «Редагувати» зі значеннями «Немає прав» / «Повний доступ»;
- Діалоги — перемикач «Налаштовувати інтеграцію» в колонці «Створювати» та «Спілкуватися в діалогах» у колонці «Додаткові дії».

Праворуч у заголовку групи відображається зведений стан — «Немає доступу», «Частковий доступ» або повний. Після змін натисніть «Зберегти».
Зверніть увагу
Токени API дають програмний доступ до даних компанії, вебхуки надсилають ці дані на зовнішні адреси, а конектори підключають обліковий запис Google. Видавайте права на цю групу мінімальному колу користувачів.
Інтеграції в профілі співробітника
Окремо від загальних налаштувань компанії кожен співробітник може підключити особисті інтеграції у своєму профілі: Telegram для сповіщень і Google Calendar для завдань.
Інтеграція з Telegram
Встановлення звʼязку між сервісами Telegram та if.team відбувається дуже просто, для цього достатньо мати активований акаунт у Telegram і бути співробітником однієї з компаній у сервісі if.team:
- Перейдіть на сторінку «Профіль» 1️⃣.
- Активуйте вкладку «Інтеграції з сервісами» 2️⃣.

3. Натисніть кнопку «Підключити» напроти заголовка «Інтеграція з Telegram».
4. Перейдіть у Telegram. Сюди на вказаний у профілі мобільний номер надійде сповіщення від if.team bot.
5. Запустіть бот командою «/start».
6. Вкажіть номер телефону для інтеграції.
7. Після цього ви отримаєте сповіщення в Telegram про те, що інтеграція сервісу if.team відбулась, тепер на вказаний номер будуть надходити сповіщення про зміни у завданнях, проєктах або лідах відповідно до встановлених налаштувань на вкладці «Налаштування сповіщень».

8. Щоб переконатись в успішній інтеграції, перейдіть на вкладку «Профіль» → «Інтеграції з сервісами». Напроти заголовка «Інтеграція з Telegram» має бути напис «Підключено» (дивіться зображення нижче):
Інтеграція з Google Calendar
Для того, щоб здійснити інтеграцію Google Calendar, виконайте такі дії:
- Перейдіть на сторінку «Профіль» 1️⃣.
- Активуйте вкладку «Інтеграції з сервісами» 2️⃣.

3. Натисніть кнопку «Підключити» напроти заголовка «Інтеграція з Google Calendar».
4. На сторінці «Вхід через Google» виберіть обліковий запис для інтеграції.
5. Наступний крок сповіщає про те, що сервіс Google Calendar «надасть сервісу if.team доступ до вашого імені, адреси електронної пошти, мовних налаштувань та фото профілю». Ознайомтеся з політикою конфіденційності та умовами використання сервісу if.team. Натисніть кнопку «Продовжити» або «Скасувати».
6. Якщо ви готові надати права на «Перегляд, змінення й безповоротне видалення всіх календарів, до яких ви маєте доступ у Google Календарі», натискайте на кнопку «Продовжити» на наступній сторінці.
7. Результатом успішної інтеграції буде напис «Підключено» на вкладці «Інтеграції з сервісами» у профілі співробітника 3️⃣.

Тепер завдання з сервісу if.team будуть автоматично додаватись до Google Calendar та сповіщати співробітника про терміни та зміни.
Ще є питання?
Можливо, ми ще не додали цю інформацію. Але ви завжди можете звернутися: