Яндекс Мессенджер

Предположим, что нужно автоматически отправлять уведомления в Мессенджер, когда у задачи меняется статус. Например, чтобы отслеживать готовность релизов к тестированию. Для этого можно настроить триггер, который будет отслеживать статусы задач типа «Релиз». Когда статус задачи изменится на «Можно тестировать», триггер будет делать HTTP-запрос, чтобы отправить сообщение в чат.

Для отправки уведомлений из Трекера в Яндекс Мессенджер вам понадобится аккаунт робота, от имени которого будут отправляться сообщения. Создайте робота для Мессенджера, добавьте его в чат и настройте триггер, который будет отправлять сообщения от имени робота с помощью HTTP-запросов.

Шаг 1. Создайте робота для Мессенджера

1. Войдите в аккаунт администратора организации.

2. Перейдите на страницу Боты в Мессенджере в кабинете организации Яндекс 360.

3. Нажмите кнопку Создать бота.

4. В появившемся окне введите Имя бота, загрузите фото.

5. Нажмите кнопку Создать. Автоматически будет сформирован токен для бота.

6. Сохраните токен в надежном месте. С помощью токена бот авторизует все операции.

Шаг 2. Добавьте робота в чат

1. В Яндекс Мессенджере добавьте робота в чат, в который нужно отправлять оповещения из Трекера.

2. После добавления робота отправьте в чат любое сообщение.

3. Узнайте идентификатор чата, который потребуется для отправки оповещений из Трекера:

   1. Откройте веб-версию Мессенджера и найдите ваш чат.

   2. На странице чата перейдите в адресную строку. Вы увидите URL чата, например:

      https://yandex.ru/chat/#/chats/0%2F0%2F3d0c333b-f333-33d3-b333-d3aa********
      

   3. Скопируйте последнюю часть URL и замените символы %2F на прямой слэш /. Получится идентификатор чата, например:

      0/0/3d0c333b-f333-33d3-b333-d3aa********
      

Шаг 3. Настройте триггер в Трекере

1. Авторизуйтесь в Трекере. У вас должны быть права на администрирование очереди, для которой вы будете настраивать триггер.

2. На панели слева нажмите  Очереди и выберите очередь.

3. На странице очереди в правом верхнем углу нажмите  Настройки очереди.

4. На панели слева выберите Автоматизация.

5. В правом верхнем углу нажмите кнопку Создать → Триггер.

6. Введите название триггера, например «Уведомления в Мессенджер».

7. Задайте условия, чтобы триггер срабатывал, когда задача типа Релиз переходит в статус Можно тестировать:

   1. Добавьте условие Тип → равно → Релиз.

   2. Добавьте условие Статус → стало равно → Можно тестировать.

   3. Убедитесь, что слева от группы условий указан логический оператор И, чтобы триггер сработал при одновременном выполнении условий.

   

8. Задайте действия триггера:

   1. Нажмите кнопку Добавить действие и выберите HTTP-запрос.

   2. Настройте запрос:

      • Метод — POST.

      • Адрес: https://botapi.messenger.yandex.net/bot/v1/messages/sendText/

      • Способ авторизации: OAuth 2.0.

      • Токен: значение токена, который вы получили при регистрации робота.

      • Тип токена: OAuth.

      • Тип содержимого: application/json.

      • Тело запроса: составьте тело запроса, выбрав один из двух вариантов:

        Отправка сообщения в групповой чат

        Отправка сообщения пользователю

        При заполнении параметра chat_id сообщение будет отправлено в групповой чат, заданный этим ID.

        {
            "chat_id": "<идентификатор_чата>",
            "text": "Пора тестировать задачу [{{issue.key}}: {{issue.summary}}](https://tracker.yandex.ru/{{issue.key}})"
        }
        

        В качестве значения параметра chat_id укажите идентификатор чата, который вы получили из URL чата.

        Вместо chat_id можно использовать параметр login — сообщение будет отправлено пользователю в личный чат.

        {
            "login": "<логин_пользователя>",
            "text": "Пора тестировать задачу [{{issue.key}}: {{issue.summary}}](https://tracker.yandex.ru/{{issue.key}})"
        }
        

      • Заголовки оставьте пустыми.

      

9. Сохраните триггер.

Чтобы проверить работу триггера, переведите задачу типа Релиз в статус Можно тестировать. Триггер отправит в Яндекс Мессенджер сообщение c текстом: «Пора тестировать задачу TEST-123: Настроить триггеры».