Интеграция - это адрес (URL вебхука), на который другая система может отправить запрос. По нему frego создаст задачу в проекте. Пригодится, например, для сообщений об ошибках с сайта, формы для клиента или ошибок из Sentry.
Новая интеграция
- В проекте открой в меню Интеграции.
- Нажми Добавить интеграцию и дай ей название.
- Выбери Тип: Общая или Sentry.
- Настрой, какие задачи она будет создавать: название, приоритет, тег и колонку, в которую они попадут.
- Скопируй URL вебхука и вставь его в другую систему.
В одном проекте может быть несколько интеграций, у каждой свои настройки и свой адрес. Если какая-то сейчас не нужна, отключи её переключателем.
Общая интеграция
Другая система отправляет на адрес POST-запрос с телом в JSON. Обязательно только поле description. Дополнительно можно передать title, priority (high, medium или low) и tag - они перезапишут твои настройки по умолчанию. Можно приложить и картинку, она добавится к задаче как вложение.
В поле description достаточно обычного текста. В нём может быть и простой HTML: абзацы, списки, ссылки и изображения. Всё остальное, включая скрипты, frego удалит из описания.
Sentry
Для типа Sentry frego прямо в интеграции покажет, как подключить её в Sentry. Из ошибки он заполнит название, описание и приоритет задачи. Если та же ошибка появится снова, новую задачу он не создаст.
Кто об этом узнает
Когда интеграция создаёт задачу, все участники проекта получают уведомление.
FREE или PRO
Интеграции настраивает владелец проекта, и они входят в PRO. Когда PRO заканчивается, уже существующие интеграции продолжают создавать задачи. Но новые добавить или изменить существующие не получится.
ВниманиеАдрес интеграции работает как пароль. Если он попал не в те руки, нажми Перегенерировать токен. Старый адрес перестанет работать, а новый нужно будет прописать в другой системе.