Інтеграція з Jira
Працює з Jira
Підключіть ReplyRabbit до Jira Cloud, щоб розмови підтримки у FreeScout могли ставати структурованими issues Jira. Агенти можуть створити issue Jira з розмови, бачити пов'язану issue у 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 сайту. - Електронна пошта облікового запису: електронна адреса облікового запису Atlassian, використана з API-токеном.
- Токен API: API-токен Jira Cloud для цього облікового запису.
Токен API зберігається як зашифроване налаштування поштової скриньки і не показується повністю після збереження. Якщо токен змінено або видалено в Atlassian, оновіть налаштування поштової скриньки перед створенням нових завдань.
Підключити Jira
Відкрийте налаштування поштової скриньки
У FreeScout відкрийте поштову скриньку, яка має створювати завдання Jira, потім відкрийте Налаштування і виберіть ReplyRabbit.Вибрати Jira як трекер завдань
У Інтеграції розділ, встановіть трекер задач на Jira. Поштова скринька може використовувати Linear, GitHub Issues, Jira або жодного трекера завдань.Додати облікові дані Jira
Вставте URL-адресу сайту Jira Cloud, електронну адресу облікового запису та API-токен.Завантажити проєкти Jira
Завантажте проєкти з Jira, потім виберіть проєкт за замовчуванням для нових завдань.Вибрати тип завдання
Завантажте типи завдань для проєкту та виберіть тип завдання за замовчуванням, наприклад Task або Bug.Зберегти налаштування
Збережіть налаштування поштової скриньки. ReplyRabbit зберігає підключення Jira для цієї поштової скриньки.
Налаштувати типові значення
Після підключення Jira налаштуйте значення за замовчуванням, потрібні вашій команді:
- Проєкт за замовчуванням: проєкт Jira, який використовується, коли жодне зіставлення домену чи ШІ-збіг проєкту не вибирає інший проєкт.
- Тип завдання за замовчуванням: тип задачі для нових задач, зазвичай Task або Bug.
- Зіставлення пріоритетів: зіставляйте рівні пріоритету ReplyRabbit з власними назвами пріоритетів Jira.
- Маршрутизація проєкту: зіставляйте домени електронної пошти клієнтів із проєктами Jira, коли маршрутизація має бути детермінованою.
- Автоматичне надсилання завдань: на тарифі Team, дозвольте ReplyRabbit автоматично створювати завдання Jira, коли тріаж вказує, що потрібна інженерна робота.
- Автоматична чернетка при завершенні: дозвольте ReplyRabbit підготувати подальше звернення до клієнта, коли пов'язане завдання Jira досягне категорії статусу Done.
Маршрутизація проєкту необов'язкова. Якщо жоден проєкт не зіставлено впевнено, ReplyRabbit використовує проєкт за замовчуванням поштової скриньки.
Створити issue 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 вміст issue, потрібний для інженерної передачі. Це може включати відповідний контекст клієнта, згенерований текст issue, пріоритет, мітки, виконавця та посилання або ідентифікатор розмови FreeScout.
Не вставляйте конфіденційну інформацію в завдання Jira, якщо вашому робочому простору Jira Cloud не дозволено її отримувати. Якщо дані клієнтів мають повністю залишатися на вашому власному сервері, залиште Jira вимкненою для цієї поштової скриньки.
Часті запитання
Чи підтримує ReplyRabbit Jira Data Center або Server?
Ні. ReplyRabbit підтримує сайти Jira Cloud, які використовують URL atlassian.net.
Чи потрібен мені OAuth для Jira?
Ні. ReplyRabbit використовує базову автентифікацію Jira Cloud для кожної поштової скриньки з URL сайту, електронною поштою облікового запису та токеном API Jira.
Чи може одна поштова скринька використовувати Jira разом із Linear або GitHub Issues одночасно?
Ні. Поштова скринька обирає один активний трекер завдань. Налаштування Linear та GitHub Issues залишаються доступними, коли вибрано будь-який з них.
Чи може ReplyRabbit підготувати чернетку подальшого листа клієнту, коли завдання Jira виконано?
Так. ReplyRabbit опитує пов'язані задачі Jira і може підготувати чернетку відповіді клієнту, коли Jira повідомляє категорію статусу Done.