Сервисная поддержка: интегрирование Jira Service Desk

Рассказываем, как внедрить Jira Service Desk в проект на примере двух наших сервисов Арендоход и Debug Mail.

10 шагов для организации первой рабочей версии поддержки
— Сведения
— Люди
— Тема
— Типы запросов
— Запросы по электронной почте
— Автоматизация
— Права доступа клиентов
— Настройки портала
— Уведомления клиентов
— Виджет
Тестирование фич при интеграции JSD в сервис по API
Заключение

В статье вы найдете инструкцию — какие действия предпринять, чтобы внедрить первую и простую версию поддержки пользователей. Рассмотрим основные сущности в Настройках Jira Service Desk (далее JSD) и что с ними делать. Также расскажем про часть настроек при внедрении JSD по API.

Некоторые разделы в Настройках JSD мы не рассматриваем — они не обязательны к первичному заполнению. Большинство из них относятся к общим настройкам Jira по Типам тасков, Воркфлоу, Правам, Доступам и т.п.

10 шагов для организации первой рабочей версии поддержки

Для первой рабочей версии поддержки необходимо и достаточно настроить следующие разделы:

1. Сведения,
2. Люди,
3. Тема,
4. Типы запросов,
5. Запросы по электронной почте,
6. Автоматизация,
7. Права доступа клиентов,
8. Настройки портала,
9. Уведомления клиентов,
10. Виджет.

1. Сведения

1. Заполнить Имя. Например, “DebugMail Team”.
2. Заполнить Ключ — короткое, название, которое будет стоять в URL тикета. Например, “DT”.
3. URL сервиса.
4. Аватар. Мы добавили ту же картинку, которую используем в сервисе как фавикон.
5. Описание. Например, “DebugMail Support Team”.
6. Указываем Руководителя проекта.
7. Исполнитель по умолчанию. Рекомендуем указывать “Руководитель проекта”, чтобы не было ситуации, когда у нового запроса нет исполнителя.

2. Люди

Бесплатная версия JSD позволяет создать команду службы поддержки максимум из 3-х человек.

Сотрудников добавляют в 2 этапа:

1. Через админку Jira (Администратор Atlassian) в Настройках пользователей в разделе Группы.
2. Через раздел Люди в настройках проекта JSD с указанием Роли сотрудника.

Люди — это раздел, где перечислены все пользователи Service Desk — и ваши сотрудники, и клиенты поддержки. Здесь можно назначать роли и добавлять пользователей.

3. Тема

Это технический раздел и связан с настройками в самой Jira — тип задачи (Jira Issue Type), бизнес-процессы (Workflow), компоненты, экраны, права и др. Вы можете использовать уже настроенные по умолчанию сущности JSD или в админке Jira настроить их самостоятельно.

4. Типы запросов

В первой итерации сложно предсказать все необходимые типы, поэтому можно оставить всего один стандартный тип, предлагаемый JSD.

В долгосрочной перспективе, при большом количестве входящих обращений, вы сможете их систематизировать и создать разные типы запросов с автоответами и другими полезными автоматизациями.

В Типах запросов настраиваем 3 блока параметров: отображение для агента, форма создания запроса и статусы рабочего процесса.

4.1. Отображение для агента

Здесь настраиваем поля, которые видит агент поддержки в тикете — часть полей видны сразу сверху в основной части таска, часть полей уводят в правый блок, остальные поля скрываем.

4.2. Форма создания запроса

Здесь настраиваем то, как видит окно поддержки клиент. Можно указать пометки для разных полей и в целом для типа запроса, сделать поля обязательными или необязательными.

4.3. Статусы рабочего процесса

Здесь настраиваем то, как отображаются для клиента статусы по воркфлоу.

5. Запросы по электронной почте

Можно использовать предоставляемый JSD аккаунт или подключить собственный — клиентам будут приходить оповещения от указанной вами почты.

6. Автоматизация

Позволяет системно подойти к автоответам, движению тикетов по воркфлоу, созданию и распределению задач между сотрудниками и не только, т.е. автоматизировать любое рутинное действие поддержки.

7. Права доступа клиентов

Права доступа регламентируют то, как будет пользователь взаимодействовать с JSD — можно ли заходить на портал и приглашать/видеть других сотрудников и тикеты.

Здесь нужно настроить 3 сущности:

1. У кого будет Доступ к проекту службы поддержки.
2. Общий доступ клиентов.
3. И по ссылке администраторы могут изменить Настройки доступа клиентов — у кого и по каким правилам будет доступ к порталу.

В зависимости от сервиса, где вы подключаете JSD, будут требоваться разные настройки. Например, в Debug Mail мы получаем запросы от любого пользователя. Арендоход — закрытый сервис, доступ к которому согласовывает руководство клиента, поэтому там клиентов могут добавлять только агенты или администраторы.

8. Настройки портала

Позволяют сконфигурировать портал JSD под корпоративные стандарты. Если открыть для клиентов возможность видеть портал, то нужно заполнить Информацию о проекте сервиса:

1. Название.
2. Текст приветствия (желательно, но не обязательно).
3. Добавить логотип.

9. Уведомления клиентов

Позволяет кастомизировать шаблон писем, которые уходят на почту клиента; включить и настроить встроенные автоматизации, например, когда создан запрос, добавлен общедоступный комментарий, запрос решен и др.

9.1. Настроить шаблон

Шаблон формирует общий принцип по содержанию уведомлений и есть возможность использовать различные переменные и добавлять их в тему письма или в текст уведомления.

9.2. Настроить уведомления клиентов

Ориентируясь на воркфлоу техподдержки это могут быть, например, следующие уведомления:

1. Запрос создан.
2. Добавлен общедоступный комментарий.
3. Запрос решен.
4. Участник добавлен.

9.3. Особенности настройки по API

Если подключаете JSD по API, нужно с осторожностью относится к встроенным шаблонам из-за ограничения: все запросы будут поступать только по одному ID пользователя Jira.

10. Виджет

Позволяет индивидуализировать этот элемент на сайте под ваши требования.

10.1. Особенности настройки по API

Если вы подключаете JSD по API, то настройка виджета вам не понадобится. Этим будет заниматься ваш фронтенд-разработчик и кастомизировать внешний вид под сервис.

Для сервиса Арендоход мы внедрили JSD по API, т.к. каждый запрос в сервисе должен быть привязан к конкретной локации.

Основа сервиса — интерактивная карта с объектами и запрос пользователя должен сопровождаться точным адресом и/или координатами. Стандартный функционал Service Desk не позволяет этого сделать, а заставлять пользователей самостоятельно заполнять поле с адресом — мы не стали.

Поэтому реализовали следующей процесс: после нажатия на кнопку Добавить комментарий на панели меню, предоставляется возможность поставить pin на любую локацию карты, где тут же открывается окно ввода данных Комментарий.

Тестирование фич при интеграции JSD в сервис по API

Все кастомные нововведения мы проверили на тест-группе. Попросили самых лояльных пользователей использовать новую форму Комментариев и нашли несколько интересных багов.

Например, мы обнаружили, что не все вложения загружались в запрос: сервис не пропускал файл к загрузке из-за каких-то символов в названии вложения, а страница сервиса становилась серым экраном. Пользователь перезагружал страницу, и сервис работал в нормальном режиме, но баг повторялся из раза в раз.

Спустя много попыток исправить баг, наш разработчик сделал автозамену на произвольный набор символов, которые система JSD пропускала, и файл загружался в тикет.

Заключение

Отталкиваясь от принципа запуска минимально жизнеспособного продукта (MVP), не стоит гнаться на начальном этапе за идеальной настройкой сервиса поддержки пользователей.

Настройте Jira Service Desk по 10 описанным шагам, получите фидбэк от пользователей и доработайте настройки.

Если остались вопросы — напишите нам.