Интеграция с Jira
Работает с Jira
Подключите ReplyRabbit к Jira Cloud, чтобы обращения в поддержку во FreeScout становились структурированными задачами Jira. Агенты могут создать задачу Jira из обращения, держать связанную задачу видимой во FreeScout и использовать ReplyRabbit для подготовки ответа клиенту, когда работа выполнена.
Ищете обзор?
Обзор
Интеграция Jira добавляет панель Jira в ReplyRabbit в переписке FreeScout. Когда Jira настроена для почтового ящика, ReplyRabbit может создать задачу с заголовком, описанием, приоритетом, метками, исполнителем, типом задачи, проектом и ссылкой обратно на переписку поддержки.
Jira выбрана в качестве активного трекера задач для почтового ящика. Если почтовый ящик уже использует Linear или GitHub Issues, оставьте этот трекер выбранным, пока не будете готовы перевести этот почтовый ящик на Jira.
Предварительные требования
Перед началом убедитесь, что у вас есть:
- Работающая установка FreeScout.
- ReplyRabbit установлен и активирован.
- Тариф ReplyRabbit, включающий нужную вам функцию Jira.
- Сайт Jira Cloud, например
https://example.atlassian.net. - Электронная почта учётной записи Jira и API-токен с доступом к целевому проекту.
- Хотя бы один проект Jira и тип задачи, поддерживающие создание задач.
- Разрешения проекта Jira для включаемого вами рабочего процесса: требуются Browse Projects и Create Issues; Edit Issues, Assign Issues, Transition Issues и Add Comments нужны, когда вы используете изменение приоритета/меток, назначение, переходы статусов или комментарии в переписке.
Если ReplyRabbit ещё не установлен, начните с Как установить модуль ReplyRabbit, затем завершите Как настроить ReplyRabbit.
Разрешения и API-токены
ReplyRabbit подключается к Jira Cloud REST API v3 с помощью Basic auth. Почтовый ящик хранит три значения подключения:
- URL сайта Jira: the
https://example.atlassian.netURL сайта. - Электронная почта учётной записи: email аккаунта Atlassian, используемый с API-токеном.
- API Token: API-токен Jira Cloud для этого аккаунта.
API-токен хранится как зашифрованная настройка почтового ящика и не показывается полностью после сохранения. Если токен ротирован или удалён в Atlassian, обновите настройки почтового ящика перед созданием новых задач.
Подключить Jira
Откройте настройки почтового ящика
В FreeScout откройте почтовый ящик, который должен создавать задачи Jira, затем откройте Настройки и выберите ReplyRabbit.Выберите Jira в качестве трекера задач
В Интеграции раздел, установите трекер задач в Jira. Почтовый ящик может использовать Linear, GitHub Issues, Jira или не использовать трекер задач.Добавить учётные данные Jira
Вставьте URL сайта Jira Cloud, email учётной записи и API-токен.Загрузить проекты Jira
Загрузите проекты из Jira, затем выберите проект по умолчанию для новых задач.Выберите тип задачи
Загрузите типы задач для проекта и выберите тип задачи по умолчанию, например Task или Bug.Сохранить настройки
Сохраните настройки почтового ящика. ReplyRabbit сохранит подключение Jira для этого почтового ящика.
Настроить значения по умолчанию
После подключения Jira настройте значения по умолчанию, которые нужны вашей команде:
- Проект по умолчанию: проект Jira, используемый, когда ни сопоставление домена, ни сопоставление проекта ИИ не выбирает другой проект.
- Тип задачи по умолчанию: тип задачи для новых задач, обычно Task или Bug.
- Сопоставление приоритетов: сопоставьте уровни приоритета ReplyRabbit с собственными именами приоритетов Jira.
- Маршрутизация по проекту: сопоставьте домены email клиентов с проектами Jira, когда маршрутизация должна быть детерминированной.
- Автоматическая отправка задач: на тарифе Team, позвольте ReplyRabbit автоматически создавать задачи Jira, когда триаж говорит, что нужна инженерная работа.
- Авточерновик при завершении: позвольте ReplyRabbit подготовить последующее обращение к клиенту, когда связанная задача Jira достигнет категории статуса Done.
Маршрутизация по проекту необязательна. Если ни один проект не сопоставлен с уверенностью, ReplyRabbit использует проект по умолчанию для почтового ящика.
Создать задачу Jira из обращения FreeScout
Откройте разговор в почтовом ящике, где настроена Jira. Панель ReplyRabbit может создать issue Jira из ветки клиента, а затем показать привязанный issue в FreeScout.
ReplyRabbit отправляет в Jira структурированное описание в формате Atlassian Document Format. Описание включает сводку поддержки, контекст клиента и ссылку на переписку FreeScout. Текст клиента рассматривается как содержимое, а не инструкции.
После создания проверьте связанную задачу Jira и при необходимости скорректируйте статус, приоритет, исполнителя или метки на панели ReplyRabbit.
Держите переписки и задачи синхронизированными
После привязки issue разговор в FreeScout может показывать текущий статус Jira, приоритет, исполнителя, метки и ключ issue. Агенты могут открыть issue в Jira, когда им нужен полный инженерный обзор.
ReplyRabbit меняет статус Jira через переходы Jira. Он не пишет напрямую в поле статуса.
ReplyRabbit также поддерживает цикл завершения. Запланированная проверка статуса опрашивает связанные задачи Jira. Когда Jira сообщает категорию статуса Done, ReplyRabbit может помочь составить черновик ответа клиенту, чтобы поддержка могла закрыть разговор с контекстом.
Устранение неполадок
| Симптом | Что проверить |
|---|---|
| Проекты не загружаются | Подтвердите, что URL сайта — это Jira Cloud atlassian.net URL, адрес электронной почты верен, и у API-токена есть доступ к проекту. |
| Отсутствуют типы задач | Убедитесь, что выбранный проект поддерживает тип задачи, который вы планируете использовать. |
| Задачи не создаются | Убедитесь, что Jira выбрана в качестве трекера задач почтового ящика, выбран проект и ваш тариф ReplyRabbit включает эту функцию. |
| Автоматические задачи не создаются | Подтвердите, что вы на тарифе Team и Автоматическая отправка задач включена. |
| Статус не обновится | Перезагрузите разговор, затем убедитесь, что Jira предоставляет допустимый переход для целевого статуса. |
| Черновики по завершении не появляются | Подтвердить Авточерновик при завершении включена и связанная задача Jira достигла категории статуса Done. |
Для более широких исправлений см. Устранение неполадок ReplyRabbit.
Конфиденциальность и обработка данных
ReplyRabbit отправляет в Jira содержимое задачи, необходимое для инженерной передачи. Оно может включать релевантный контекст клиента, сгенерированный текст задачи, приоритет, метки, исполнителя и ссылку или идентификатор переписки FreeScout.
Не помещайте конфиденциальную информацию в задачу Jira, если вашему рабочему пространству Jira Cloud не разрешено её получать. Если данные клиентов должны полностью оставаться на вашем собственном сервере, оставьте Jira отключённой для этого почтового ящика.
FAQ
Поддерживает ли ReplyRabbit Jira Data Center или Server?
Нет. ReplyRabbit поддерживает сайты Jira Cloud, использующие URL atlassian.net.
Нужен ли OAuth для Jira?
Нет. ReplyRabbit использует Basic-аутентификацию Jira Cloud для каждого почтового ящика с URL сайта, email аккаунта и API-токеном Jira.
Может ли один почтовый ящик использовать Jira вместе с Linear или GitHub Issues одновременно?
Нет. Почтовый ящик выбирает один активный трекер задач. Настройки Linear и GitHub Issues остаются доступными, когда выбран любой из них.
Может ли ReplyRabbit подготовить черновик ответа клиенту, когда задача Jira выполнена?
Да. ReplyRabbit опрашивает связанные задачи Jira и может подготовить черновик ответа клиенту, когда Jira сообщает о категории статуса Done.