Страница заявки — основное рабочее пространство сотрудника службы поддержки. Здесь собраны переписка с клиентом, действия по заявке, участники, свойства, SLA и дополнительные рабочие блоки.
С чего начать
Выберите нужный раздел в зависимости от задачи:
Работа с диалогом — вкладки «Комментарии», «События» и «Сессия», ответы клиенту, внутренние комментарии, упоминания и действия с сообщениями.
Участники и свойства заявки — ответственный, наблюдатели, CC/BCC, клиент, компания, приоритет, статус, группа, кастомные поля, навыки и подключение ИИ-агента к заявке.
Дополнительные блоки — активы, трудозатраты, внешние и дочерние заявки, возможные дубли, RCA и собственные виджеты.
Поиск в заявке — поиск по базе знаний и связанным материалам.
Нейропоиск — поиск ответа по смыслу запроса с помощью ИИ.
Собственные виджеты — дополнительные мини-приложения, например блок «Быстрые заметки».
Блоки справа на странице заявки
В правой части страницы могут отображаться стандартные и дополнительные блоки. Их набор зависит от настроек системы, лицензии, интеграций и включённых фича-флагов.
Участники — ответственный, наблюдатели, клиент, компания, CC/BCC, каналы уведомлений и последний комментатор.
Свойства — тип, приоритет, статус, группа, исходный канал, язык и другие поля заявки.
Поиск, Нейропоиск и статьи KCS — поиск информации и привязка знаний к заявке.
Задачи трекера — просмотр и создание связанных задач разработки при настроенной интеграции.
Возможные дубли — поиск заявок с похожей темой и объединение повторных обращений.
Внешние заявки — взаимодействие с внешними контрагентами или смежными подразделениями.
Быстрые заметки — пример собственного виджета для локальных заметок сотрудника.
Выгрузить заявку позволяет выгрузить все или только публичные комментарии в PDF или HTML.
Объединить заявку позволяет объединить две заявки. Подробнее: Объединение заявок.
Создать новую заявку на основе текущей позволяет отделить новый вопрос клиента от текущего диалога.
Создание новой заявки из существующей
Функция полезна, если в одном диалоге нужно разделить несколько разных вопросов. При создании новой заявки открывается форма, где нужно указать текст нового обращения. Свойства, продукт и значения кастомных полей переносятся из исходной заявки.
Статус заявки помогает быстро определить стадию работы с заявкой. Кроме того, в списке заявок удобно использовать фильтры по статусам заявок, чтобы видеть только нужные в данный момент заявки.
Виды статусов заявок
В системе доступны следующие статусы заявок:
Новая - статус новой созданной клиентом заявки, на которую не было ни одного ответа от агента. После поступления новой заявки в ней начинает работать счётчик первого ответа в виде обратного отсчёта до выполнения настроенной политики SLA:
После любого ответа на обращение клиента этот счётчик останавливается.
Если отсчёт достиг времени первого ответа, он меняется на прямой отсчёт времени с момента поступления заявки.
Открытая - статус заявки, в которой есть какой-либо диалог (клиенту был дан ответ). Присваивается автоматически.
Ожидает ответа клиента - статус, присвоенный сотрудником вручную справа от диалогового окна в блоке Свойства или при отправке ответа. Подробнее опишем ниже.
Ожидание - вручную присваиваемый статус для заявки, к которой надо будет вернуться через заданное время. Дату и время переоткрытия такой заявки можно установить при присвоении заявке такого статуса в блоке Свойства справа от диалогового окна. После установки статуса можно выбрать самостоятельно время переоткрытия или задать предложенное значение из спика:
После сохранения времени переоткрытия в заявке можно будет увидеть, на какое время её отложили:
Решение предоставлено - статус, присваиваемый сотрудником вручную справа от диалогового окна в блоке Свойства или при отправке ответа. Подробнее опишем ниже.
Удалена - статус, присваиваемый вручную в блоке Свойства справа от диалогового окна. Доступен для выставление только Администраторам.
Закрыта - автоматически присваиваемый статус после настроенного количества времени с момента присвоения статуса Решение предоставлено или Ожидает ответа клиента, если клиент ничего не написал в ответ. Доступен для ручного выставления только Менеджерам и Администраторам.
Изменение статуса заявки
Статус можно изменить при отправке ответа клиенту. Можно просто отправить ответ, но можно отправить ответ с одновременным присвоением статуса стрелкой справа от кнопки ответа:
Кроме того, статус можно изменить в блоке Свойства справа от основного блока заявки:
Автоматическое изменение статуса
С Новая на Открытая - при отправке ответа клиенту.
С Ожидает ответа клиента на Решение предоставлено - по истечении настраиваемого под клиента интервала времени, если не было ответа клиента.
Для этого статуса настраивается 3 временных интервала: день Х от перевода в статус Ожидает ответа клиента, день Y и день Z.
Если клиент не ответил в день Х или ранее, клиенту на почту отправляется уведомление, что от него ожидается ответ в день Y. Если клиент снова не ответил в день Y или ранее, то в день Z заявка автоматически переводится в статус Решение предоставлено.
По умолчанию Х=7 дней, Y=10 дней, Z=14 дней (можно перенастроить при внедрении системы).
С Решение предоставлено на Закрыта - по истечении настраиваемого под клиента интервала времени, если не было ответа клиента.
По присвоению заявке статуса Решение предоставлено клиенту в личный кабинет и на почту отправляется запрос на заполнение формы обратной связи (CSAT).
Если клиент заполнил его, заявка переходит в статус Закрыта. Если клиент что-либо ответил, заявка переходит в статус Открытая. Если клиент проигнорировал запрос, заявка переходит в статус Закрыта через 7 дней (можно перенастроить при внедрении системы).
С Решение предоставлено и Ожидание ответа клиента на Открытая - если клиент что-то ответил.
С Ожидание на Открытая - по истечению времени, на которое заявка была отложена.
ВАЖНО! Система позволяет объединять заявки только от одной и той же Компании (пользователи могут быть разными) в целях предотвращения случайной утечки данных. Если вам нужно объединить заявки от разных Компаний, то перед этим вам нужно унифицировать поле Заявка от и синхронизировать его заявки.
Функция объединения заявок может пригодиться, если вы хотите объединить две заявки одного пользователя в один диалог. Например, это может пригодиться в случае, если пользователь создал новую заявку для уточнения вопроса, который уже обсуждался в другой заявке.
Кнопка объединения заявок находится на странице заявки в титульном блоке справа:
Объединение заявок нельзя отменить!
После нажатия на кнопку объединения заявок система предложит найти объединяемую заявку по ключевым словам:
Если заявка не найдена, но в ключевых словах ошибки нет, убедитесь, что искомая заявка принадлежит тому же пользователю. Объединить заявки от разных пользователей не получится.
Когда заявка найдена, нажмите "Выбрать заявку".
В следующем открывшемся окне вам будет предложены опции, что именно нужно будет перенести в объединённую заявку. После выбора опций нажмите "Объединить". После этого объединение нельзя будет отменить, исходная заявка перестанет существовать, вся выбранная информация и диалог с клиентом перенесётся в новую объединённую заявку:
Каждая заявка в соответствии со стандартами KCS должна содержать статью или несколько статей, в которых раскрывается содержание раскрываемых в заявке тем. Для этого на странице заявки находится отдельный блок статей KCS Статьи. Если к заявке ещё не прикреплена ни одна статья, блок статей выглядит так:
Поиск по базе знаний можно осуществить либо с использованием ИИ Нейропоиска, либо по поисковой фразе. При стандартном поиске система использует полнотекстовый PostgreSQL движок.
Если в списке найдена подходящая статья, открыть ее можно нажатием на тему, и, если она подходит, прикрепить её к заявке кнопкой Добавить в заявку:
Нейропоиск - поиск по базе знаний с использованием нейросети. Подробнее.
Доступные источники для поиска. Каждый источник находится в отдельной вкладке.
Название статьи. По клику на него статья открывается в редакторе в отдельном окне.
Отрывок из статьи, в котором нашлось совпадение из поисковой строки.
Добавить в заявку - связать заявку с данной статьей. Статья будет отображаться в виджете как добавленная: Показать текст статьи - разворачивает статаю, чтобы было видно содержимое. Выбранное состояние статьи (свернутое или развернутое) сохраняется во всех заявках до очистки локального хранилища. - открепить статью от заявки. Статья при этом не удалится из системы, а будет только откреплена.
Статус показывает в каком из статусов находится статья. Подробнее.
Релевантность - коэффициент релевантности, присвоенный статье поисковым движком. Отображает насколько статья подходит под поисковый запрос. Статьи в списке отображаются в порядке уменьшения релевантности.
Если статья не найдена, удалите содержимое поля поиска и создайте статью с помощью ИИ ассистента (1) или вручную (2):
Поиск по заявкам
Кроме статей поле поиска позволяет искать и по заявкам, в которых встречаются запрашиваемые ключевые слова. Например, клиент ссылается на другую заявку, либо в ней была аналогичная ситуация. Чтобы просмотреть, достаточно переключиться на вкладку Заявки:
Если у вас настроена интеграция с таск-трекером (например, Jira, Gitlab или Yandex Tracker), вы можете осуществлять из заявки поиск по существующим в ней задачам. Тогда помимо вкладок "статьи" и "заявки" под полем поиска будет ещё третья вкладка с задачами:
А если у вас подключен дополнительный внешний источник знаний, то появится соответствующая дополнительная вкладка:
В Swarmica можно создавать шаблоны наиболее используемых ответов на популярные вопросы, чтобы не набирать их каждый раз вручную.
Создание шаблонов
Создать шаблон можно двумя способами: в разделе Шаблоны ответов и на странице заявки сделать шаблоном отправленный ответ. Разберем каждый.
Создание шаблона в разделе Шаблоны ответов
В раздел Шаблоны ответов нажмите Создать:
В появившемся окне заполните нужные поля:
Название - название будущего шаблона
Панель редактирования - инструменты для форматирования текста.
Основное поле - содержимое шаблона, которое будет отправляться в заявках.
Сделать общим - делает ваш шаблон доступным для использования всем сотрудникам. Они не смогут отредактировать или удалить его.
Язык - если в системе используется несколько локалей, можно выбрать ее для шаблона. Используется для автоматической фильтрации.
Группы - какой из групп принадлежит шаблон (можно выбрать несколько). Другие группы тоже смогут найти шаблон при необходимости. Используется для автоматической фильтрации.
Категории - позволяет задать категорию шаблонов, созданную в Настройках - Категории шаблонов ответов.
Сохранить - сохранить готовый шаблон.
При необходимости можно отменить создание шаблона соответствующей кнопкой в нижнем левом углу окна.
Создание шаблона из отправленного ответа
На странице заявки нажмите Сохранить как шаблон для выбранного ответа:
Откроется окно создания шаблона. Заполните окно, как указано в предыдущем разделе.
Применение шаблонов
Вызвать окно вставки шаблонов можно двумя способами.
Через кнопку Шаблоны
В редакторе написания ответа в заявке выберите Шаблоны:
Откроется окно выбора шаблона:
Поиск шаблона по ключевым словам.
Вкладки - для переключения между личными и общими шаблонами.
Вставить - шаблон сразу вставляется в поле ответа. Если в поле ответа был какой-либо текст, он полностью заменяется на выбранный шаблон. После вставки шаблона ответ можно будет дополнить или отредактировать перед отправкой.
Копировать - содержимое шаблона копируется в буфер обмена, и его можно вставить в нужную часть ответа.
Меню - для редактирования или удаления шаблона.
Параметры шаблона, заданные при создании/редактировании: кто создал шаблон, его группы, навыки и категории.
Фильтрация - параметры для фильтрации шаблонов.
Закрыть окно выбора шаблона.
Через горячие клавиши (хоткей)
Чтобы не выходить из окна заявки, вызвать меню шаблонов можно по кнопке #. После ее нажатия появляется небольшое вспылавающее окно с шаблонами для быстрого доступа:
Блок «Возможные дубли» помогает находить заявки с одинаковой темой. Это полезно, когда клиент несколько раз отправляет одно и то же письмо или сообщение.
Как работает механизм
Swarmica показывает заявки, которые могут быть дублями текущей. В списке можно открыть подходящую заявку, сравнить обращения и выбрать заявки для объединения.
Объединение позволяет продолжить работу с одним обращением и не вести параллельную обработку нескольких одинаковых тикетов.
Когда это полезно
клиент повторно отправил одно и то же сообщение;
сообщение отправлено через несколько каналов;
несколько сотрудников зарегистрировали один и тот же запрос.
Важно учитывать производительность
При больших объёмах заявок механизм поиска возможных дублей может влиять на производительность системы. Поэтому включайте его только в том случае, если такая проверка действительно нужна. Перед включением на крупной базе рекомендуется оценить нагрузку и проверить работу функции.
Как включить блок
Для отображения блока активируйте фича-флаг __show_ticket_duplicates. Общие правила настройки описаны в статье «Фича-флаги (features) в Swarmica».
После активации флага функция доступна при наличии соответствующей лицензии.
Внутренние, или дочерние, заявки помогают передавать отдельные задачи во внутренние отделы компании, сохраняя их связанными с исходной заявкой клиента.
Например, обращение клиента может потребовать действий со стороны разработки, системных администраторов, финансового отдела или другой команды. Вместо передачи задачи по почте или в мессенджере сотрудник создаёт дочернюю заявку прямо из основной.
Как это работает
дочерняя заявка создаётся из основной и сохраняет связь с ней;
исполнитель внутренней команды работает со своей заявкой, а владелец основной видит общий контекст;
статус дочерней заявки можно отслеживать;
история переписки остаётся связанной с исходным обращением;
ответ в дочерней заявке может автоматически переоткрыть основную.
Зачем использовать дочерние заявки
Дочерние заявки помогают не терять работу на внутренних стыках. Владелец основной заявки видит, какая команда выполняет задачу и на каком она этапе, а клиент получает более актуальный статус обращения.
Анализ первопричин, или RCA (Root Cause Analysis), помогает разобраться, почему произошёл конкретный инцидент, зафиксировать результаты расследования и передать понятное объяснение заинтересованным сторонам.
В Swarmica RCA оформляется как отдельный документ, связанный с инцидентом или заявкой. Документ можно подготовить вручную или сгенерировать с помощью ИИ, используя один из шаблонов.
Что можно делать с RCA-документом
создавать черновик анализа с помощью ИИ и затем проверять и утверждать его;
использовать разные шаблоны для разных сценариев;
разделять информацию на публичную часть для клиента и внутреннюю часть для команды;
экспортировать документ в PDF или Markdown.
RCA и статья базы знаний
RCA и статья KCS решают разные задачи:
RCA отвечает на вопрос, почему произошёл конкретный инцидент;
статья KCS сохраняет решение, которое можно повторно использовать при похожих обращениях.
RCA создаётся после установления причин инцидента, а статью KCS можно начать создавать сразу после выявления симптомов и найденного способа решения.
Помимо стандартных элементов страницы заявки, в Swarmica доступны дополнительные блоки. Они помогают работать с активами, учитывать трудозатраты, связывать заявки с внешними системами и дополнять заявку специализированной информацией.
Ниже перечислены доступные типы блоков. Для каждого блока указана подробная статья, если она уже опубликована. Если отдельной статьи пока нет, это отмечено прямо в списке.
Доступные типы блоков
Управление активами — работа с активами, связанными с заявками и сотрудниками.
Внешние заявки — создание и отображение заявок, связанных с внешними системами. В старых статьях этот блок может называться «исходящие тикеты».
Внутренние заявки — создание связанных дочерних заявок (child tickets) для выполнения отдельных работ.
Возможные дубли — отображение похожих заявок, которые могут быть дублями текущей.
Анализ первопричин — создание и использование документов Root Cause Analysis (RCA).
Собственные виджеты — встраивание произвольных виджетов в интерфейс Swarmica.
Фича-флаги для включения блоков
Чтобы включить нужные блоки, активируйте соответствующие фича-флаги в конфигурации Swarmica. Полный список фича-флагов и общие правила их настройки описаны в статье «Фича-флаги (features) в Swarmica».
Блок
Фича-флаг
Что включает
Управление активами
assets
Блок управления активами.
Управление трудозатратами
time_tracking
Учёт времени работы над заявкой.
Внешние заявки
external_tickets
Интерфейс внешних заявок.
Внутренние заявки
child_tickets
Связанные дочерние заявки.
Возможные дубли
__show_ticket_duplicates
Блок возможных дублей заявки.
Анализ первопричин (RCA)
rca
Документы анализа первопричин.
Собственные виджеты
ui_widgets
Встраивание произвольных виджетов.
Пример настройки
Добавьте нужные флаги в переменную FEATURES в файле /root/swarmica/.env. Флаги указываются через запятую, без пробелов. Например:
На странице заявки блок SLA показывает состояние целей SLA, применённых к заявке. Общий обзор страницы заявки доступен в статье «Страница заявки».
Как настроить SLA
Политики SLA создаются и настраиваются в разделе Настройки → Управление политиками SLA. Подробнее: Управление политиками SLA.
Режимы отображения счётчика
Каждый компонент блока SLA является счётчиком времени цели SLA. Режим отображения можно изменить нажатием на счётчик. Выбранный режим будет использоваться и в следующих открытых заявках; для разных счётчиков можно выбрать разные режимы.
Обратный отсчёт времени до выполнения SLA 
Цель по SLA 
Прямой отсчёт времени выполнения SLA 
Прогресс-бар — показывает прогресс выполнения цели в процентах. Если цель не выполнена по истечении времени, индикатор достигает 100% и становится красным. 
Эта статья описывает вкладки диалога, ответы клиенту, внутренние комментарии, упоминания и действия с сообщениями. Общий обзор страницы заявки доступен в статье «Страница заявки».
Вкладки блока диалога
В блоке диалога отображается переписка с клиентом и история работы с заявкой:
Комментарии
Вкладка открыта по умолчанию и содержит весь диалог с клиентом. Порядок сообщений можно изменить кнопкой в правой части блока. По умолчанию новые сообщения отображаются сверху.
В правой части сообщения доступны действия: сохранить ответ как шаблон, закрепить сообщение, создать новую заявку на основе комментария, создать связанную внешнюю заявку и воспользоваться Нейропоиском.
На вкладке отображаются события по заявке: переназначение ответственного, создание новой заявки, изменение приоритета, изменение кастомных полей и другие действия.
Сессия
Вкладка показывает действия клиента в сессии: какие запросы он отправлял, какие статьи находил и читал. Это помогает учитывать контекст при работе с обращением.
Ответ и внутренний комментарий
Блок ответа или комментария находится внизу вкладки «Комментарии» и по умолчанию свёрнут.
Перетащить — переместить редактор в подсвеченную область.
Развернуть — открыть редактор в выбранном режиме.
В развернутом редакторе доступны форматирование, функции ИИ, прикрепление файлов, режим черновика, конфиденциальные данные, обработка динамических данных Jinja, скрытие файлов и назначение заявки на себя.
По умолчанию вкладка «Ответ» открывается в режиме «Черновик». Перед отправкой ответа выключите этот режим.
Упоминания
Во внешнем и внутреннем комментарии можно упомянуть коллегу, клиента или группу. Нажмите `@` и выберите пользователя из списка. Упомянутый пользователь будет добавлен в CC и получит уведомление.
Необходимо отправлять ответы из Swarmica так, чтобы все получатели видели, кто находится в копии в CC, и чтобы отвечающий также отвечал всем, кто есть в копии. Однако при отправке письма получатели не видят, кто ещё находится в копии, и отвечают только отправителю.
Решение
Мы подготовили пример настройки, чтобы в письме списком были показаны адреса, указанные в копии. Результат будет выглядеть таким образом:
Текст обозначения людей в копии можно заменить на любой другой. Для настройки:
Перейдите в Настройки — Настройки почтовых шаблонов — Любой ответ добавлен в мою заявку.
В блок {% block header %} добавьте код:
{% if ticket.cc.exists() %}
Уведомление отправлено {% for ccu in ticket.cc.all() %}{{ccu.email}}, {% endfor %}
{% endif %}
В самом шаблоне блок header будет выглядеть так:
Также клиентам отправляются уведомления по шаблонам Мой ответ добавлен и Моя заявка создана. Эти шаблоны нужно отредактировать по такому же принципу.
Причина
В системе Swarmica реализована определённая логика работы, которая не позволяет отправлять письма с указанием всех получателей в копии. Когда агент оставляет комментарий в тикете, система отправляет персональные уведомления каждому участнику переписки отдельно.
Такая логика работы реализована намеренно, поскольку Swarmica — это система управления обращениями, а не почтовый клиент. Отправка персональных уведомлений каждому участнику переписки обеспечивает удобство восприятия и гарантирует сохранение личных данных участников, предотвращая несанкционированный сбор контактов.
При работе в Swarmica появляется ошибка `Network error` Иногда ошибка возникает после выхода компьютера из сна или переподключения VPN, а иногда стабильно воспроизводится только в корпоративной сети.
Эта ошибка может приводить к потере сетевых пакетов и задержкам. Она относится к инфраструктуре Hyper-V/сети и не доказывает наличие ошибки в Swarmica.
Причины
кратковременный обрыв или переключение сети, VPN, Wi‑Fi;
истёкшее или прерванное соединение браузера после простоя;
корпоративный WAF, прокси или другое сетевое средство безопасности блокирует API-запросы либо переписывает их URL;
нестабильность сетевого интерфейса виртуальной машины или Hyper-V.
Что сделать пользователю
Обновить страницу.
Проверить работу без VPN или из другой сети, с мобильного телефона. Если в другой сети всё работает, вероятна проблема корпоративной сети.
Повторить действие после переподключения к сети/VPN.
Открыть инструменты разработчика браузера (F12) → Network → Fetch/XHR, повторить действие и сохранить URL, метод, HTTP-статус и сведения о запросах со статусами `403`, `404`, `5xx` или пометкой blocked.
Что передать службе ИБ или администратору сети
Попросить проверить WAF, прокси и правила фильтрации трафика к домену Swarmica. Важно убедиться, что API-запросы не блокируются и не переписываются, в частности запросы вида `/api/users/{uid}/`. Если используется виртуальная машина, проверить системные журналы Hyper-V и сетевого интерфейса на ошибки `hv_netvsc`. Для диагностики приложить время ошибки, URL/метод запроса, HTTP-статус и HAR-файл без токенов авторизации и персональных данных.
Когда обращаться в поддержку
Если ошибка сохраняется в разных сетях или после обновления страницы, направьте в поддержку скриншот, время возникновения, браузер, способ подключения и данные из Network без секретных заголовков. Если проблема возникает только в корпоративной сети, сначала передайте результаты проверки службе ИБ или сетевому администратору.
Данный скрипт обрабатывает файл .csv, который содержит данные о тикетах и новых ключах.
CSV файл поддерживает:
Разделители: ",", ";", "|", "\t"
Названия колонки с ID тикета(не зависит от регистра): 'id', 'ticket id', 'ticket_id', 'ticketid', 'номер тикета', 'тикет'
Названия колонки с UID новой лицензии(не зависит от регистра): 'new_ticket license uid', 'license uid', 'license_uid', 'new license uid', 'uid лицензии', 'license', 'new license'
1. Подключитесь к серверу Swarmica по SSH как root
2. Загрузите CSV файл в контейнер swarmica-django-1 в папку uploads:
Как сделать, чтобы все заявки с определенной почты назначались только в конкретную группу?
Решение
Зайдите в Настройки - Автоназначение заявок - Создать новое правило:
Введите Название и Описание правила на всех добавленных локалях.
В условиях выберите Исходный канал = адрес вашего Email-канала и нажмите Добавить
Далее выберите группу, за которой нужно закрепить канал:
Если вы хотите перемещать все заявки с Email-канала в группу без назначения ответственного, поставьте флаг И не назначать никого:
Если необходимо назначать Ответственного, задайте условия для его выбора:
Сохраните правило.
Добавьте правило в действующие правила, нажав на +.
После выполнения этих шагов правило автоназначения начнёт работать, и все заявки, направленные на указанный Email-канал, будут помещены в выбранную группу.
Как удалить файл из комментария в тикете и с сервера?
Решение
В Swarmica есть 2 типа удаления файлов: мягкое и полное.
При мягком удалении файл удаляется, однако остается отметка, что файл был.
При полном удалении записей в комментарии об удаленном файле не остается.
Чтобы функционал Удаления вложений работал, необходимо включить __delete_comment_attachments фича-флаг. Подробнее про включение/выключение фича-флагов.
Мягкое удаление
Справа от прикрепленного файла откройте меню Действия - Удалить:
Для удаления скриншота наведите на него, тогда появится меню Действия в правом верхнем углу:
В появившемся окне введите название файла, для подтверждения удаления, и выберите Удалить:
Напротив удаленного файла появится соответствующая надпись:
В Событиях останется запись о действии:
Полное удаление
После выбора действия Удалить, в появившемся окне введить название файла и активируйте чекбокс Удалить полностью - Удалить:
Файл удалится из комментария полностью, без отметки о том, что он был:
Онлайн — на сотрудника будут назначаться заявки через автоназначение.
Оффлайн — на сотрудника не назначаются заявки через автоназначение. Если включён балансировщик, и у сотрудника в статусе Оффлайн переоткроется заявка, то балансировщик может её снять и назначить другого ответственного.
В работе и Перерыв — на сотрудника не назначаются новые заявки через автоназначение и не снимаются балансировщиком в случае переоткрытия. Разница между этими статусами заключается только в названии, которое помогает менеджеру понять, чем занимается сотрудник.
Статус Перерыв означает, что сотрудник отошёл, например, на обед или за кофе.
Статус В работе — что сотрудник занят какой-то задачей и не может сейчас брать новые заявки.
Индекс SLA - интегральный показатель, учитывающий на сколько в каждой из заявок нарушены SLA политики, сколько осталось, какие из них активны и тд.
Индекс SLA показывает совокупное нарушение всех незавершенных SLA метрик в данной заявке. Чем больше значение, тем значительнее нарушение незавершенных показателей SLA.
То есть, это отношение того, что осталось, к тому, что является целевым показателем, если SLA счетчик не выполнен (тикает) в заявке. И чем больше просрочен показатель, тем больше его значение.
is_running = 1, если счетчик в заявке не выполнен (тикает). is_running = 0, если счетчик в заявке остановлен.
Например, если первый ответ уже дан в заявку, то для этой метрики is_running = 0.
Общий Индекс SLA - это сумма индексов всех счетчиков.
Что дает Индекс SLA
Рекомендуется его вывести в фильтрах, и по нему сортировать список по убыванию (так как самый высокий индекс свидетельствует о самых значительных SLA нарушениях):
По Индексу SLA так же осуществляется перераспределение заявок балансировщиком.
Например: У агентов стоит ограничение пол количеству назначенных заявок, и все сейчас заняты. Скопилось в очереди 10 новых/переоткрывшихся заявок. И когда 1 из сотрудников освободится, на него назначится заявка с самым высоким Индексом SLA.
Имеется два инстанса Swarmica, в которых работают разные команды поддержки. Иногда в первый инстанс клиенты по ошибке заводят тикеты, предназначенные для команды, которая работает во втором инстансе. Требуется как-то прозрачно передать тикет второй команде.
Решение
Для решения задачи можно использовать функцию исходящих веб-хуков. Например можно сделать логику, что при переводе тикета в определенную группу будет посылаться вебхук во второй инстанс и создавать там тикет, дублируя запрос, тему, и отправителя.
Для того, чтобы создать такое действие:
Идем на ВТОРОЙ ИНСТАНС и создаем там API токен в разделе Настройки > API и интеграции
Идем на ПЕРВЫЙ ИНСТАНС в Настройки > Действие по событию и нажмите Создать + Исходящий вебхук. Заполните название.
В левой части экрана выберите Тип события TicketEvent = Ticket Group Changed
Добавьте поле Новое значение и сделайте его равным требуемой группе.
В правой части нажмите Создать. Заполните название.
В поле URL прописываем путь до ендпоинта: https://URL_второго_инстанса/api/tickets/
Выбираем метод POST
Заполняем Заголовок и Данные (см. пример ниже) и Сохраняем вебхук.
В левой части Меняем Статус на Включен и Сохраняем действие.
{"subject":"{{event.ticket.subject}}","comment":{% set comment = event.ticket.comments.order_by('created_at').first() %}{% if comment %}{{ comment.body | tojson}}{% endif%},"requester_email":"{{event.ticket.requester.email}}"}
Теперь при переводе тикета на первом инстансе в указанную группу, вебхук будет создавать новый тикет с той же темой и тем же первым комментарием и отправителем на втором инстансе, где вторая команда может уже с ним работать.
Требуется публиковать статьи или группы статей только на определенные компании или пользователей, чтобы другие клиенты или поисковики не видели/не индексировали эти статьи.
Решение
Для решения задачи можно использовать публичный портал Swarmica с механизмом сегментации доступа к статьям.
При публикации статей есть три опции для видимости:
Все — статья доступна всем анонимным пользователям, индексируется поисковиками и т. д.
Пользователи — статья доступна только зарегистрированным пользователям, которые зашли в личный кабинет Swarmica.
Сегменты — кастомный сегмент пользователей, который можно создать по определённым критериям.
Можно создать сегмент пользователей в Настройки> Сегменты пользователей по нужным критериям и публиковать статьи, доступные только для этого сегмента. Это позволит контролировать ведение базы знаний и разграничивать доступ к статьям.
Иногда нужно связать две (или больше заявок) в обе стороны?
Представим ситуацию, что заказчик заводит заявку 789 и говорит, мол, мы параллельно работаем с вами в 123 и 456. Агент смотрит и видит, что две остальные заявки ведут другие инженеры, он хочет уведомить коллег.
Решение
Введите ключевое слово для поиска в KCS виджет поиска в правой части экрана тикета
Перейдите на вкладку Заявки
Найдите нужный комментарий из интересующей заявки и нажмите Добавить в заявку
Происходит неконтролируемая смена Ответственного в тикете. В аудите событий видно, что автоматика принудительно переписывает ответственного за заявку уже после того, как кто-то был назначен.
Решение
Для решения проблемы необходимо проверить настройки автоназначения у ответственного за заявку в Настройки>Настройки пользователей>пользователь. Если автоназначение выключено, то балансер заявок может перераспределить заявку на другого сотрудника.
Есть два варианта избегать этого:
Блокировать заявку на себе, используя значок замочка рядом с именем ответственного
Включить автоназначение в настройках пользователя (но тогда ему будут назначаться также и новые тикеты по правилам автоназначения)
Причина
Проблема возникла из-за того, что у ответственного за заявку было выключено автоназначение. Балансер заявок проверяет, висит ли заявка на человеке с выключенным автоназначением и не заблокирована ли она на ответственном. Если эти условия выполняются, то заявка перераспределяется. Это сделано для того, чтобы другие агенты могли продолжить работу над заявками, если ответственный за них сотрудник заболел или ушёл в отпуск.
При создании заявки от имени клиента, как создать заявку на несуществующего клиента?
Решение
При создании заявки вручную агентом по умолчанию в поле Заявка От подставляется имя агента. Однако он может нажать иконку , справа от своего имени, и написать имя пользователя или email пользователя от которого он хочет завести заявку.
Если такого пользователя не существует в системе, то его можно пригласить прям на этапе создания заявки. При этом, создаваемый пользователь, получит приглашение по email с ссылкой на задание/смену пароля, а заявка будет для него доступна в личном кабинете Swarmica.
Перестали уходить отбивки при смене статусе в Решение предоставлено.
Решение
В 5.7 было изменено поведение отбивки, когда заявка уходит в статус Решение предоставлено. Как работает теперь:
Когда сотрудник поддержки руками меняет статус Решение предоставлено, отбивка НЕ будет уходить.
Сделано это для того, чтобы уменьшить количество писем клиентам.
Если заявка автоматически переходит из статуса Ожидает ответа клиента в Решение предоставлено из-за неактивности клиента, отбивка уйдет.
Так же, при переводе заявки в решенную, рекомендуется сообщаться об этом клиенту в ответе.
Заявка - это обращение от клиента, поступившее в службу поддержки по любому из внешних каналов, включая в себя и личный кабинет вашего клиента. Список всех заявок можно увидеть в разделе "Заявки" в левом меню:
Ниже представлены фильтры и колонки по умолчанию. Вы можете изменить работу фильтров, создать и настроить новые фильтры, а также добавить или удалить колонки из запросов в разделе Настройки - Управление фильтрами.
Над списком заявок расположено название используемого фильтра заявок с возможностью его переключения. Нажмите на название фильтра, чтобы увидеть все доступные фильтры или сменить фильтр:
Выбранный фильтр сохраняется у пользователя при следующем посещении раздела "Заявки".
Добавить или отредактировать общедоступный для всех агентов фильтр можно в разделе Настройки - Управление фильтрами, на вкладке "Заявки".
Можно создавать персональные фильтры и управлять ими, эта функция описана в отдельной статье.
Справа от каждого фильтра расположена опция добавления фильтра в закладки. Она полезна, если вы активно используете несколько разных фильтров.
Закладки с фильтрами выглядят так:
Справа от каждого фильтра в закладке можно увидеть количество заявок, находящееся в нём.
Чтобы удалить фильтр из закладок, раскройте список фильтров и нажмите на кнопку удаления из закладок справа от фильтра:
Рядом с фильтром находится окно поиска по ключевым словам и сочетаниям в диалогах с клиентами. При работе поиска учитываются только точные словосочетания и словоформы.
В правом верхнем углу списка заявок находится кнопка создания новой заявки. С её помощью можно инициировать переписку с каким-либо клиентом.
Содержание списка заявок
Список заявок содержит следующие столбцы.
#Номер заявки - присваивается системой автоматически.
Приоритет - задаётся клиентом из личного кабинета при отправке заявки, либо сотрудником со страницы заявки. Скриншот из личного кабинета клиента:
Клиент - имя клиента, которое он указал при регистрации в личном кабинете, либо взятое из мессенджера.
Ответственный - агент, указанный ответственным на странице заявки.
Обновлена - дата последнего изменения заявки, будь то отправленный или полученный ответ, изменение статуса и т.п.
Создана - дата создания заявки.
Часовой пояс - автоматически определяемый часовой пояс клиента.
В большинстве столбцов есть возможность сортировки иконкой рядом с названием столбца:
Можно сделать сортировку сразу по нескольким столбцам. Для этого нажмите на кнопку сортировки в первом интересующем вас столбце, затем нажмите Ctrl (на Windows) или Command (на MacOS) и, не отпуская, нажмите на кнопку сортировки на другом столбце. Первая сортировка останется основной, а внутри неё одинаковые показатели будут рассортированы второй сортировкой.
В футере страницы расположено общее количество найденных при помощи фильтра заявок (1), настройка количества отображаемых элементов (заявок) на странице (2) и пагинация (3).
Для перехода на страницу заявки нажмите на её заголовок или номер
Массовые действия с заявками
В списке заявок есть функция массовых действий: можно отправить всем ответ, назначить ответственного, изменить свойства, продукт или дополнительные атрибуты.
Чтобы активировать массовые действия, нажмите в правом верхнем углу списка заявок.
Теперь нужно выбрать заявки для редактирования. Нажмите "Выбрать все" для выбора всех заявок в списке (1), включите самый верхний флажок для выбора всех заявок на странице (2) или укажите отдельные заявки (3):
Когда нужные заявки будут выбраны, нажмите в правом верхнем углу списка.
Для отмены массового действия нажмите .
После нажатия на "Редактировать" открывается страница для внесения массовых изменений:
Под заголовком страницы указано количество выбранных заявок:
Ниже расположен блок массового ответа/внутреннего комментария. Чтобы добавить всем ответ или внутренний комментарий, активируйте бегунок "Добавить комментарий".
Для внесения остальных изменений в блоках справа нажмите на карандаш справа от нужного параметра:
После завершения редактирования нажмите справа вверху.
Для отмены заданных изменений нажмите .
Экспорт списка заявок
В правом нижнем углу страницы находятся кнопки экспорта: вы можете выгрузить список файлом в одном из форматов на выбор: Excel, CSV или JSON:
После выбора формата вы увидите всплывающее окно:
Здесь будет возможность скачать последний сформированный файл, если он не старше 7 дней, либо сформировать новый файл. Существующий файл начнёт скачиваться моментально. Для формирования нового файла может потребоваться некоторое время, возможно, до нескольких десятков минут, если объём списка очень большой. Но в это время вы можете переключаться между разделами Swarmica.
Примените нужный вам фильтр до того, как начнёте скачивать базу! Для выгрузки объёмного контента (несколько десятков тысяч строк и более) лучше применить CSV или JSON. CSV - облегчённый вариант Excel, с ним можно работать так же, как с Excel.
После того, как файл будет сформирован, ссылка для скачивания будет направлена вам на почту, а в системе в правом верхнем углу того раздела, в котором вы находитесь, всплывёт такое уведомление:
Скачивание файла начнётся по нажатию "Скачать сейчас". Либо, если вы закрыли уведомление, но не скачали файл, вы можете перейти обратно в список заявок, нажать на кнопку выгрузки и на ссылку для скачивания последнего созданного файла, при условии, если вы не переключали фильтр, по которому сформировался файл.
docker exec -it --env-file .env swarmica-cron-1 bash
for MAIL in `ls uploads/*.eml`; do python manage.py parse_incoming_email support@domain.tld -f $MAIL; done
По умолчанию, таймаут соединения для туннелирования вебсокетов рассчитывается HAProxy динамически и это значение недостаточно, для стабильной работы вебсокетов
В некоторых службах поддержки существуют сценарии, когда требуется взаимодействие со смежными подразделениями. При этом смежные подразделения могут работать, как в Swarmica, так и быть каким-то внешним контрагентом.
В общем случае процесс выглядит так:
В службу поддержки в Swarmica приходит оригинальный тикет от клиента.
Агент поддержки для формирования ответа клиенту связывается с внешним контрагентом или смежным подразделением.
После получения от них ответа он уже отвечает клиенту в оригинальном тикете.
Создание исходящей заявки
Для того, чтобы создать исходящую заявку, нужно нажать на иконку
После этого откроется окно создания исходящего тикета, в который автоматически предзаполнятся все поля из оригинального тикета, которые вы можете изменить при желании.
Далее вам нужно выбрать Получателя в колонке справа-сверху:
Для внутреннего сотрудника смежного подразделения
Просто начните вбивать его имя или емайл, и выберите из меню
Для внешнего контрагента
Вбейте емайл внешнего получателя и нажмите Пригласить пользователя. В раскрывшемся окне вы можете дополнительно включить галку Робот, если вы уверены, что на принимающей стороне стоит автоматическая система с автоответами. Флаг Робот в таком случае отключит служебные оповещения для избежания "битвы роботов".
Если же емайл внешнего контрагента принадлежит человеку или группе людей, то включать флаг Робот не нужно.
Далее нажмите Послать приглашение и внешний контрагент будет добавлен в Swarmica. При этом ему также уйдет приглашение о регистрации и сбросе пароля, и он помимо емайл также сможет заходить в Swarmica с клиентскими правами и отвечать на свои тикеты.
После этого редактируете текст, который вы хотите написать смежнику/контрагенту и нажимаете Создать.
Трекинг и взаимодействие
После создания исходящего тикета возле его темы появляется ссылка на родительский оригинальный тикет.
В оригинальном родительском тикете появится виджет в правой колонке, в котором будут указаны все связанные исходящие тикеты:
При этом поведение будет схожим с поведением связанных задач таск-трекера. А именно:
Исходящий тикет написан контрагенту и поставлен в статус "Ожидает ответа"
Родительский тикет можно поставить в статус "Ожидание" на какое-то предполагаемое время ответа в исходящем тикета.
Далее, родительский тикет перейдет в статус "Открытая" либо когда истечет это время, либо когда контрагент ответит в исходящий тикет и он также поменяет свой статус.
При этом в ленте оригинального тикета можно видеть все комментарии из связанных исходящих тикетов в хронологическом порядке для корректного восприятия переписки.
Комментарии из исходящих тикетов имеют другой вид обрамления, ссылку на исходящий тикет, а также отсутствие контролов для стандартных комментариев, чтобы минимизировать вероятность ошибки агента при работе с ними.
Флаг Исходящие заявки над комментариями позволяет включать/выключать видимость комментариев из исходящих тикетов.
Клиент хочет, чтобы при отправке почтовых уведомлений из тикета, в сообщении отображались все предыдущие сообщения переписки в виде квотирования.
Решение
Все сообщения от системы уходят одним комментарием, но почтовые клиенты обычно группируют их в треды, которые уже можно листать и просматривать. Рекомендуется настраивать работу именно в таком режиме.
Описанный ниже сценарий может применяться только с полным пониманием, что он никогда не будет полностью имитировать работу почтовых клиентов или серверов, а лишь шаблонизировать сообщения от тикетной системы похожим образом!
Ниже вы найдёте шаблон уведомления, который нужно установить вот тут: Настройки -> Настройки почтовых шаблонов -> вкладка "Уведомления о заявках" -> Нужный шаблон . В этом конкретном примере выбираем Любой ответ добавлен в мою заявку ,** чтобы письма с квотированием получали клиенты.
Это шаблон шаблон HTML, шаблон Plain текста трогать не нужно. Рекомендуется на всякий случай где-нибудь сохранить старый шаблон, на случай, если потребуется откатить всё назад.
Обратите внимание, что уведомления с полной перепиской заявки начнут получать все сотрудники, у которых включено уведомление "Публичный ответ добавлен"
{% extends"notifications/base_email.html" %}
{% block header %}
{% if comment.is_staff %}
<p>Получен ответ от сотрудника поддержки. {{ comment.author.name }} пишет:</p>
{% else %}
<p>Клиент {% if comment.author.name %}{{ comment.author.name }}{% else %}{{ comment.author.email }}{% endif %} пишет:</p>
{% endif %}
{% endblock %}
{% block body %}
{{ body_html|safe }}
{% if attachments %}
<hr/>
<p>Вложенные файлы:</p><ul>
{% for attachment in attachments %}
<li><ahref="{{ attachment.path }}">{{ attachment.name }}</a></li>
{% endfor %}
</ul>
{% endif %}
{% if comment.sensitive_data %}
<hr/>
<p><b>Ответ содержит конфиденциальные данные, которые можно посмотреть, перейдя по <ahref="{{ instance.base_url }}/tickets/{{ ticket.id }}#comment-{{ comment.id }}">ссылке</a></b></p>
{% endif %}
{% if ticket.comments.filter(public=True,author__is_system=False).exclude(id=comment.id).count() > 0 %}
<blockquote><p>Предыдущая переписка в заявке:</p>
{% set quote_count = 0 %}
{% for quoted_comment in ticket.comments.filter(public=True, author__is_system=False).exclude(id=comment.id).order_by("-created_at") %}
<blockquote><p>{{ quoted_comment.created_at.strftime("%Y-%m-%d %H:%M:%S") }} {% if quoted_comment.is_staff %}сотрудник поддержки {{ quoted_comment.author.name }} пишет:</p>{% else %}клиент {% if quoted_comment.author.name %}{{ quoted_comment.author.name }}{% else %}{{ quoted_comment.author.email }}{% endif %} пишет:</p>{% endif %}
{{ quoted_comment.body|safe }}
{% set quote_count = quote_count + 1 %}
{% endfor %}
{% for i inrange(quote_count) %}
</blockquote>
{% endfor %}
</blockquote>
{% endif %}
{% endblock %}
{% block footer %}
<p>Вы получили это уведомление, потому что являетесь участником в заявке:</p>
<p><ahref="{{ instance.base_url }}/tickets/{{ ticket.id }}">#{{ ticket.id }}: {{ ticket.subject }}</a></p><p></p><p>Чтобы отключить получение этой рассылки, пройдите в <ahref="{{ instance.base_url }}/profile">личный кабинет</a> и настройте почтовые уведомления.</p>
{% endblock %}
Причина
Здесь важно отметить, что Свормика не является полным замещением почтового сервера и/или клиента by design.
Входящие почтовые сообщения мы специально санитизируем, выкусывая лишнее квотирование, чтобы не засорять ленту тикета. Для исходящих сообщений можно настраивать шаблоны уведомлений убирая/добавляя дополнительные блоки.
Как сортируются статьи в выдаче поиска в виджете внутри тикета? Можно ли кастомизировать и фильтровать эту выдачу, например, выбирая только "Черновик, Проверенная, Опубликованная и т.д".?
Решение
Статьи выдаются по релевантности которая определяется полнотекстовым SQL поиском.
С точки зрения методологии KCS нет разницы в статусе статьи. Есть разница только в релевантности решения описываемой проблемы. Т.е. если "наверху" выдается к примеру "Черновик" , то имеет смысл использовать и модифицировать его , даже если может быть есть похожая Опубликованная - это как раз индикатор того, что черновик более релевантен конкретному контексту, и возможно в будущем он "победит" старую публикацию по количеству связанных с ним заявок.
Если же проблема в том, что поиск засорен множеством дубликатов, то нужно применять процесс проверки Точности Связанности для предотвращения их появления.
В Swarmica вы можете создавать и использовать шаблоны заявок. Это может быть полезно для разных типов заявок и разных ситуаций, например, для баг-репортов, запросов на доработки и т.п.
Шаблон может применяться при создании заявки по умолчанию автоматически либо вручную. Для этого нужно сначала добавить шаблон в настройки.
Создание и редактирование шаблонов
Для создания или редактирования шаблона перейдите в Настройки - Шаблоны заявок.
Для редактирования шаблона нажмите на его название.
Для удаления ненужного шаблона нажмите значок корзины справа от него.
Для создания шаблона нажмите в правом верхнем углу страницы
Ниже прилагаем заполненный пример шаблона и описание функционала его создания.
Название - отображается в пользовательском меню выбора шаблона.
Описание - содержимое шаблона, которое будет подставляться в поле "Описание" при создании заявки.
В описание можно поместить плейсхолдеры: текст, по обе стороны которого установлены символы %%%, будет запрещать сохранение и отправку заявки. Заявку можно будет отправить только после того, как %%%плейсхолдеры%%% будут удалены.
Роли пользователей, которым будет доступен шаблон.
По умолчанию - активируйте бегунок, чтобы каждая новая заявка пользователей указанной роли автоматически создавалась по этому шаблону.
Готовые шаблоны содержатся в таблице в разделе Настройки - Управление шаблонами. В этой таблице можно посмотреть и проверить настройки всех шаблонов: наличие галочки "По умолчанию", а также роли, которым доступен каждый шаблон. Кнопкой справа от шаблона можно удалить ненужный шаблон.
Применение шаблонов
Шаблоны применяются на странице создания заявки клиентом или сотрудником, у которых эти шаблоны доступны. Доступ к шаблонам определяется для роли сотрудника или для клиента на этапе создания или редактирования шаблона (см. предыдущий раздел статьи).
Если для роли включен шаблон по умолчанию, новая заявка будет им уже заполнена. Для выбора шаблона нужно воспользоваться списком над полем "Описание":
Если в шаблоне содержатся плейсхолдеры %%%, необходимо заменить их текстом или удалить, чтобы кнопка "Создать" стала активной.
Swarmica позволяет управлять Активами, такими как оборудование, ключи VPN и т.д, а так же добавлять связи заявок с Активами. В данной статье описывается настройка системы, для работы с Активами, а так же повседневные операции с ними.
Активы распределяются по типам (категориям). Например, типом актива может быть "Ноутбук", а активом - Ноутбук с серийным номером 12345.
Ещё примеры типов активов: Кластер, учетная запись, контракт.
Сами активы: кластер RU-NSK-8, учетная запись корпоративный аккаунт в vk.com, контракт на поддержку №2025-06/123, каждый из которых будет относиться к тому или иному типу актива.
Для работы с активами необходимо внести все типы активов, а затем сами активы, распределяя их по типам.
Настройка типов активов
Для того, чтобы различать Активы по их типу (допустим, "Ноутбук", "Учетная запись", "Кластер", "Точка доступа", "Контракт"), необходимо настроить типы активов в Настройках:
Зайдите в Настройки > Управление типами активов
Нажмите для создания нового типа актива.
Введите название типа актива и его описание.
Для редактирования названия существующего типа актива и его описания нажмите на название типа актива.
Настройка типов активов доступна только для учетной записи с ролью Администратор
Управление активами
Добавлять, удалять и редактировать активы можно в разделе Клиенты > Активы.
Управлять активами могут пользователи с ролями Агент, Менеджер или Администратор
Для создания нового актива нажмите и заполните поля в открывшемся окне: название, описание и тип актива. О работе с типами активов мы рассказали в предыдущем абзаце.
Работа с активами в заявках
Для того, чтобы ассоциировать актив с заявкой, нажмите кнопку Добавить в панели Активы на странице заявки:
При добавлении можно использовать поиск и фильтрацию активов:
Так же, если необходимо, можно указать влияние заявки на данный актив:
Пример: Заявка "Сломался маршрутизатор для кластера RU-NSK-8", добавляем активы "Маршрутизатор RTR-1234" с влиянием "Критическое", "Кластер RU-NSK-8" с влиянием "Высокое" и "Зона доступности Сибирь" и влияние "Низкое"
При выполнении каких либо действий в Swarmica появляется ошибка
"message":"Request failed with status code 502","response":{"data":"<html><head><title>Error 502</title></head><body><h1>Error 502: EOF while reading response</h1><p></p></body></html>","status":502,"statusText":"Bad Gateway","headers":{"content-length":"116","content-type":"text/html; charset=utf-8"},
или
"message":"Request failed with status code 502","response":{"data":"Bad Gateway","status":502,"statusText":"","headers":{"content-length":"11",
Решение
Проверить/отключить firewall/vpn и т.д. Попробовать коннект из другой локации.
Попробовать выставить более длинные таймауты на балансере
Причина
Эта ошибка идет не от Swarmica (т.к. в backend приложении даже нет такого кода ошибки), а от прокси-сервера, NAT, WAF шлюза , VPN и т.п. где-то между пользователем и сервером Swarmica.
Также может быть связана с внешним балансером и короткими таймаутами на нем.
Я копирую текст из терминала и вставляю его в редактор ответа в Swarmica. Затем, пытаюсь его разбить на абзацы: ставлю курсор в начало строки, нажимаю Enter, курсор моргает и ничего не происходит. Нажимаю Enter второй раз и тогда получается перенос строки.
При этом, если этот текст сначала скопировать в текстовый редактор, а потом оттуда в Swarmica - все работает корректно, перенос строки появляется после первого нажатия Enter.
Решение
Используйте вставку текста без сохранения форматирования, с помощью клавиш Ctrl+Shift+V
Причина
Эмулятор терминала помещает текст в буфер обмена в виде единого параграфа, разделенного "мягкими" переносами строк (soft breaks). При первом нажатии Enter текст разделяется на два параграфа, разделенных "жестким" переносом строк, визуально оставаясь таким же, а уже при втором нажатии добавляется еще один пустой параграф, формируя визуальный отступ.
Как и многие другие визуальные редакторы, Swarmica поддерживает два режима вставки:
Ctrl+V – с сохранением форматирования
Ctrl+Shift+V - режим "только текст", в котором содержимое буфера обмена приводится к простому тексту с жесткими переносами строк
В редакторе ответа в заявке форматирование "Цитата" или "Блок кода" применяется ко всему тексту, а не к его части
Решение
Разделите текст на смысловые блоки, которые должны иметь разное оформление (код, цитата, обычный текст), отделив параграфы обычным переносом строк (нажатием Enter). Каждый из таких блоков будет применять форматирование только в своих границах:
Если необходимо применить единое форматирование к блоку текста, тем не менее, сохраняя переносы строк внутри него, то стоит пользоваться Shift+Enter для формирования таких текстов:
Причина
Формат текста "Цитата" и "Блок кода" работают на уровне отдельного параграфа (абзаца), а не его фрагмента. То есть, при выборе формата "Цитата" весь параграф будет оформлен как цитата.
Если же визуально текст разделен на параграфы, но, тем не менее, форматирование применяется ко всему тексту, даже если выделить только один параграф, то это означает, что в тексте пристутствуют т.н. "мягкие переносы" или soft breaks - переносы строк внутри одного абзаца без разделения его на отдельные параграфы в верстке HTML. Такие soft breaks устанавливаются внутри отдельного блока при нажатии Shift+Enter.
В поиске одна заявка отображается более одного раза.
Решение
Так сделано by design.
Причина
Поиск индексирует тикеты по комментариям заявок. То есть, если есть N комментариев, которые соответствуют поиску, то он покажется N раз, для каждого комментария со своим сниппетом. Ссылка также ведет на конкретный комментарий.
Раздел Чаты предназначен для быстрой обработки заявок в формате чатов. Сюда попадают обращения пользователей, требующие более высокой скорости обработки и ответа, чем в разделе Заявки.
В раздел Чаты можно перейти из бокового меню:
Список чатов
В левой части экрана находится список чатов:
Статус - показывает статус в чате, в котором находится ваш пользователь. Подробнее.
Статус можно изменить выбрав нужный из списка:
Фильтры - список всех доступных фильтров, а так же возможность создать свой личный. Подробнее.
Поиск - быстрый поиск по чатам.
Превью чата. Показывает номер чата, тему и начало последнего комментария.
Дата последнего обновления в чате.
Статус чата. Аналогичны статусам заявок. Подробнее.
Статусы пользователя
Онлайн - на сотрудника будут назначаться чаты через автоназначение. Выставляется вручную.
В чате - ставится при первом ответе агента в любой из чатов переводить его статус. Выставляется автоматически.
Оффлайн - постоянный статус, при котором на агента не назначаются чаты. Чтобы изменить статус на Онлайн, его нужно выставить вручную.
Завершение чата - временный статус на 10 минут, который ставится системой автоматически после завершения чата. Это сделано для того, чтобы агент мог заполнить тикет, написать клиенту, создать статью и тд.
Через 10 минут статус автоматически изменится на Онлайн, чтобы агент мог продолжить работу в чатах.
В работе и Перерыв — на сотрудника не назначаются новые заявки через автоназначение и не снимаются балансировщиком в случае переоткрытия. Разница между этими статусами заключается только в названии, которое помогает менеджеру понять, чем занимается сотрудник:
Статус Перерыв означает, что сотрудник отошёл, например, на обед или за кофе.
Статус В работе — что сотрудник занят какой-то задачей и не может сейчас брать новые заявки.
Сотрудники
Под списком чатов расположе на вкладка Сотрудники:
На ней можно быстро понять, кто из сотрудников находится в определенном статусе, статус можно выбрать в меню (1), а в строке поиска (2) быстро найти нужного коллегу, начав вводить его имя. Если сотрудников много, выберите следующую страницу списка (3).
Список сотрудников обновляется каждую минуту, если нужно обновить прямо сейчас, воспользуйтесь кнопкой слева от выбора статуса.
Переписка в чате
По нажатию на чат в списке можно перейти на страницу чата и начать/продолжить переписку.
В левой части страницы с чатом будет список чатов в соответствии с выбранным фильтром. Посередине - непосредственно блок с перепиской. Справа блок с атрибутами чата, соответствующий атрибутам на странице заявки: поиск, KCS статьи, участники, активы, навыки, продукт, учёт времени и кастомные поля.
В нижней части блока с перепиской находится блок ответа с элементами форматирования текста, если клиент переписывается из своего личного кабинета. Расшифровка кнопок форматирования видна при наведении курсора на каждую кнопку:
Отправленный ответ можно отредактировать или удалить, соответствующие кнопки видны при наведении курсора на ответ:
Можно ответить на определённое сообщение с цитатой, воспользовавшись кнопкой "Ответить на сообщение":
Для вставки шаблона нажмите кнопку Т - откроется окно выбора шаблонов:
Добавить и отредактировать шаблон можно в разделе Шаблоны в боковом меню. Подробнее о работе с шаблонами.
Чтобы добавить внутренний комментарий, перейдите на вкладку Комментарий под окном ответа. Внутренние комментарии не видны адресату, их видят только сотрудники. Для призыва в заявку определённого сотрудника воспользуйтесь значком @ и выберите сотрудника или группу.
Оффлайн - постоянный статус, при котором на агента не назначаются чаты. Чтобы изменить статус на Онлайн, его нужно выставить вручную.
Завершение чата - временный статус на 10 минут, который ставится системой автоматически после завершения чата. Это сделано для того, чтобы агент мог заполнить тикет, написать клиенту, создать статью и тд.
Через 10 минут статус автоматически изменится на Онлайн, чтобы агент мог продолжить работу в чатах.
Для подключения опции обратитесь в службу поддержки Swarmica.
На странице заявки можно подключить опцию, которая поможет вам вести учёт чистого времени работы над заявкой.
Общий принцип работы с трудозатратами таков. В начале работы с заявкой ответственный указывает оценку затрачиваемого времени. Затем все, кто участвует в работе над заявкой, добавляют поэтапно свои трудозатраты. В блоке "Трудозатраты" видна оценка (прогноз) и общее количество потраченного времени.
Оценка - предполагаемое количество дней, часов и минут, которые по прогнозу будут затрачены на работу с заявкой.
Трудозатраты - реальное потраченное время.
Чтобы добавить или изменить оценку затрачиваемого времени, нажмите на карандаш в правой части строки "Оценка". Оценка добавляется в формате ДД ЧЧ:ММ.
Чтобы сохранить изменения, нажмите . Чтобы отменить изменения, нажмите .
Чтобы добавить этап (часть работы над заявкой), нажмите на значок с часами в правом верхнем углу блока. Откроется окно добавления трудозатраты:
Трудозатраты добавляются в формате ДД ЧЧ:ММ.
В поле "Дата" указывается дата начала работы.
Комментарий - описание самой работы.
Описание этапов (комментарии) доступно по нажатию на значок справа от трудозатрат. Открывается окно журнала трудозатрат:
Журнал трудозатрат представлен в виде таблицы со следующими столбцами:
Пользователь - сотрудник, работавший над обозначенным этапом.
Дата - дата начала работы над этапом.
Трудозатраты - количество потраченного работу времени.
Комментарий - суть выполненной работы.
Удалить - кнопка удаления этапа работы, если он добавлен по ошибке.
Запрос обратной связи направляется клиенту сразу после перевода заявки в статус "Решение предоставлено". Шаблон запроса можно настраивать в разделе Настройки - Настройки почтовых шаблонов - Запрос оценки CSAT.
Запрос содержит ссылку на инструмент оценки. Клиент переходит по ссылке и видит следующее:
Выбирает вариант оценки, опционально пишет комментарий и нажимает
Если выбран вариант "Безразлично", "Плохо" или "Ужасно", система дополнительно предложит выбрать факторы оценки.
Виджет на сайте предлагает выбрать количество звёзд для оценки внутри самого виджета:
Если установлено 3 звезды или менее, клиенту будет предложено написать причину негативного отзыва.
После отправки отзыва клиент видит страницу успешной отправки. Она выглядит по-разному в зависимости от поставленной оценки:
Виджет на сайте предложит начать новый чат:
Рассмотрим, как выглядит запрос обратной связи в некоторых каналах на стороне клиента.
Личный кабинет Swarmica
После того, как заявка переходит в статус "Решение предоставлено", клиент видит в правом верхнем углу своего личного кабинета такое уведомление:
После перехода в заявку ссылка видна в её верхней части:
Виджет на сайте
После того, как заявка переходит в статус "Решение предоставлено", клиент видит внизу диалога текст и возможность поставить от одной до пяти звёзд:
Email
Спустя сутки после момента перевода заявки в статус "Решение предоставлено" клиент получает письмо с запросом обратной связи и ссылкой на инструмент оценки. Шаблон запроса можно настраивать в разделе Настройки - Настройки почтовых шаблонов - Запрос оценки CSAT. В письме это может выглядеть примерно так:
Обратная связь на странице заявки
Сотрудник, работающий с заявками, видит информацию об обратной связи на странице заявки в блоке "Отзывы". Если запрос на обратную связь отправлен, но обратная связь от клиента не поступила, в блоке указывается время отправки запроса:
Если обратная связь поступила, в блоке добавляется время поступления отзыва и сам отзыв:
По нажатию на оценку можно увидеть её подробности и комментарий, если он есть:
Аналитика CSAT
В разделе "Аналитика" администратор и менеджер могут посмотреть общую статистику по CSAT, а агент - свою статистику:
Вертикальная ось показывает процент, а горизонтальная - временную шкалу, настраиваемую в настройках аналитики. Временная шкала опирается на дату получения отзыва.
Зелёные столбцы показывают процент CSAT в каждом отрезке отчётного периода. Синяя линия показывает базовый уровень CSAT. Голубая линия показывает цель по CSAT, настроенную в разделе Настройки - Целевые значения метрик, параметр "Удовлетворенность клиентов".
Тикет создался в сентябре, и его в конце сентября порезолвили (допустим, 27 сентября), выслался сурвей клиенту.
Пока сурвей не заполнен, хоть тикет лежит в SOLVED, тикет НЕ считается в CSAT (на нем еще нет оценки), но считается в сурвей рейт.
Допустим, всего за сентябрь предложено 10 сурвеев, из которых один - это наш этот тикет. => Этот тикет будет отвечать за 10% сурвей рейта. Если остальные 9 сурвеев заполнены ( 4 - bad, 5 - good), то SR за сентябрь будет 90%
Итак: метрики за сентябрь на данный момент такие:
Survey Rate: 90%
CSAT: 5 / 9 = 55.5%
Октябрь
В начале октября клиент вернулся из отпуска и заполнил сурвей, дав оценку BAD. Теперь у нас тикет капает в CSAT сентября (по дате resolved_at) как BAD и капает в сурвей рейт сентября +10% по дате created_at сурвея.
Метрики за сентябрь стали такие:
Survey Rate: 100%
CSAT: 5 / 10 = 50%
Метрики за октябрь не меняются.
Тикет реопают. После чего у него убирается дата resolved_at. Тикет убирается из CSAT за сентябрь, но продолжает капать в SR за сентябрь, т.к. прошлый сурвей есть и он заполнен.
Метрики за октябрь пока не меняются, за сентябрь они стали:
Survey Rate: 100%
CSAT: 5 / 9 = 55.5%
Тикет снова резолвят в середине октября - дата resolved_at = 14 октября. У тикета создается новый сурвей, отправляется клиенту. Тикет начинает капать в CSAT за октябрь своей прошлой оценкой BAD, продолжает капать в сентябрь SR за прошлый сурвей +10% и начинает капать в октябрь новым сурвеем (допустим, всего было 20 сурвеев за октябрь и теперь наш сурвей весит 5%). Если все остальные сурвеи заполнены (опять пусть будет 9 BAD, 10 GOOD), то SR за октябрь будет 95%.
Метрики за октябрь:
Survey Rate: 95% --- это с учетом высланного сурвея
CSAT: 10 / 20 = 50% --- сюда капает прошлая оценка из сентября
Клиент снова реопает тикет, дата resolved_at убирается, тикет не капает в CSAT, но капает в SR за сентябрь и октябрь как описано выше. Клиент НЕ заполняет еще сурвей:
Метрики за октябрь:
Survey Rate: 95% --- это с учетом высланного сурвея #2
CSAT: 10 / 19 = 52.6% -- а это уже без тикета
Ноябрь
В ноябре тикет опять солвят, пусть resolved_at = 7 ноября. Предыдущий сурвей, который был незаполненным, удаляется, создается новый и посылается клиенту. Допустим, в ноябре есть еще 9 порезолвленных тикетов, в которых все сурвеи заполнены (4 bad, 5 good) Теперь картина такая:
Какие сроки автоматического изменения статуса заявок и уведомления пользователей?
Решение
Как только заявка перейдет в статус Ожидает ответа клиента, она будет обработана по следующему алгоритму:
Первое уведомление клиенту будет отправлено через 5 дней, что Служба Поддержки ждет от него ответ.
Если ответа не будет, второе уведомление отправится еще через 5 дней (10 дней с выставления статуса).
Если клиент не отвечает, тикет будет переведен в статyc Решение предоставлено автоматически через 4 дня (14 дней с момента выставления статуса Ожидает ответа клиента).
Затем, если тикет не будет открыт повторно, он будет окончательно закрыт через 7 дней с даты решения, и переведен в статус Закрыта.
Время перехода статусов зависит от параметров в /root/swarmica/.env
Начиная с версии 6.0 можно конфигурировать параметры уведомлений и автозакрытия с точностью до секунд. Для этого в том же файле вместо дней можно прописать следующее (эквивалентно параметрам в днях выше):
Далее нужно зарегистрироваться или напомнить пароль, если аккаунт уже существует.
После входа клиенту доступно два раздела:
Заявки - для управления своими или заявками своей компании при наличии соответствующей роли.
Статьи базы знаний.
Заведение новой заявки
Перейдите в раздел Заявки и нажмите Создать новую:
Заполните все требуемые поля.
Напишите Тему обращения. При этом по полю Тема обращения будет автоматически произведен поиск возможных решений в Базе Знаний и все найденные решения будут предложены в правой колонке. Вы можете открыть, почитать и применить подходящее решение:
Если будет нажата кнопка Решение помогло, то процесс заведения тикета будет прерван, предполагая, что решение проблемы найдено
Если среди предложенных решений, ни одно не удовлетворило, то просто продолжите описание проблемы.
После заполнения Описания, появится Нейропоиск, чтобы найти ответ по Базе Знаний с помощью ИИ Ассистента:
Приложите нужные файлы (если требуется) и нажмите Создать.
Список тикетов или статей нужно отсортировать по нескольким столбцам. Как это сделать?
Ответ
Нажмите на кнопку сортировки в первом интересующем вас столбце, затем нажмите Ctrl (на Windows) или Command (на MacOS) и, не отпуская, нажмите на кнопку сортировки на другом столбце. Первая сортировка останется основной, а внутри неё одинаковые показатели будут рассортированы второй сортировкой.