Яндекс.Трекер

Агент сам ведёт задачи: создаёт, обновляет, комментирует — прямо из диалога.

Что это даёт

После подключения агент работает с вашим Яндекс.Трекером через ноду «Интеграция»: создаёт задачи, читает и обновляет их, добавляет комментарии, смотрит очереди. Например, агент может сам завести задачу по обращению клиента или вести план работ — всё в одном месте.

Подключение — в пару кликов: вы указываете ID организации и разрешаете доступ на странице Яндекса. Отдельные ключи или приложения в Яндексе заводить не нужно.

Шаг 1. Узнайте ID организации

Трекеру нужен идентификатор вашей организации — его вы вводите при подключении. Какой именно ID — зависит от того, к чему привязан ваш Трекер:

  • Яндекс 360 для бизнеса (частый случай) — нужен X-Org-ID. Найти: Трекер → Администрирование → Организации → поле «ID».
  • Yandex Cloud Organization — нужен X-Cloud-Org-ID (ID организации в Yandex Cloud).

Заполняется только ОДНО из двух полей — то, что соответствует вашей организации. Если не уверены — почти всегда это Яндекс 360 (первый вариант).

Шаг 2. Подключите в Дирижёре

  1. Откройте раздел «Интеграции» → «Подключить сервис».
  2. Выберите «Яндекс.Трекер», дайте подключению название.
  3. Впишите ID организации (по шагу 1) в нужное поле.
  4. Нажмите «Подключить» → на странице Яндекса разрешите доступ.
  5. Подключение проверится автоматически и сохранится.

Шаг 3. Используйте в агенте

В редакторе добавьте ноду «Интеграция», выберите подключение Трекера и операцию: создать задачу, получить/изменить задачу, добавить комментарий, список очередей. Параметры можно подставлять из диалога переменными вида {{input.message}}.

Частые вопросы

При подключении ошибка доступа (403).

Проверьте, что вы разрешили доступ на странице Яндекса, а ID организации указан верный (шаг 1). Если вы разворачиваете Дирижёр самостоятельно — убедитесь, что приложению Яндекса добавлены права tracker:read и tracker:write (блок «Разворачиваете Дирижёр самостоятельно?» ниже).

Ошибка при проверке подключения (400/401).

Скорее всего выбран не тот тип организации. Попробуйте второй вариант ID (X-Cloud-Org-ID вместо X-Org-ID или наоборот).

Разворачиваете Дирижёр самостоятельно?

Подключение идёт через «Войти через Яндекс» — то же приложение Яндекса, что и для Яндекс.Диска. Обычным пользователям это делать не нужно; шаги ниже — для тех, кто разворачивает платформу сам и настраивает OAuth-приложение.

  1. Откройте oauth.yandex.ru → приложение Дирижёра.
  2. В разделе «Доступы» добавьте права Яндекс.Трекер: tracker:read и tracker:write.
  3. Если приложения ещё нет — создайте его и сразу отметьте права и Диска, и Трекера. Redirect URI: {ваш-адрес}/api/connectors/oauth/callback.