Kaiten

Для подключения интеграции с Kaiten выполните следующие шаги:

  1. Введите адрес вашей компании в Kaiten в поле «URL-адрес Kaiten». Адрес должен начинаться с https://.

  2. Введите токен в поле «Kaiten API токен». Инструкция по получению токена доступна по ссылке «Как создать токен» в форме подключения.

  3. Нажмите «Сохранить».

При сохранении DoQA проверяет соединение с Kaiten. Если адрес или токен неверны, интеграция не создаётся и форма остаётся открытой.

Особенности настройки интеграции проекта

Связь проекта в DoQA с доской в Kaiten настраивается так же, как для остальных трекеров (см. Настройки интеграции проекта), но форма отличается:

  • Вместо поля «Проекты» выбирается «Пространство / доска». В списке — доски всех пространств Kaiten в виде «Пространство / Доска». Архивные пространства и доски в список не попадают.

  • В поле «Тип» перечислены типы карточек Kaiten.

  • Статусы DoQA сопоставляются с колонками и подколонками выбранной доски. Подколонка отображается как «Колонка / Подколонка».

  • Сопоставление приоритетов для Kaiten не показывается. В Kaiten нет собственного поля приоритета, поэтому DoQA сам создаёт в компании кастомное свойство типа «список» с именем Priority (DOQA) и значениями Low, Medium, High и проставляет его в карточках.

Внимание

Если создать свойство Priority (DOQA) не удалось (например, у владельца токена нет прав или свойство недоступно на вашем тарифе), связь проекта всё равно сохранится, но баг-репорты будут уходить в Kaiten без приоритета, а обратная синхронизация приоритета работать не будет.

Обновление карточки из DoQA

Kaiten — единственный трекер, в котором DoQA обновляет уже созданную задачу: при редактировании баг-репорта в DoQA в связанной карточке Kaiten меняются заголовок, описание, колонка (по сопоставлению статусов) и приоритет. У остальных трекеров из DoQA только создаются задачи.

Если карточку перенесли на другую доску, заголовок и описание всё равно обновятся, а колонку DoQA менять не будет — иначе карточка уехала бы обратно на доску из настроек интеграции.

Обратная интеграция с Kaiten

DoQA позволяет настраивать обратную интеграцию с Kaiten, чтобы при изменении карточки в трекере автоматически обновлялись соответствующие поля в связанном баг-репорте в DoQA. Синхронизируются статус (по колонке карточки), приоритет (по свойству Priority (DOQA)), заголовок и описание.

Для настройки обратной интеграции выполните следующие шаги:

  1. Скопируйте callback URL вида https://domain.doqa.app/api/integrations/kaiten/webhook. Готовый адрес для вашего стенда DoQA показан в форме подключения — в блоке «Вебхук обратной синхронизации».

  2. В Kaiten откройте нужное пространство.

  3. Перейдите в настройки пространства и выберите внешние вебхуки. Подробная инструкция — по ссылке «Открыть гайд Kaiten по настройке вебхука» в форме подключения.

  4. Добавьте скопированный callback URL и включите отправку событий карточек. Изменения полей приходят в событии card:update.

  5. Подтвердите создание вебхука.

Совет

Вебхук настраивается на пространство, а связь проекта в DoQA — на конкретную доску. События с других досок этого пространства DoQA получит, но пропустит: обновляются только баг-репорты, привязанные к доске из настроек интеграции проекта.

Последнее обновление: