Описание настройки универсальных вебхуков чат-бота

Для отправки уведомлений от YouTrack в МТС Линк чат нужно:

1. Создать чат-бота

2. Создать новый вебхук для входящих уведомлений

3. Настроить отправку уведомления в YouTrack

4. Отправить тестовое уведомление

Детальное описание настройки уведомлений в YouTrack

Шаг 1: Вход в YouTrack

1. Войдите в свою учетную запись YouTrack с правами администратора.

Шаг 2: Переход в настройки проекта

1. Откройте меню «Администрирование» (Administration).
2. Выберите проект, для которого хотите настроить вебхук.

Шаг 3: Настройка автоматизации правил (Workflow)

1. Перейдите в раздел «Рабочие процессы» (Workflows).
2. Если у вас еще нет созданного рабочего процесса, создайте новый:

Нажмите кнопку «Добавить рабочий процесс» (Add Workflow).

Дайте ему понятное имя, например WebhookNotifier.

Шаг 4: Создание правила для вебхука

1. Внутри созданного рабочего процесса создайте новое правило (Rule):

Нажмите «Добавить правило» (Add Rule).

Назовите правило, например SendWebhookOnIssueCreation.

2. Укажите тип триггера:

Тип триггера должен быть «При создании тикета» (On issue creation).

Шаг 5: Написание кода для отправки вебхука

1. Напишите код для отправки вебхука. Пример на JavaScript:

javascript

 // Укажите URL вашего вебхука
 var webhookUrl = "https://prod-chat.mts-link.ru/application/webhook/11111/222222"; 

 if (issue.becomesReported) {     
   var payload = {         
     "text": issue.summary + "\n" + issue.description + "\n" + issue.url
     };     


// Отправка запроса на вебхук     
var request = new HttpRequest();     
request.url = webhookUrl;     
request.method = "POST";     
request.headers = { "Content-Type": "application/json" };     
request.body = JSON.stringify(payload);     


// Выполнение запроса     
var response = request.execute();     
if (response.statusCode >= 200 && response.statusCode < 300) {            
  console.log("Webhook sent successfully.");     
} else {
   console.error("Failed to send webhook. Sta tus: " + response.statusCode);     
  } 
} 

Шаг 6: Привязка правила к проекту

1. Активируйте созданное правило (Rule) для вашего проекта:

Вернитесь в настройки проекта.

В разделе «Рабочие процессы» (Workflows) убедитесь, что ваш рабочий процесс активен для выбранного проекта.

Шаг 7: Проверка работы вебхука

1. Создайте тестовый тикет в проекте.
2. Убедитесь, что запрос был отправлен на указанный вебхук.

Проверьте журнал вашего вебхука или лог событий, чтобы убедиться, что данные были успешно получены.

Шаг 8: Устранение неполадок (если требуется)

Если вебхук не срабатывает:
1. Проверьте правильность URL вебхука.
2. Убедитесь, что ваш сервер принимает запросы с YouTrack.
3. Проверьте журнал ошибок в YouTrack.