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

Выбор способа обработки нельзя изменить после сохранения. В форме редактирования сервиса чипсы «Тип сервиса» и «Где обрабатывать заявки» доступны только для чтения — меняются лишь остальные поля, в том числе доступность в офисах и исполнители. Чтобы перевести сервис с внутренней обработки на внешнюю, придётся удалить его и создать заново, а удалить сервис с внутренней обработкой можно только после того, как все его заявки перейдут в статус «Выполнена» или «Отклонена». Планируйте это до первого сохранения.
Исполнитель и офисы
Исполнитель для внешней обработки нужен не для работы с заявкой, а для письма: его адрес уходит в заголовке 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 для внешней обработки недоступен | Задайте сроки реакции и выполнения в самой тикет-системе |
| У сервисов, созданных до появления секции «Поля заявки на сервис», поле «Файлы и изображения» выключено | Если сотрудникам нужно прикладывать файлы к заявке, включите поле в настройках сервиса |
| Способ обработки задаётся один раз, при создании сервиса | Определитесь до первого сохранения; для смены — удалить сервис и создать заново |
| В форме заявки не указано, что сервис обрабатывается во внешней системе | Напишите об этом в поле «Описание сервиса» — оно показывается сотруднику под выбранным сервисом |
Связанные статьи
- Заявки на сервис: обзор — какие бывают типы сервисов и что выбрать
- Обработка заявок на сервис — как обрабатываются заявки внутри UnSpot
- Заявки «Для сотрудника»: настройка — настройка заявок «Для сотрудника»
- Заявки «В офисе»: настройка и QR-коды — настройка заявок «В офисе» и QR-коды
- Заявки «В переговорной»: настройка — настройка заявок «В переговорной»