Подключения
Яндекс Трекер
Задачи организации в Яндекс Трекере: что агент читает и меняет, лицензия и доступ к очередям, как подключить и привязать к пространствам, ошибки.
Обновлено:
На этой странице
Что умеет агент
- Читать: список очередей, поиск задач (языком запросов Трекера, по фильтру или по очереди), карточку задачи.
- Менять, по одной задаче за раз: создать задачу, изменить поля, перевести в другой статус, добавить комментарий.
Доступ и от чьего имени
Агент действует от имени подключённого аккаунта Яндекса внутри организации, которую вы указали, с правами чтения и записи в Трекере. Он видит и меняет ровно то, что может этот аккаунт: очереди, к которым у аккаунта нет доступа, агенту тоже недоступны.
Как подключить
- Узнайте идентификатор организации: в Трекере «Администрирование → Организации», поле ID.
- Откройте Интеграции → Яндекс Трекер, введите ID и выберите тип организации: Яндекс 360 или Yandex Cloud.
- Нажмите «Подключить Яндекс Трекер» и разрешите доступ в Яндексе. Перед сохранением Octo проверяет, что аккаунт видит эту организацию.
- Привяжите пространства. Кабинет попросит подтвердить: агент пространства сможет читать и менять задачи от имени подключённого аккаунта, и это распространяется на всех участников пространства.
Привязка к пространствам
Одно подключение Трекера на пространство. Можно подключить несколько организаций. Способы привязки описаны в разделе Подключения и пространства.
Ограничения
- До 60 запросов к Трекеру в минуту на пространство.
- Изменения выполняются по одной задаче, без массовых операций.
- Права на очереди задаются в самом Трекере.
Решение проблем
- Чтение работает, а создание или изменение задач отклоняется (403)
У подключённого аккаунта Яндекса нет платной лицензии Яндекс Трекера. Без лицензии Трекер разрешает чтение, но отклоняет создание и изменение задач с ошибкой 403.
Решение: администратор организации Яндекс 360 назначает лицензию Трекера этому аккаунту. Переподключать ничего не нужно: изменения заработают, как только лицензия назначена. Кроме того, у аккаунта должен быть доступ к очереди, в которой агент создаёт или меняет задачу.
- 403 при работе с одной очередью
- У аккаунта нет доступа к этой очереди. Выдайте доступ в настройках очереди в Трекере.
- Подключение не проходит: организация недоступна
- Проверьте ID и тип организации (Яндекс 360 или Yandex Cloud) и что аккаунт состоит в ней.
- Агент просит владельца переподключить Трекер
- Яндекс отклонил токен (например, доступ отозван). Переподключите тот же аккаунт; привязки сохранятся.
- «К этому пространству не привязан Яндекс Трекер»
- Владелец пространства привязывает Трекер в кабинете.
- Конфликт версии или отклонённые поля
- Задачу изменили одновременно, или поле не подходит очереди. Попросите агента перечитать задачу и повторить.