Інтеграція – це адреса (webhook URL), на яку інша система може надіслати запит. frego створить із нього завдання в проєкті. Це зручно, наприклад, для повідомлень про помилки із сайту, форми для клієнта або помилок із Sentry.
Нова інтеграція
- У проєкті відкрий у меню Інтеграції.
- Натисни Додати інтеграцію й дай їй назву.
- Вибери Тип: Загальна або Sentry.
- Налаштуй, які завдання вона має створювати: назву, пріоритет, тег і колонку, в яку вони підуть.
- Скопіюй Webhook URL і встав її в другу систему.
В одному проєкті може бути кілька інтеграцій, кожна з власними налаштуваннями й власною адресою. Коли якась тимчасово не потрібна, вимкнеш її перемикачем.
Загальна інтеграція
Друга система надсилає на адресу POST із тілом JSON. Обов’язкове лише поле description. Додатково можна надіслати title, priority (high, medium або low) і tag, які перекриють твої налаштування за замовчуванням. Можна долучити й зображення, яке додасться до завдання як вкладення.
У полі description достатньо звичайного тексту. Там може бути й простий HTML: абзаци, списки, посилання й зображення. Усе інше, включно зі скриптами, frego з опису видалить.
Sentry
Для типу Sentry frego прямо в інтеграції покаже, як підключити її в Sentry. З помилки він заповнить назву, опис і пріоритет завдання. Коли та сама помилка з’явиться знову, нового завдання він не створить.
Хто про це дізнається
Коли інтеграція створить завдання, усі учасники проєкту отримають сповіщення.
FREE чи PRO
Інтеграції налаштовує власник проєкту, і вони входять у PRO. Коли PRO закінчиться, наявні інтеграції й далі створюють завдання. Але нових ти не додаси, а наявних не відредагуєш.
УвагаАдреса інтеграції працює як пароль. Якщо вона потрапить не в ті руки, натисни Згенерувати токен заново. Стара адреса перестане працювати, а нову треба буде налаштувати в другій системі.