Top.Mail.Ru
Центр помощи / Для администратора / 5. Заявки на сервис / Обработка заявок во внешней тикет-системе

Обработка заявок во внешней тикет-системе

Заявки по сервису можно обрабатывать не внутри UnSpot, а в вашей тикет-системе: каждая заявка уходит письмом на указанный адрес, а вместе с письмом передаются служебные заголовки — исполнитель, наблюдатели, идентификатор проекта, уровень критичности и срок исполнения. Так модуль «Сервисы» встраивается в уже работающий сервис-деск, не заставляя сотрудников заводить в нём учётные записи. Способ обработки задаётся отдельно для каждого сервиса и доступен для всех трёх типов — «Для сотрудника», «В офисе» и «В переговорной».

Как это работает

Когда сотрудник отправляет заявку по сервису с внешней обработкой, UnSpot делает три вещи одновременно: сохраняет заявку у себя, сразу присваивает ей статус «Отправлена» и отправляет письмо на адрес вашей тикет-системы. Дальше заявка живёт во внешней системе — UnSpot к ней не возвращается.

Это односторонняя передача, а не двусторонняя интеграция: номер тикета из внешней системы в UnSpot не приходит, статус в UnSpot больше не меняется, и сотрудник в разделе «Мои заявки на сервис» всегда видит «Отправлена».

Что сравниваемОбработка внутри UnSpotОбработка во внешней системе
ИсполнительОбязателен: общий для всех офисов либо в каждой строке офисаНеобязателен ни общий, ни в строках офисов: используется только как значение служебного заголовка и адрес для копии письма
Статус новой заявки«Новая»«Отправлена» — финальный, изменить нельзя
Кнопки «Принять в работу», «Подтвердить выполнение», «Отклонить заявку»ЕстьНет
Смена исполнителя в заявкеДоступна ролям «Владелец» и «Офис менеджер» до финального статусаНедоступна
SLA реакции и выполненияМожно задать в настройках сервисаНедоступен: секции SLA в форме нет
Поля «Срок исполнения» и «Файлы и изображения»Работают по настройке сервисаРаботают так же: срок уходит заголовком X-Duedate, файлы — вложениями письма
История статусовНакапливаетсяОдна запись
ПисьмаПри создании и при каждой смене статуса — инициатору и исполнителюОдно письмо при создании — на адрес внешней системы
Вложения заявкиХранятся в UnSpot, к письмам не прикладываютсяПрикладываются к письму файлами
Удаление сервисаЗапрещено, пока есть заявки в статусах «Новая» и «Принята»Возможно всегда: заявки такого сервиса не бывают в работе

Настройка сервиса с внешней обработкой

Что понадобится: роль «Владелец» или «Администратор офисов»; включённый модуль «Мои заявки» («Настройка» → «Настройки компании» → блок «Доступный функционал»); адрес электронной почты, из которого ваша тикет-система создаёт заявки.

Окно «Добавить сервис» состоит из секций, которые идут сверху вниз. Удобнее всего начать с последней — выбрать в ней внешнюю обработку: от этого зависит, какие поля обязательны выше.

  1. Откройте «Настройка» → «Управление офисом» → вкладка «Сервисы» и нажмите «Добавить сервис».
  2. В секции «Где обрабатывать заявки» выберите «Во внешней тикет системе» и заполните поля интеграции — они описаны ниже. Секция SLA из формы при этом исчезает.
  3. В секции «Доступность в офисах» выберите «Во всех офисах» или «Только в указанных офисах» и при необходимости назначьте исполнителя — подробнее в разделе «Исполнитель и офисы». Здесь же находится чекбокс «Отправлять исполнителю копию письма заявки».
  4. Выберите «Тип сервиса»: «Для сотрудника», «В офисе» или «В переговорной». Под чипсами появится подсказка о выбранном типе.
  5. В секции «Данные сервиса» заполните «Название сервиса» и, при необходимости, «Описание сервиса» — их увидит сотрудник в форме заявки.
  6. В секции «Поля заявки на сервис» решите, нужны ли в форме заявки «Срок исполнения» и «Файлы и изображения».
  7. Сверьтесь с блоком «Структура письма» в конце формы: он показывает, как будет выглядеть заголовочная часть письма с текущими значениями формы.
  8. Сохраните сервис. Он появится в таблице со значением «Внешняя» в колонке «Тип заявки».

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

Исполнитель и офисы

Исполнитель для внешней обработки нужен не для работы с заявкой, а для письма: его адрес уходит в заголовке X-Assignee и, если включена копия, в поле cc. Задаётся он в секции «Доступность в офисах» одним из двух способов.

РежимЧто заполнитьКто попадёт в X-Assignee
«Во всех офисах»Одно поле «Исполнитель» — необязательноеЭтот исполнитель — для заявок из любого офиса
«Только в указанных офисах»Строки «Офис» и «Исполнитель»; новая строка — кнопкой «Добавить офис». Офис обязателен, исполнитель в строке — нет. Один офис можно указать только в одной строкеИсполнитель офиса заявки. Если для этого офиса исполнитель не задан, берётся исполнитель родительского офиса — на один уровень вверх. Не нашёлся и там — заголовок не передаётся

Офис заявки определяется по её объекту: для заявки «В офисе» — офис стола, переговорной, парковки, локера или информационного объекта, для заявки «В переговорной» — офис переговорной, для заявки «Для сотрудника» — офис, который сотрудник выбрал в форме. В режиме «Только в указанных офисах» сервис виден сотрудникам только в перечисленных офисах и в их непосредственно дочерних офисах.

Исполнитель в строке офиса обязателен только при обработке внутри UnSpot. Если заблокировать сотрудника, UnSpot сам снимет его и с общего поля «Исполнитель», и со всех строк офисов; если удалить офис, исчезнут его строки.

Поля интеграции

ПолеОбязательноеЧто задаёт
«Email внешней тикет системы, на который отправлять заявки»ДаЕдинственный получатель письма. Указывайте тот адрес, из которого ваша тикет-система создаёт тикеты
«Исполнитель» (секция «Доступность в офисах»)НетЕго адрес передаётся в служебном заголовке X-Assignee. Для сервиса с внешней обработкой исполнитель не обязателен — в отличие от внутреннего, — ни в общем поле, ни в строках офисов
«Наблюдатели за ходом выполнения заявки»НетИх адреса уходят во внешнюю систему: заголовком X-Observers через запятую либо, если включена копия наблюдателям, в поле cc
«Идентификатор проекта или задачи» (необязательно)НетПроизвольный текст до 255 символов, попадает в заголовок X-Project-ID без изменений. Подсказка в интерфейсе предлагает форматы PROJECT-123, support, AbCf-03
«Уровень критичности заявок для сервиса» (необязательно)НетПроизвольный текст до 255 символов, попадает в заголовок X-Priority без изменений. Подсказка предлагает Low / Medium / High / Critical либо формат, принятый в вашей системе
«Отправлять инициатору копию письма заявки»НетДобавляет автора заявки в копию письма
«Отправлять исполнителю копию письма заявки» (секция «Доступность в офисах»)НетДобавляет в копию письма исполнителя заявки — общего или исполнителя офиса
«Отправлять наблюдателям копию письма заявки»НетДобавляет наблюдателей в копию письма вместо заголовка X-Observers. Чекбокс доступен, только когда выбран хотя бы один наблюдатель

Значения «Идентификатора проекта» и «Уровня критичности» UnSpot не проверяет: это свободный текст, который передаётся в заголовок письма байт в байт. Работать они будут ровно настолько, насколько ваша тикет-система умеет их разбирать, — сверьтесь с её правилами обработки почты, прежде чем заполнять поля.

Поля заявки и SLA

Секция «Поля заявки на сервис» работает при внешней обработке так же, как при внутренней: у полей «Срок исполнения» и «Файлы и изображения» есть переключатель и чекбокс «Обязательное». Отметить поле обязательным можно, только когда оно включено. У сервиса «В переговорной» «Срок исполнения» включён и обязателен всегда.

  • «Срок исполнения» — дата, которую сотрудник указывает в заявке, уходит в тикет-систему заголовком X-Duedate.
  • «Файлы и изображения» — приложенные сотрудником файлы прикрепляются к письму. Если поле выключено, приложить файл к заявке нельзя.

SLA для внешней обработки недоступен. Как только в секции «Где обрабатывать заявки» выбрана «Во внешней тикет системе», секция с переключателями «SLA реакции» и «SLA выполнения» пропадает из формы: сроки реакции и выполнения отслеживает ваша тикет-система, а не UnSpot.

Что уходит в письме

Тема письма — это название сервиса, без даты и без номера заявки. Тело письма содержит заголовок «Заявка на сервис отправлена», блок с данными объекта (для заявок «В переговорной» — дату, название встречи и организатора; для заявок «В офисе» — место и офис), блок самой заявки (сервис, текст обращения, исполнитель, статус, комментарий) и кнопку «Перейти в UnSpot», ведущую на карточку заявки. Файлы, приложенные сотрудником, прикрепляются к письму.

Кроме видимой части письмо несёт служебные заголовки — по ним тикет-система раскладывает заявки:

ЗаголовокЗначениеКогда передаётся
X-AssigneeАдрес исполнителя заявки: общего исполнителя сервиса или исполнителя офиса заявкиЕсли у заявки есть исполнитель и он активен
X-ObserversАдреса наблюдателей через запятуюЕсли наблюдатели заданы и чекбокс «Отправлять наблюдателям копию письма заявки» выключен
X-StatusПостоянное значение NewВсегда
X-Unspot-IDИдентификатор заявки в UnSpotВсегда
X-PriorityЗначение поля «Уровень критичности заявок для сервиса»Если поле заполнено
X-Project-IDЗначение поля «Идентификатор проекта или задачи»Если поле заполнено
X-DuedateСрок исполнения заявки — дата и время в формате ISO 8601 со смещением часового пояса: ГГГГ-ММ-ДДTчч:мм:сс±чч:ммЕсли у сервиса включено поле «Срок исполнения» и сотрудник указал срок

Адреса исполнителя и наблюдателей уходят во внешнюю систему в любом случае — меняется только способ. Заголовок X-Assignee передаётся независимо от чекбокса копии исполнителю. Наблюдатели попадают либо в заголовок X-Observers, либо — при включённой копии наблюдателям — в поле cc, и тогда заголовка X-Observers в письме нет. Учитывайте это в правилах разбора тикет-системы. Если рабочие адреса сотрудников не должны покидать контур компании, не назначайте исполнителя и наблюдателей у сервисов с внешней обработкой.

Значение поля «Уровень критичности заявок для сервиса» передаётся в заголовок X-Priority без изменений. Если вы указываете словесные уровни вроде «High» или «Critical», убедитесь, что ваша тикет-система разбирает текстовые значения этого заголовка.

Блок «Структура письма» в форме сервиса — схема, а не точная копия письма. Он берёт значения из формы, поэтому в режиме «Только в указанных офисах» в строке X-Assignee стоит «не указано»: исполнитель офиса определяется в момент создания заявки. Строка X-Observers в блоке заполнена и при включённой копии наблюдателям, хотя в письмо такой заголовок в этом случае не попадёт. Строка X-Duedate показывает «<Срок исполнения>», если поле срока у сервиса включено.

Копии письма и обратный адрес

Копии отправляются в открытом поле cc: все получатели видят адреса друг друга. Скрытых копий нет. Повторяющиеся адреса UnSpot убирает: если, например, инициатор заявки одновременно её исполнитель, копию он получит одну. В копию попадают только активные сотрудники — заблокированный или удалённый инициатор письмо не получит.

Обратным адресом письма ставится адрес инициатора заявки, если он известен, — так ответ из тикет-системы попадёт сотруднику напрямую. У заявок, отправленных по QR-коду без входа в аккаунт, инициатора нет: такое письмо уходит без обратного адреса, и ответить на него будет некому. Учитывайте это, если включаете внешнюю обработку у публичного сервиса.

Что происходит с заявкой после отправки

  • Заявка сохраняется в UnSpot и видна на странице «Заявки на сервис» наравне с остальными.
  • Её статус — «Отправлена». Это финальный статус: кнопок обработки у такой заявки нет, сменить статус или исполнителя невозможно.
  • История статусов состоит из одной записи — самой отправки.
  • Письмо уходит один раз, в момент создания заявки. Последующих писем по этой заявке не будет.
  • Срок исполнения, если он указан, виден в карточке заявки и в колонке «Исполнение» списка.
  • Вложения остаются доступны для скачивания из карточки заявки в UnSpot.

Что учесть при настройке

ОсобенностьКак с этим работать
Статус «Отправлена» означает, что UnSpot отправил письмо. Подтверждение доставки UnSpot не получает и в заявке не отражаетКонтролируйте поступление заявок на стороне тикет-системы, а не по статусу в UnSpot
Передача односторонняя: номер тикета из внешней системы не возвращается, статус в UnSpot не синхронизируетсяЕсли сотруднику нужен номер тикета, настройте автоответ на стороне тикет-системы — обратный адрес письма ведёт к инициатору заявки
Тема письма совпадает у всех заявок одного сервисаНастройте правила разбора тикет-системы на заголовок X-Unspot-ID, а не на тему письма
Наблюдатели приходят то заголовком X-Observers, то копией — в зависимости от чекбоксаОпределитесь с чекбоксом «Отправлять наблюдателям копию письма заявки» до настройки правил разбора и не меняйте его без правки этих правил
SLA для внешней обработки недоступенЗадайте сроки реакции и выполнения в самой тикет-системе
У сервисов, созданных до появления секции «Поля заявки на сервис», поле «Файлы и изображения» выключеноЕсли сотрудникам нужно прикладывать файлы к заявке, включите поле в настройках сервиса
Способ обработки задаётся один раз, при создании сервисаОпределитесь до первого сохранения; для смены — удалить сервис и создать заново
В форме заявки не указано, что сервис обрабатывается во внешней системеНапишите об этом в поле «Описание сервиса» — оно показывается сотруднику под выбранным сервисом

Связанные статьи

Оставьте заявку, и мы свяжемся с вами в течение 30 минут.

Loading

Как улучшить работу офиса?

Оставьте контакт - покажем на демо как уйти от таблиц, двойных бронирований и путаницы с рабочими местами.

Loading