Инструкция

ВАЖНО! Перед обновлением на v6.2.x необходимо иметь версию Swarmica не ниже v6.0.x.

Если у вас установлена версия ниже v6.0.x, сначала обновитесь до v6.0.x вручную, последовательно выполняя инструкции для каждой промежуточной версии: например, если у вас v5.10.x, то сначала нужно обновиться до v5.11.x, затем до v5.12.x и до v6.0.x.

Обновление

Начиная с v6.0.x обновление выполняется с помощью механизма автообновления.

Если вы ещё не перешли на автообновление, выполните шаги из раздела «Переход на автообновление» в инструкции по установке обновлений.

ВНИМАНИЕ! Это обновление требует ручных действий на сервере и может требовать отката действий.

Рекомендуется планировать около 1 часа прерывания сервиса для выполнения обновления.

Порядок выполнения обновления:

  1. Непосредственно перед началом работ сделайте снапшот виртуальной машины, где установлена Swarmica или полную резервную копию для быстрого отката в случае любых проблем с обновлением
  2. Обязательный шаг: обновите Postgres до версии 18 по инструкции
  3. Рекомендуется так же отключить JIT-оптимизацию Postgres по инструкции - этот шаг можно пропустить или сделать позднее. Выполнение шага дает прирост производительности БД и более оптимизированное потребление ресурсов.
  4. Рекомендуется настроить логирование сервисов Swarmica в journald по инструкции - этот шаг можно пропустить или сделать позднее. Выполнение шага дает возможность более гибкого управления логами контейнеров Swarmica, сохранение их после перезагрузки и ротацию, согласно вашим потребностям.
  5. После успешного выполнения предыдущих шагов убедитесь, что Swarmica полностью запустилась и работает.
  6. Запустите автообновление и следуйте инструкциям:
cd /root/swarmica
make upgrade

После успешной установки обновления запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

✉️ Почта

Переработана работа с автоматическими письмами: Swarmica лучше распознаёт отбивки и автоответы, сама помечает свои уведомления как автоматические и не теряет входящие письма при ошибках обработки. Это защищает от «войны роботов» между почтовыми системами и при этом не скрывает от агентов важные уведомления о недоставке.

  • 📬 Обработка отбивок о недоставке (bounce): если в почтовом канале выключен новый переключатель «Пропускать отбивки» (по умолчанию включён), отбивка определяется по исходному письму и добавляется в нужную заявку внутренним комментарием с исходным сообщением во вложении. Если отбивка пришла на уведомление о создании заявки или о новом комментарии, заявка в статусах «Ожидает ответа», «Отложена» или «Решена» переоткрывается; отбивки на служебные уведомления (например, рассылки администраторам) заявку не переоткрывают. Адрес почтового сервера не добавляется в копию заявки, учётная запись для него не создаётся, автоответ не отправляется
  • 🧩 Почтовые заголовки в уведомлениях: в шаблонах почтовых уведомлений можно задавать собственные заголовки (служебные заголовки вроде From, Subject, Message-ID или Return-Path изменить нельзя, при ошибке показывается понятное сообщение). Стандартные уведомления получили заголовки Auto-Submitted, чтобы почтовые системы клиентов не отвечали на них автоответами; при восстановлении настроек уведомления по умолчанию восстанавливаются и заголовки
  • 🆔 Исходящие уведомления по заявкам получают уникальный Message-ID, привязанный к заявке и получателю, а уведомление об отклонённом письме содержит ссылку на исходное сообщение (In-Reply-To) — так ответы и отбивки надёжнее связываются с заявкой
  • 🤖 Точнее определяются автоответы по заголовку Auto-Submitted
  • 🛟 Входящее письмо не помечается прочитанным в ящике, пока не будет успешно обработано, — при сбое разбора оно не теряется
  • 🎛️ Обновлена форма настроек почтового канала и настройки SMTP
  • 🔕 Уведомления о собственных комментариях агента (публичных и внутренних) теперь по умолчанию выключены
  • 🧹 Письма, сохранённые из-за ошибок обработки, автоматически удаляются через 30 дней (срок настраивается, см. «Новые переменные окружения»)

📚 База знаний и хелпцентр

  • 📊 Диаграммы Mermaid в статьях: в редакторе появилась кнопка вставки диаграммы с переключением «Код / Превью», а при просмотре статьи в интерфейсе и в публичном хелпцентре диаграммы отображаются графически, в том числе в полноэкранном режиме для больших схем. Диаграммы хранятся как обычный блок кода mermaid, поэтому там, где Markdown не отображается (например, в письмах), они показываются как текст. Читать подробнее.
  • 🔎 В списке статей можно искать статьи по номеру привязанной задачи из баг-трекера — так же, как в списке заявок
  • 🌐 Страницы хелпцентра получили корректные канонические ссылки (link rel="canonical"), что улучшает индексацию поисковыми системами

💬 Чаты и чат-виджет

  • ⏱️ Счётчики SLA и OLA теперь отображаются и в заголовке чата — агенты видят сроки, не переходя в заявку
  • #️⃣ Номер заявки в чат-виджете: клиент видит номер чата в списке чатов и в открытом чате. Включается настройкой виджет-канала show_ticket_id или параметром инициализации виджета (параметр имеет приоритет), по умолчанию выключено
  • ✈️ Тема заявки из Telegram формируется из имени клиента (или названия группы для групповых чатов) и имени бота вместо обрезанного первого сообщения — заявки проще различать в списке
  • 🔐 Чат-виджет поддерживает вход с двухфакторной аутентификацией

⚙️ Автоназначение

  • 👥 Новый переключатель в правиле автоназначения «Искать внутри текущей группы заявки»: ребалансер подбирает агента только из группы заявки и не меняет её группу. Теперь не нужно заводить отдельное правило на каждую группу
  • ⚖️ При равной загрузке заявка достаётся агенту, который дольше всех не получал назначений, — нагрузка распределяется равномернее
  • 🔒 Защита от параллельных запусков ребалансера

Читать подробнее про алгоритм работы автоназначения

🔍 RCA

  • 🏷️ У заявки появился признак «Есть RCA», который можно использовать в фильтрах, триггерах, отчётах и условиях автоназначения. Для существующих заявок признак заполняется автоматически при обновлении

🖥️ Улучшения UI/UX

  • 🧽 Кнопка «Очистить черновик» в форме создания заявки
  • 🎨 Ответы из внешних и внутренних дочерних заявок получили разные CSS-классы, так что их можно оформить по-разному через тему бренда
  • 👤 При поиске пользователей для полей «Заявка от», «Копия» и «Скрытая копия» показываются их идентити, а совпадения подсвечиваются
  • 📅 В аналитике по умолчанию выбран прошлый месяц с группировкой по дням
  • ↩️ Кнопка сброса выбора в фильтрах скоркарт
  • ⌛ Для выгрузок фильтров, отчётов и расхода токенов показывается дата, до которой файл доступен для скачивания
  • 🔑 После подтверждения регистрации пользователь входит в систему автоматически, а при выходе сессия завершается и на сервере (в интерфейсе и в виджете)
  • 🛡️ Отключение собственной двухфакторной аутентификации требует подтверждения кодом

⚙️ Производительность и обслуживание

  • 🐘 Шаблоны установки переведены на PostgreSQL 18, для PostgreSQL отключена JIT-компиляция, которая замедляла типичные запросы Swarmica
  • 📜 В новых установках логи контейнеров пишутся в systemd-journald с ротацией (до 2 ГБ, не дольше двух недель)
  • 🚀 Ускорена загрузка списка заявок: меньше повторяющихся запросов и быстрее подсчёт для постраничного вывода
  • 🗑️ Экспорты заявок (HTML/PDF) теперь автоматически удаляются через 30 дней (срок настраивается)

🐞 Исправления

  • 🔁 Исправлено объединение заявок: корректно пересчитываются поля целевой заявки (включая дату последнего ответа) и счётчики связей статей, объединение заявок с общей задачей больше не падает, при смене целевой заявки в массовом объединении можно вернуться назад
  • 📨 Получатель письма из поля «Кому» сохраняется в копии заявки, если адрес канала был в копии; удалённый почтовый канал по умолчанию больше не используется для новых заявок и исходящих писем; исправлены ошибки разбора отдельных писем и проверки IMAP-подключения
  • ✈️ Исправлены потеря первого сообщения нового пользователя в групповом Telegram-боте и дублирование сообщений с картинками
  • ⭐ Запрос оценки CSAT снова отправляется в WhatsApp, в том числе для решённых чатов и заявок из любого виджета
  • 📈 Первый комментарий агента при создании заявки больше не считается ответом в статусе, SLA и OLA
  • 🤖 ИИ-эвалуаторы оставляют комментарии на языке интерфейса и не комментируют критерии с оценкой «Да»
  • 🧩 Исправлены ошибки в Jinja-шаблонах при использовании фильтрации внутри блоков и циклов
  • ⚙️ Удаление навыка, используемого в правиле автоназначения, больше не приводит к ошибке и не оставляет в правиле пустое условие по навыкам
  • 📝 Шаблоном заявки по умолчанию для одного набора ролей теперь может быть только один шаблон
  • 🪪 Улучшены проверка и форматирование идентити пользователей (email, Telegram, VK, WhatsApp)
  • 🖥️ Исправлены пагинация во вкладке «Клиенты», слишком узкое поле лицензионного ключа в форме создания заявки, выбор канала при создании заявки, увеличение картинок в статьях, оператор «равно» в фильтре чатов, лишняя кнопка «Удалить» при создании WhatsApp-канала, пропадание виджета при обновлении страницы и показ лицензионного соглашения в виджете после отправки кода регистрации
  • ✉️ Уменьшены отступы в письмах в брендировании по умолчанию
  • 🔐 Исправлены уязвимости и повышена безопасность системы

Новые переменные окружения

В версии 6.2.0 появились новые параметры в файле .env. Задавать их не обязательно: если переменная не указана, используется значение по умолчанию.

ПеременнаяПо умолчаниюОписание
EMAIL_STORE_FAILED_EMAILS_MAX_AGE_DAYS30Через сколько дней удаляются письма, сохранённые из-за ошибок обработки. 0 — хранить бессрочно
TICKET_EXPORTS_MAX_AGE_DAYS30Срок хранения экспортов заявок (HTML/PDF) в днях
RUNTIME_SCRIPT_RUN_THROTTLE_RATE10/minЛимит ручных запусков скрипта на пользователя, формат <число>/<s|min|hour|day>. 0 — без ограничений
EMAIL_AUTH_ADDRESS_THROTTLE_RATE3/hourЛимит писем регистрации и смены пароля на один адрес. 0 — без ограничений
EMAIL_AUTH_CODE_COOLDOWN60Секунды после отправки кода, в течение которых повторный запрос не отправляет новое письмо. 0 — без паузы
EMAIL_AUTH_TOKEN_MAX_FAILED_ATTEMPTS3Количество неверных вводов кода (регистрация, сброс пароля, подтверждение идентити), после которого код аннулируется. 0 — без ограничений
EMAIL_AUTH_CONFIRM_THROTTLE_RATE5/minЛимит попыток подтверждения кода регистрации и смены пароля с одного адреса клиента. 0 — без ограничений
EMAIL_AUTH_CONFIRM_FAILURES_THROTTLE_RATE20/hourОбщий лимит неверных кодов при подтверждении регистрации и смены пароля для всех клиентов. 0 — без ограничений
IDENTITY_VERIFICATION_CONFIRM_THROTTLE_RATE5/minЛимит попыток подтверждения идентити для пользователя. 0 — без ограничений
AI_ASSISTANT_EXTERNAL_THROTTLE_RATE10/minЛимит запросов к ИИ-подсказке решения на одного клиентского пользователя. Внутренние роли не ограничиваются. 0 — без ограничений
AI_ASSISTANT_EXTERNAL_TOTAL_THROTTLE_RATE100/minОбщий лимит запросов к ИИ-подсказке решения для всех клиентских пользователей. 0 — без ограничений
REBALANCER_LOCK_TIMEOUT1800Сколько секунд держится блокировка от параллельных запусков ребалансера. Не устанавливайте 0
Обновлена: 31 окт. 2026 г.

Инструкция

ВАЖНО! Перед обновлением на v5.9.x необходимо иметь версию Swarmica не ниже v5.8.x

Обновления важно выполнять последовательно: если версия Swarmica ниже v5.5.x, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, и так далее.

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.9.2
SW_BACKEND_VERSION=v5.9.2
SW_HELPCENTER_VERSION=v5.9.2

Если планируется использование двухфакторной аутентификации, то необходимо добавить новый фича-флаг 2fa

Так же, на этом же шаге можно подключить оптимизацию портала базы знаний для LLM.

Обновление

Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду переименования поля chat_status в status:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_chat_status_to_status

3. Запустите команду переноса статуса автоназначения в поле status:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_autoassign_to_status

4. Если вы используете YandexGPT, то в этом релизе необходимо его перенастроить:

4.1. Переключите модель с YandexGPT-Lite на YandexGPT

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_yandex_gpt_model

4.2. Сбросьте состояние YandexGPT до "чистого":

docker exec --env-file .env -it swarmica-django-1 python manage.py wipe_yandex_cloud

После того, как завершатся все пост-апгрейдные шаги, будет необходимо перейти в графический интерфейс > Настройки > Интеграции > Провайдеры ИИ и заново включить ИИ-ассистентов

5. Запустите подсчет коэффициента несоблюдения SLA, который используется для упорядочивания тикетов при автоназначении:

docker exec --env-file .env -it swarmica-django-1 python manage.py recalculate_sla

6. Запустите команду установки порядка избранных списков тикетов "по умолчанию":

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_user_filter_subscriptions

7. Запустите очистку неиспользуемых данных:

docker system prune -a

ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды

✨ Основные улучшения

🔐 Безопасность и доступы

• Возможность использования 2FA через TOTP и Email
• Черный список скомпроментированных JWT токенов
• Маскирование паролей, токенов и других чувствительных данных в API
• Защищенная форма ввода паролей, токенов и других чувствительных данных

🧠 Работа со статьями

• Возможность перевода всей статьи целиком (ИИ)
• Возможность создания 30+ вкладок (табов) в статью
• Авто-якоря заголовков
• События изменения статусов и сегментов статей
• Расширенные настройки SEO для статей
• Оптимизация базы знаний для LLM

📬 Автоматизация и шаблоны

• Поддержка Jinja в email-автоматизациях (to / cc / bcc)
• Поддержка Jinja переменных в тикетах
• Добавлен Индекс SLA, как интегральный показатель соблюдения/несоблюдения всех счетчиков, сконфигурированных в политиках, применяемых к тикетам

📊 Отчеты и фильтры

• Добавлены новые объекты и измеряемые сущности
• Поддержка isnull для продуктов/компановки/версий/платформ
• Модификаторы Час и День недели для полей типа Дата и время в отчетах + возможность задавать часовой пояс для этих модификаторов
• Возможность сортировки в конструкторе отчётов
• Возможность поиск по отчётам в конструкторе отчетов
• Доступ к отчетам для роли Менеджер в конструкторе отчетов

💬 Мессенджеры и каналы

• Углублена интеграция с MAX
• Добавлены настройки, ссылки и поддержка в виджете


🔧 Исправленные ошибки

🎨 Исправлены проблемы с редактором: видео, форматирование текста, отмена, выпадающие меню и стили.
📊 Отображение в отчётах: локали, даты, SLA-счётчики и отображение данных.
🧾 Исправлены ошибки логики автоназначения и обработки событий.
💬 Улучшена стабильность мессенджеров и обработка комментариев.
⚙️ Повышена стабильность и производительность системы: кэш, API, миграции и фоновые процессы.

Обновлена: 29 окт. 2026 г.

Инструкция

ВАЖНО! Перед обновлением на v5.8.x необходимо иметь версию Swarmica не ниже v5.7.x

Обновления важно выполнять последовательно: если версия Swarmica ниже v5.5.x, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, и так далее.

Подготовка

1. Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.8.0
SW_BACKEND_VERSION=v5.8.0
SW_HELPCENTER_VERSION=v5.8.0

2. Ознакомьтесь со статьей про фича-флаги и убедитесь, что вы заменили старые значения на новые или добавили отсутствующие в /root/swarmica/.env в переменной FEATURES:

Старое значение (до 5.8.0)Новое значение (начиная с 5.8.0)Комментарий
article_comments__article_commentsСтал нелицензируемым
csat_anytime__csat_anytimeСтал нелицензируемым
sensitive_data__sensitive_dataСтал нелицензируемым
__external_ticketsexternal_ticketsСтал лицензируемым
__automationsautomations, automations_outgoing_emails,automations_outgoing_webhooks,automations_macros,automations_scriptsСтал лицензируемым + добавились отдельные флаги для каждого из видов автоматизаций
НЕ БЫЛОapi_keysТеперь возможность создавать апи токены проверяется лицензией. Добавьте этот флаг, если используются интеграции с использованием API токенов
НЕ БЫЛОissue_trackerТеперь возможность подключать трекеры задач проверяется лицензией. Добавьте этот флаг, если используются интеграции с трекерами задач
НЕ БЫЛОmaxПоявилась возможность интеграции с мессенджером MAX
webhooksНЕ НУЖНОТеперь при использовании интеграции с Mango Office или Beeline PBX не требуется отдельно прописывать флаг webhools. Его нужно удалить

3. Ознакомьтесь с инструкцией подключения мессенджера MAX, если вы планируете подключить эту интеграцию

Обновление

Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду, которая установит свойство locale для всех имеющихся тикетов в системе:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_ticket_locale

3. Запустите команду, чтобы установить порядок разделов базы знаний по умолчанию:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_articlecategory_order

4. Запустите команду, которая установит порядок продуктов на формах и в базе знаний по умолчанию:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_product_order

5. Запустите команду, которая сделает связь тикетов двусторонней:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_related_tickets

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

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_event_value_data

7. Запустите очистку неиспользуемых данных:

docker system prune -a

ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды

✨ Основные улучшения

💬 🅿️ Добавили возможность подключать мессенджер MAX как канал

💅 Добавили визуальный конструктор для макросов

👨‍🔧 Упростили создание сложных автоматизаций

🤌 Сделали клонирование правил автоназначения, чтобы экономить время на создании похожих правил

🪢 Сделали двустороннюю прозрачную связь заявок

🌎 Добавили возможность менять язык, на котором идет общение в заявке

🧩 Теперь можно задавать произвольный порядок для разделов базы знаний и продуктов

💆‍♀️ Добавили информации о запусках периодических задач и визуальный редактор условий

📊 Расширили и углубили возможности для создания произвольных отчетов

🔧 Исправленные ошибки

🎨 Исправлены проблемы с видео в статьях, копированием кода, таблицами, курсором и dropdown’ами.

📊 Починено отображение локалей, дат, кастомных полей в сводных отчетах. Улучшена производительность страницы отчётов.

🧾 Исправлены ошибки создания SLA, работы относительных дат в QA и массового редактирования. Корректно отображаются логические значения в событиях.

💬 Исправлена обработка CSAT в мессенджерах. Предотвращено создание пустых комментариев.

🧑‍💼 Исправлены ошибки с локалями и параллельным сохранением кастомных полей. Уточнены ограничения ролей.

⚙️ Улучшена работа кэша, логирования SLA и автоматизаций. Обновлены зависимости и закрыты потенциальные уязвимости.

🧩 Исправлено отображение CSAT, вложений и навигации в чатах.

Обновлена: 29 окт. 2026 г.

Данная инструкция применима для версий Swarmica 6.1.2 и выше.

Инструкция

0. Будет прерывание работы Свормика. Рекомендуется выполнять обновление в ненагруженные часы сервера.

1. Создайте резервную копию базы данных:

cd /root/swarmica

# Полный логический дамп всех баз и ролей внутри контейнера
docker exec -it --env-file .env swarmica-postgres sh -c 'pg_dumpall -U $POSTGRES_USER > /backups/full_backup_pg14.sql'

# Копируем дамп на хост
docker cp swarmica-postgres:/backups/full_backup_pg14.sql /root/swarmica/

Проверьте резервную копию:

ls -lh /root/swarmica/full_backup_pg14.sql
grep -c "CREATE DATABASE" /root/swarmica/full_backup_pg14.sql

Если вторая команда вернула ≥ 1 — дамп содержит базы данных, всё в порядке.

2. Остановите сервисы Swarmica:

cd /root/swarmica
docker compose down

3. Удалите старый том данных:

PostgreSQL 18 не сможет запуститься на томе, инициализированном версией 14, — контейнер упадёт с ошибкой о несовместимости. Поэтому том надо удалить и создать заново.

docker volume rm swarmica_swarmica_postgres_data

4. Создайте новый пустой том:

docker volume create swarmica_swarmica_postgres_data

5. Отредактируйте docker-compose.yml. Откройте файл в текстовом редакторе и измените image и volume в сервисе postgres как показано ниже:

<...>
postgres:
  image: postgres:18-bookworm                          # ← ИЗМЕНЕНО: было postgres:14.2-bullseye
  container_name: swarmica-postgres
  shm_size: 1gb
  command: postgres -N 200 -c work_mem=8MB -c temp_buffers=16MB -c shared_buffers=1GB -c track_activity_query_size=16384
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
    interval: 10s
    timeout: 5s
    retries: 5
    start_period: 10s
  restart: always
  volumes:
    - swarmica_postgres_data:/var/lib/postgresql:z     # ← ИЗМЕНЕНО: было /var/lib/postgresql/data
<...>

6. Запустите только PostgreSQL 18:

docker compose up -d postgres

Дождитесь статуса healthy:

docker compose ps
docker compose logs postgres | tail -20

В логах должно быть database system is ready to accept connections. Это значит, что initdb создал новый кластер PostgreSQL 18 в свежем томе.

7. Скопируйте резервную копию БД из шага 1 внутрь контейнера:

docker cp /root/swarmica/full_backup_pg14.sql swarmica-postgres:/tmp/full_backup_pg14.sql
docker exec -it swarmica-postgres ls -lh /tmp/full_backup_pg14.sql

8. Восстановите данные из резервной копии:

docker exec -it swarmica-postgres sh -c 'psql -U $POSTGRES_USER -d postgres < /tmp/full_backup_pg14.sql'

9. Запустите остальные сервисы Swarmica:

cd /root/swarmica
docker compose up -d

10. Выполните завершающие процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

11. Удалите временный дамп из контейнера:

docker exec -it swarmica-postgres rm /tmp/full_backup_pg14.sql

Дамп на хосте /root/swarmica/full_backup_pg14.sql оставьте на несколько дней как страховку. Удаляйте только после полной уверенности в стабильности.

Обновлена: 11 нояб. 2026 г.

Симптомы

Автоматическое обновление падает с ошибкой:

make upgrade:
..
FAIL  Services are not running and healthy:
  celerybeat: unhealthy
  celeryworker: unhealthy

Решение

  1. Для указанных контейнеров (в примере это celerybeat и celeryworker) настроить healthcheck как указано в статье.
  2. Рестартануть контейнеры:
    docker compose down && docker compose up -d
    
  3. Продолжить процесс обновления Свормики.

Причина

Неправильные настройки healthcheck в docker-compose.yml

Обновлена: 20 окт. 2026 г.

Инструкция

ВАЖНО! Перед обновлением на v6.1.x необходимо иметь версию Swarmica не ниже v6.0.x.

Если у вас установлена версия ниже v6.0.x, сначала обновитесь до v6.0.x вручную, последовательно выполняя инструкции для каждой промежуточной версии: например, если у вас v5.10.x, то сначала нужно обновиться до v5.11.x, затем до v5.12.x и до v6.0.x.

Обновление

Начиная с v6.0.x обновление выполняется с помощью механизма автообновления. Промежуточные версии можно не устанавливать: план обновления строится до последнего релиза автоматически.

Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально

Выполните в каталоге установки Swarmica:

cd /root/swarmica
make upgrade-plan    # показать план обновления, ничего не меняя
make upgrade         # выполнить обновление

Если вы ещё не перешли на автообновление, выполните шаги из раздела Переход на автообновление в инструкции по установке обновлений.

После успешной установки обновления, запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

🤖 ИИ-агенты

ИИ-агенты получили шесть новых компетенций: теперь они не только проверяют качество, но и разбирают апелляции по оценкам и берут на себя рутинную работу с базой знаний. Функции доступны при включённом фича-флаге __ai_mcp_agents.

  • ⚖️ Обработка апелляций по качеству сервиса (QA), качеству контента (AQI) и точности связанности (LAI) — ИИ-агент анализирует возражения оцениваемых сотрудников, при обоснованных доводах корректирует оценку, а в остальных случаях даёт развёрнутое объяснение и подводит итог рассмотрения в общем комментарии
  • ✍️ Редактор статей — приводит проверенные статьи к контент-стандарту и стилю компании: исправляет грамматику, стандартизирует оформление и публикует готовые статьи
  • 🔎 SEO/GEO/AEO-оптимизация статей — заполняет мета-теги и разметку JSON-LD опубликованных статей, чтобы поисковики и нейросети корректно ранжировали базу знаний
  • 🌐 Переводчик статей — переводит опубликованные статьи, у которых есть только одна локаль, с сохранением форматирования
  • 🎛️ Обновлённый диалог выбора компетенции при создании ИИ-агента и быстрый поиск по компетенциям
  • 🔄 Статус ИИ-агента и ход выполнения его задач обновляются в интерфейсе в реальном времени, а статусы запусков выделены цветом
  • 💰 Существенно снижен расход токенов при работе ИИ-агентов через YandexGPT — стоимость запусков стала сопоставимой с ChatGPT
  • 🧠 Улучшен промпт ИИ-агента по умолчанию: ответы опираются только на предоставленные материалы
  • 🇬🇧 Встроенные промпты и инструкции ИИ-функций на новых установках поставляются на английском языке, что снижает расход токенов; на уже работающих системах промпты не меняются

📚 Хелпцентр и SEO

  • 🏷️ Поля JSON-LD (разметка schema.org) и произвольный HTML для <head> во вкладке SEO статьи — данные автоматически выводятся на страницах хелпцентра и помогают статьям подниматься выше в поисковой выдаче и ответах нейросетей
  • 🤖 Страницы статей подсказывают LLM-ботам Markdown-версию статьи, а при включённом фича-флаге __llmstxt — ссылку на llms.txt
  • 📄 Файл /llms-full.txt с публичными статьями базы знаний для LLM; число статей в /llms.txt и /llms-full.txt задаётся переменной NEXT_PUBLIC_LLMSFULL_MAX_ARTICLE
  • ⚡ Ускорено открытие категорий базы знаний

💬 Чаты и чат-виджет

  • 🔑 Регистрация и сброс пароля в чат-виджете (для авторизации по email) с поддержкой политики паролей и лицензионного соглашения — пользователи, чьи аккаунты были созданы автоматически, теперь могут обратиться в поддержку через виджет. В письма о регистрации добавлен код для ручного ввода
  • 🔀 Кнопка «Ответ + статус» в чатах, как в заявках
  • 📝 Черновик сообщения сохраняется при переключении между чатами — удобно, когда агент ведёт несколько диалогов одновременно
  • 🖼️ Превью изображений и файлов при написании сообщения в виджете и поддержка изображений внутри сообщений чата
  • ⚡ Ускорена загрузка списка чатов и сообщений
  • 👥 Чаты автоматически назначаются и на агентов в статусе «В чате»: сначала на агентов «Онлайн», затем с учётом загрузки на остальных

🖥️ Улучшения UI/UX

  • 🔗 При создании заявки по ссылке с параметрами можно передать значение $null, чтобы очистить поле формы (например, копию CC) — это исключает подстановку данных из предыдущей заявки и отправку писем на неверные адреса при массовом создании заявок из личного кабинета
  • ⏸️ В быстром выборе срока отложенного статуса появились варианты на 15 и 30 минут
  • ⚠️ При смене продукта в массовом редактировании заявок показывается предупреждение о том, что зависимые поля будут сброшены
  • 💬 Счётчик общих комментариев к оценке качества — сразу видно, есть ли комментарии, без раскрытия блока
  • ⚠️ Понятные сообщения об ошибках при загрузке файлов в форме создания заявки и при превышении лимита запросов
  • 🔔 Предупреждение о новых изменениях в статье появляется сразу, без перезагрузки страницы
  • 📜 Кнопка «Показать ещё» в выпадающих списках с поиском (категории, группы, организации, пользователи, навыки, лицензии и др.)
  • 🧹 Из условий автоназначения убран «Статус пользователя» — статусы теперь напрямую управляют автоназначением
  • 🖼️ При загрузке фавикона, логотипа и спиннера доступны только поддерживаемые форматы файлов

⚙️ Производительность и обслуживание

  • 🔄 Автоматическое обновление командами make upgrade-plan и make upgrade
  • 🐧 Поддержка Ubuntu 26.04 LTS и AltLinux 11
  • 🩺 Улучшена проверка работоспособности сервисов Docker
  • 🏷️ Команда python manage.py show_version для просмотра текущей версии Swarmica

🐞 Исправления

  • 💬 Чаты: восстановлены автоматические статусы «В чате» и «Завершение чата», исправлены дублирование и пропадание сообщений, форк чата, пересылка ответов на сообщения с изображениями из Telegram, обновление статуса сотрудника и индикатора на аватаре, работа кнопки «Ответ + статус», закрытие чата и отправка опроса CSAT в виджете, самопроизвольная смена статуса агента из «Не в сети»
  • 🪟 Чат-виджет: исправлены сброс сессии при переходе между страницами личного кабинета, вставка скриншотов через Ctrl+V, стили и заголовки в списке чатов
  • 📧 Почта: исправлена обработка писем в нестандартных кодировках (в том числе ISO-2022-JP), обрезание части письма, цитирование переписки, обработка больших писем и писем с некорректной разметкой, тема уведомления с расшифровкой чата
  • 🎫 Заявки: исправлены сброс ответственного при создании, переходы статусов, работа дочерних заявок, очистка поля «Истечение SLA», отображение политик OLA и локаль подписи
  • ⚙️ Автоматизации: в контекст триггеров и периодических задач передаются переменные по умолчанию, исправлены условия с исключением значений в триггерах
  • 📚 База знаний: нейропоиск больше не предлагает исходную статью как дубликат, в KCS-виджете не пропадают блоки кода и скриншоты, исправлены увеличение изображений после смены локали, вставка изображений в таблицы и ошибка при отмене изменений в редакторе статьи, ошибки при обходе хелпцентра поисковыми роботами
  • 📈 Контроль качества: исправлены пустые карточки AQI/LAI на новых установках и мелкие ошибки интерфейса
  • ⚙️ Настройки: домен бренда в ссылках, удаление продуктов с версиями и редакциями, отключение максимальной длины пароля, создание администратора при нехватке мест в лицензии, выбор ролей сотрудников при истёкшей лицензии, отображение всех групп в настройках сотрудника, выгрузка поля «Каналы уведомлений», поле темы при создании макроса
  • 🤖 ИИ: загрузка файлов ИИ-агентами через MCP, создание ИИ-агентов у неподдерживаемых провайдеров, качество перевода ИИ-ассистентом
  • 🔐 Исправлены уязвимости и повышена безопасность системы

Новые переменные окружения

В версии 6.1.0 появились новые параметры в файле .env. Задавать их не обязательно: если переменная не указана, используется значение по умолчанию.

ПеременнаяПо умолчаниюОписание
UPLOAD_BASE64_MAX_SIZE_MB15Максимальный размер файла (МБ), загружаемого через API в формате base64. 0 — без ограничений.
REQUEST_BODY_MAX_SIZE_MB15Максимальный размер тела запроса к API (МБ) в формате JSON или form-urlencoded. На загрузку файлов через multipart не влияет. 0 — без ограничений.
UPLOAD_MULTIPART_MAX_SIZE_MB2048Максимальный размер файла (МБ), загружаемого через multipart/form-data. 0 — без ограничений.
COMMENT_ATTACHMENT_UPLOAD_THROTTLE_RATE20/minОграничение частоты загрузки вложений к комментариям для одного пользователя в формате <число>/<s|min|hour|day>. 0 — без ограничений.
CHAT_WRAPUP_MINUTES15Сколько минут агент находится в статусе «Завершение чата» после последнего активного чата, прежде чем вернуться в статус «В сети». 0 — агент сразу возвращается в статус «В сети».

Ограничения на размер и частоту загрузки не распространяются на вложения во входящих письмах.

В версии 6.1.1 добавлена переменная хелпцентра:

ПеременнаяПо умолчаниюОписание
NEXT_PUBLIC_LLMSFULL_MAX_ARTICLE500Число публичных статей с доступом «Все», которые попадают в /llms.txt и /llms-full.txt. Если задаёте больше 500, увеличьте и MAX_PAGINATION_LIMIT.

В версии 6.1.2 добавлена переменная:

ПеременнаяПо умолчаниюОписание
API_CACHE_HEALTHCHECK360Сколько секунд хранится результат проверки работоспособности каналов, который отдаётся по запросу /api/healthcheck/ всем, кроме администраторов.

Также в версии 6.1.2 исправлено имя переменной IMAP_SSL_CUSTOM_CIFERS — теперь она называется IMAP_SSL_CUSTOM_CIPHERS. Старое имя продолжает работать, но рекомендуем переименовать переменную в файле .env.

Обновлена: 6 окт. 2026 г.

Общая информация

Обновление системы может происходить по одному из трех сценариев:

  1. Автоматическое, можно пропустить промежуточные версии – такой сценарий возможен, когда нет изменений в файлах запуска (docker-compose.yml, .env и т.д.) и нет изменений схемы данных, которые удаляют какие-либо данные.
  2. Автоматическое, нельзя пропустить промежуточную версию - этот сценарий задействован, когда нет изменений в файлах запуска (docker-compose.yml, .env и т.д.), но есть изменения схемы данных, которые удаляют какие-либо данные. Промежуточное обновление необходимо для того, чтобы сохранить эти данные для дальнейшего использования. С точки зрения администратора системы, выполняющего обновление, никаких дополнительных действий делать не нужно, автоматика самостоятельно произведет все необходимые действия, но время обновления вырастет и будет производен дополнительный рестарт на промежуточной версии.
  3. Ручное - такой сценарий возможен, когда есть изменения в файлах запуска (docker-compose.yml, .env и т.д.) и требуется прочитать инструкцию по выполнению обновления и выполнить все указанные там действия.

Выполнение обновления

Обновление выполняется из каталога установки /root/swarmica:

make upgrade-plan    # показать план обновления, ничего не меняя
make upgrade         # выполнить обновление
  1. Переходим в директорию Свормики:
    cd /root/swarmica
    
  2. make upgrade-plan скачивает манифест обновлений и строит план до последнего релиза. Рекомендуется выполнять сначала эту команду, чтобы оценить длительность обновления и планируемое количество действий
  3. make upgrade скачивает манифест обновлений, строит план до последнего релиза и выполняет его по шагам.

Каждый шаг: проверки, скачивание образов, резервная копия БД, запись версий в .env, запуск контейнеров с ожиданием миграций, post_start. Всё, что может завершиться ошибкой, выполняется до изменения .env: при сбое на этом этапе ничего не меняется. Если шаг прервался после изменения .env, повторный make upgrade продолжит его с места остановки, а при сбое печатается точная инструкция по откату.

  • Для шагов, требующих ручной подготовки, обновление останавливается и показывает ссылку на инструкцию. После подготовки и выполнения всех шагов из инструкции: make upgrade ACK=vX.Y.Z.
  • Автоматическое обновление доступно только с релизной версии. Если в .env указаны main или devel, укажите фактический релиз: make set-release VERSION=vX.Y.Z, затем make pull up.
    Версию можно узнать в интерфейсе системы в разделе Настройки, если у вас есть затруднения – обратитесь в поддержку Swarmica.

Системные требования

  1. Версия Swarmica не ниже v6.0.0 – до нее необходимо обновиться вручную согласно инструкциям промежуточных версий
  2. Для обновления требуются Docker Compose не ниже 2.24.6, GNU make 4.x, jq 1.6 и новее, curl и flock.

Переход на автообновление

  1. Скачайте последнюю версию архива установщика на сервер со Swarmica:
    wget https://support.swarmica.com/attachments/installer/installer.tar.gz
    
  2. Распакуйте архив:
    tar -xvzf installer.tar.gz templates/Makefile
    
  3. Скопируйте Makefile в каталог, где установлена Swarmica:
    cp templates/Makefile /root/swarmica/
    
  4. Проверьте, что у вас есть переменная SW_RELEASE_VERSION в /root/swarmica/.env, и если ее нет - добавьте с указанием той версии, которая установлена на сервере (можно посмотреть в разделе Настройки)
Обновлена: 18 окт. 2026 г.

Инструкция

ВАЖНО! Перед обновлением на v6.0.x необходимо иметь версию Swarmica не ниже v5.12.x

Обновления важно выполнять последовательно: если версия Swarmica ниже v5.12.x, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, и так далее.

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v6.0.3
SW_BACKEND_VERSION=v6.0.3
SW_HELPCENTER_VERSION=v6.0.3

Обновление

Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

2. Запустите очистку неиспользуемых данных:

docker system prune -a

ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды

Новые фича-флаги

__ai_mcp_agents - включает возможность создания ИИ-агентов (см. возможности ИИ провайдеров)

rca - включает управление документами анализа первопричин (Root Cause Analysis, RCA)

ui_widgets - включает возможность встраивать в интерфейс Swarmica произвольные виджеты

child_tickets - включает возможность создавать связанные дочерние тикеты, по аналогии с external_tickets, но внутренние дочерние тикеты учитываются в статистике и предназначены для работы сотрудников компании, а не внешних получателей

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

🚀 Что нового в обновлении

🤖 ИИ-агенты

Появилась возможность создавать полноценных ИИ-агентов, которые могут использовать инструменты MCP для выполнения рутинных задач, забирая на себя монотонную работу с сотрудников. В этом обновлении представлены три компетенции ИИ-агентов:

  1. Проверяющий качества сервиса (QA evaluator)
  2. Проверяющий качества контента (AQI evaluator)
  3. Проверяющий точность связанности (LAI evaluator)

Эти функции доступны с ИИ-провайдерами YandexGPT и ChatGPT и подключаются фича-флагом __ai_mcp_agents

🔍 RCA

Добавилась возможность создавать документы с анализом первопричин инцидента (Root Cause Analysis, RCA), а так же делиться этими документами с клиентами через интерфейс системы или экспорт в форматах PDF и Markdown. Для большего удобства работы с RCA есть следующие функции:

  • 🤖 Генерация документа RCA с помощью ИИ
  • 📋 Шаблоны RCA
  • 🔒 Возможность добавлять внутреннюю информация, которая не будет видна для клиентов

Включается фича-флагом rca

🎨 Кастомизация интерфейса

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

  • 🧩 Собственные настройки основных экранов в заявке, статье, карточке пользователя, организации, лицензионного ключа и актива. Возможность задавать порядок боксов, порядок полей, скрывать поля, который применяется для всех пользователей по умолчанию.
  • 🧩 Добавление веб-плагинов через механизм кастомных виджетов (фича-флаг ui_widgets) позволит расширить возможности интерфейса Swarmica и подключить различные внешние системы и веб-виджеты для сотрудников и клиентов
  • ✉️ Возможность добавлять кастомизируемое сообщение в форме тикета, для того, чтобы проинформировать клиентов о различных важных нюансах: например, куда обращаться с запросами по приобритению продукта, как продлить лицензию и т.д. Сообщение гибко параметризуется за счет использования шаблонов Jinja.
  • 👁️ Возможность скрывать поле «Приоритет» на форме создания
  • 🖼️ Возможность задавать кастомную иконку для встраиваемого чат-виджета
  • 🎨 Поддержка стилизации встраиваемого чат-виджета через CSS темы бренда

⚙️ ITIL/ITSM

В релизе добавились механизмы, упрощающие внедрения практик ITIL/ITSM:

  • ⏱️ Механизм подсчета Операционного Соглашения (Operation-level Agreement, OLA):
    • 🔧 Механизм OLA и политики OLA для различных команд
    • 📊 Графики OLA и соблюдения политик OLA в аналитике
  • 📑 Возможность создавать различные Типы запросов по ITIL/ITSM (Запрос на обслуживание, Инцидент, Проблема и т.д.)
  • ✉️ Дочерние заявки (фича-флаг child_tickets) для того, чтобы создавать связанные с запросом клиента задачи во внутренние отделы компании и отслеживать их статус
  • 🗓️ Производственные календари и быстрое применение праздников к расписаниям для более гибкого и точного подсчета SLA и OLA

📈 Большие изменения в работе с оценкой качества LAI/AQI/QA

  • 🖥️ Новые более удобные экраны работы с оценкой, на которых отображается вся необходимая информация
  • 💬 Возможность добавлять общий комментарий к оценке
  • 🔗 Удобное управление связями «проверяющий — правило» (из правила назначать проверяющих и наоборот)
  • ⚡ Возможность сгенерировать оценки по правилу «прямо сейчас», указав нужных проверяющих и количество оценок
  • 👥 Возможность указывать количество оценок на проверяющего для каждого правила, создаваемых по расписанию
  • 🧮 Возможность назначать оценки, игнорируя загруженность проверяющего
  • ⚖️ Алгоритм перебалансировки, учитывающий загруженность проверяющего
  • 📊 Возможность создать оценки AQI для редактора и для автора
  • 🗑️ Возможность удалять созданные оценки при удалении соответствующего правила

🖥️ Улучшения UI/UX

  • 🔎 Поиск по полям в фильтрах
  • 📑 Сортировки и быстрый поиск по разделам в настройках
  • 🛠️ Визуальный конструктор форм к кастомным скриптам + новый тип поля «Выпадающий список»
  • 📋 Быстрый список заявок при выборе целевой заявки для объединения
  • 📝 Кнопка «копируемый блок» в редакторе статей
  • ⬇️ Индикатор скачивания большого вложенного файла
  • 🚫 Индикатор заблокированного пользователя
  • 🖼️ Предварительный просмотр изображений на форме создания тикета и коммента
  • 🔍 Фильтрация событий в заявке
  • ✍️ Удобное написание коммента (автофокус)
  • 💾 Сохранение данных в форме до успешного создания тикета

📚 Хелпцентр

  • 👍👎 Помогло/Не помогло на статье для неавторизованных пользователей
  • 📖 Содержание раздела
  • 🖼️ Оптимизация загруженных картинок на обложку продукта и раздела базы знаний, что улучшает скорость загрузки и положительно влияет на SEO

🔐 Безопасность

  • 🔑 Возможность задавать политику сложности паролей
  • 🚫 Возможность запретить использовать скомпроментированные и популярные пароли

⚙️ Улучшения производительности и обслуживания

  • 🔄 Механизм автоматического выполнения post-upgrade команд при обновлении
  • 🔌 Переход на единое соединение вебсокета вместо нескольких, автоматическое переподключение и keepalive проверки для более стабильного соединения и устойчивости при нестабильной скорости и качестве Интернет-соединения
  • 🛠️ Возможность настройки параметров celery для тонкой настройки производительности сервера
  • 📏 Лимит максимального количества объектов на одной странице API запроса LIST

🌐 Разное

  • 💬 Поддержка чатов в МАКС
  • 🆕 Новый тип каналов — Web / API и возможность отключать их
  • ⏲️ Настройка автоматических переходов и автоматических уведомлений с гранулярностью до секунд
  • 🔄 Возможность задать алгоритм действий с событиями из прошлого для триггерных автоматизаций
  • 👤 Управление аватарками сотрудников (для админов)
  • 🔌 Поддержка динамических переменных в адресе URL для исходящего вебхука
  • 🔍 Новые возможности в фильтрах:
    • 🔘 оператор isnull для разделов статей в фильтрах
    • 🔘 оператор НЕРАВНО для авторов статей в фильтрах
    • 🔘 оператор isnull для группы в фильтрах тикетов
Обновлена: 19 окт. 2026 г.

Инструкция

ВАЖНО! Перед обновлением на v5.12.x необходимо иметь версию Swarmica не ниже v5.11.x

Обновления важно выполнять последовательно: если версия Swarmica ниже необходимой, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, и так далее.

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.12.1
SW_BACKEND_VERSION=v5.12.1
SW_HELPCENTER_VERSION=v5.12.1

Обновление

Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

2. Запустите команду миграции модели пермиссий на кастомные поля:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_cf_permissions

3. Запустите очистку неиспользуемых данных:

docker system prune -a

ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды

Новые фича-флаги

__ai_ticket_summary - для ИИ-провайдеров, поддерживающих эту функцию, включает возможность резюмировать заявки

__delete_comment_attachments - разрешает сотрудникам поддержки с ролью Агент, Менеджер или Администратор удалять вложенные файлы в заявках

__private_attachments - включает режим дополнительной защиты вложенных файлов, запрещая их предварительный просмотр и доступ по прямой ссылке без авторизации. Дополнительно, можно регулировать степень размытия миниатюр изображений таких файлов с помощью переменной env PRIVATE_THUMBNAIL_BLUR_RADIUS (по умолчанию 12 пикселей, чтобы отключить - укажите 0)

Подробнее про добавление/удаление фича-флагов

✨ Основные улучшения

🧠 ИИ-функции:

  • Теперь можно в один клик получить полное Резюме всей переписки в заявке, а так же рекомендации по улучшению качества сервиса

🔐 Безопасность и приватность:

  • Расширили возможности по настройке доступа к Кастомным полям: теперь можно для каждой роли указывать возможность видеть и редактировать то или иное поле
  • Добавили режим повышенной защиты для вложенных файлов – теперь для них не существует прямой ссылки, (включается фича-флагом __private_attachments)
  • Добавили возможность "мягкого" и полного удаления вложенных файлов через веб-интерфейс

🎯 Фильтры и массовые действия:

  • Добавили возможность массового редактирования навыков в заявках
  • Добавили возможность задавать навыки через Макросы
  • Добавили возможность фильтрации заявок и пользователей без навыков (оператор ISNULL)

⚙️ Автоназначение и работа с заявками:

  • Добавили возможность отключать автоматическое назначение при создании заявки
  • Добавили отключаемое почтовое уведомление ответственному о том, что заявка перешла в статус Решение предоставлено
  • Для приложенных медиа файлов можно размывать миниатюры предварительного просмотра

🔌 Интеграции и экосистема:

  • Для исходящих вебхуков добавилась возможность настраивать параметры действий при ошибке: количество повторных попыток, время между попытками, HTTP статусы, на которые выполнять повторные попытки
  • Для исходящих вебхуков добавилась возможность передавать ключ идемпотентности в теле запроса или в заголовках
  • Добавили возможность проверять настройки авторизации в ИИ-провайдерах

📚 Работа со статьями и базой знаний:

  • Добавили возможность копировать часть статьи из KCS-виджета в буфер обмена или вставлять непосредственно в ответ клиенту с помощью перетаскивания
  • Для авторизованных сотрудников в базе знаний отображаются Архивные статьи, с пометкой об их возможной неактуальности
  • Добавили поддержку языков cmake и Makefile в блок кода редактора статей
  • Добавили настраиваемое почтовое уведомление при снятии флага на доработку статьи

🎨Общие улучшения:

  • Добавили возможность настраивать роли и состояние "по умолчанию" для почтовых уведомлений, а так же массово применять новые настройки ко всем пользователям системы
  • Добавили индикатор сворачивания/разворачивания панелей в заявке
  • Добавили возможность сбрасывать сортировку списков при повторном нажатии на название колонки
  • Добавили возможность выбора Категорий шаблонов в окошке быстрой вставки шаблона ответа
  • Добавили возможность клиентам самостоятельно переводить заявки в статус Решена из статуса Новая
  • Добавили динамический заголовок вкладки браузера для всех разделов системы

🔧Устранены проблемы:

  • Лишняя HTML/XML разметка в заявках, созданных через почту
  • Сбрасывается выбор отображения тела KCS статьи в заявке
Обновлена: 18 окт. 2026 г.

Инструкция

ВАЖНО! Перед обновлением на v5.11.x необходимо иметь версию Swarmica не ниже v5.10.x

Обновления важно выполнять последовательно: если версия Swarmica ниже v5.10.x, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, и так далее.

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.11.2
SW_BACKEND_VERSION=v5.11.2
SW_HELPCENTER_VERSION=v5.11.2

Удалите контейнер cron из раздела services docker-compose.yml и том swarmica_cron_d из раздела volumes и всех сервисов:

volumes:
  swarmica_postgres_data: {}
  swarmica_postgres_data_backups: {}
  swarmica_static: {}
  swarmica_logs: {}
  swarmica_ugc: {}
  swarmica_ai_assistant: {}
  swarmica_uploads: {}
  swarmica_runtime: {}
#  swarmica_cron_d: {} Эту строчку нужно удалить
  traefik_data: {}

services:
  django: &django
    ...
#      - swarmica_cron_d:/swarmica/swarmica/cron_d/:z Эту строчку нужно удалить

# Эту секцию целиком нужно удалить
#  cron:
#    <<: *django
#    restart: always
#    depends_on:
#      - postgres
#      - redis
#    command: /start-cron
#    volumes:
#      - ./.env:/etc/environment:ro
#      - swarmica_ai_assistant:/swarmica/swarmica/ai_assistant/articles/:z
#      - swarmica_cron_d:/etc/cron.d/:z
#      - swarmica_ugc:/swarmica/swarmica/attachments:z
#      - swarmica_runtime:/swarmica/swarmica/runtime_scripts/:z
#    labels:
#      - "traefik.enable=false"

Обновление

Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down --remove-orphans
docker compose up -d 

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

2. Запустите команду для сохранения порядка пунктов меню в кастомных полях Меню и Бейдж:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_choices_order

3. Запустите команду для создания периодических задач по сбору почты через IMAP:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_collect_imap_emails

4. Запустите команду для пересчета количества связанных со статьями заявок:

docker exec --env-file .env -it swarmica-django-1 python manage.py calculate_article_t_links_all

5. Если вы используете ИИ-провайдер Yandex, то выполните следующую команду:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_yandexgpt_url

6. Выполните команду создания шаблонных карточек для проверки AQI (контроль качества статей):

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_aqi_cards
docker exec --env-file .env -it swarmica-django-1 python manage.py restore_aqi_sample_rules

7. Выполните команду создания шаблонных карточек для проверки LAI (контроль точности связанности):

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_lai_cards
docker exec --env-file .env -it swarmica-django-1 python manage.py restore_lai_sample_rules

8. Запустите очистку неиспользуемых данных:

docker system prune -a

ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды

✨ Основные улучшения

🤖 AI

  • ⚡️⚡️⚡️ Добавлена поддержка собственной (локальной) LLM через OpenAI API
  • Добавлена поддержка новых AI-провайдеров:
    • ChatGPT
    • DeepSeek

📊 Отчёты и автоматизации

  • Добавлены новые модификаторы выбора временных интервалов событий.
  • Добавлен параметр group_rows для группировки строк в отчетах.
  • Добавлен механизм предохранителя при попытке построить слишком большой отчет.
  • Улучшена сортировка и отображение поисковых результатов.
  • Добавлены описания для правил автоназначения.

🧠 Контроль качества

  • Реализовано полноценное управление собственными правилами оценки Точности связанности и Индекса качества статей.
  • Переработаны разделы оценки Контроля Качества, Точности связанности и Индекса качества статей – добавлены фильтры, сортировки и поиск.

📩 Омниканальность

  • Добавлена поддержка работы Telegram через прокси сервер.
  • Улучшена надежность работы Email каналов при нестабильном сетевом соединении.

🎨 Интерфейс и UX

  • Добавлена поддержка массового обновления статей.
  • Добавлена возможность удаления локализации статьи.
  • Добавлена возможность drag-and-drop сортировки пунктов выбора в кастомных полях типа Меню или Бейдж.
  • Появилась возможность сворачивания длинных комментариев.

🔧 Исправленные ошибки

  • 🎨 Исправлены проблемы с отображением layout’ов, вложений и комментариев.
  • 🧾 Исправлены race condition при обновлении тикетов, SLA и fork операций.
  • 💬 Улучшена стабильность и расширено покрытие сценариев установщика Swarmica
  • ⚙️ Повышена стабильность фоновых задач, кеширования и AI Assistants.
  • 🧩 Исправлены проблемы с генерацией ревизий статей и обновлением вложений.

Обновлена: 17 окт. 2026 г.

Симптомы

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

Решение

  1. Проверить логи контейнера Swarmica с помощью команды docker logs swarmica-django-1.
  2. Если в логах содержится сообщение вида:
    RuntimeError: NumPy was built with baseline optimizations:
    (X86_V2) but your machine doesn't support:
    (X86_V2).
    
    это указывает на проблему с эмуляцией процессора в виртуальной машине.
  3. Выключить виртуальную машину.
  4. Переключить тип эмуляции процессора в режим host.
  5. Включить виртуальную машину обратно.

Причина

Проблема возникла из-за отсутствия необходимых флагов процессора (ssse3, sse4_1, sse4_2 и popcnt) в настройках эмуляции процессора виртуальной машины. После обновления Swarmica до версии 5.10.0 была обновлена версия Python до 3.13 и библиотека NumPy, которая использует указанные оптимизации.

Обновлена: 17 окт. 2026 г.

Симптомы

Нужна переустановка Свормики. Как удалить имеющуюся сейчас установку с сервера?

Решение

Самый простой способ - пересоздать виртуалку. Если так не хочется, то:

cd /root/swarmica
docker compose down -v

потом перейти в папку с инсталлером и

rm -rf .tmp
./installer.sh install
Обновлена: 17 окт. 2026 г.

Симптомы

Пользователь при попытке открыть Свормику в браузере сталкивается с ошибкой Your token is invalid или перманентной загрузкой страницы. При этом в других браузерах сайт открывается без проблем.

Решение

  1. В любом месте на странице нажать правой кнопкой мыши и выбрать «Посмотреть код» (Inspect).
  2. Выбрать вкладку «Приложение» (Application).
  3. В ней слева найти «Локальное хранилище» (Local Storage).
  4. Выбрать сайт (https://yourhelp.yourdomain.tld) — на нём нажать правой кнопкой мыши и выбрать пункт «Очистить» (Clear).
  5. Затем выполнить принудительное обновление страницы (форс-рефреш) и снова зайти на сайт.

Причина

Проблема возникла из-за закэшированного старого токена авторизации.

Обновлена: 18 окт. 2026 г.

Инструкция

ВАЖНО! Перед обновлением на v5.10.x необходимо иметь версию Swarmica не ниже v5.9.x

Обновления важно выполнять последовательно: если версия Swarmica ниже v5.5.x, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, и так далее.

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.10.0
SW_BACKEND_VERSION=v5.10.0
SW_HELPCENTER_VERSION=v5.10.0

ВАЖНО! Если Swarmica установлена внутри виртуальной машины Qemu, KVM, Proxmox, Hyper-V, проверьте, что режим эмуляции процессора установлен в host и внутри виртуальной машины доступны флаги ssse3, sse4_1, sse4_2, popcnt:

# grep -m1 'flags' /proc/cpuinfo
flags           : fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ss ht syscall nx pdpe1gb rdtscp lm constant_tsc arch_perfmon rep_good nopl xtopology cpuid tsc_known_freq pni pclmulqdq vmx ssse3 fma cx16 pdcm pcid sse4_1 sse4_2 x2apic movbe popcnt tsc_deadline_timer aes xsave avx f16c rdrand hypervisor lahf_lm abm 3dnowprefetch cpuid_fault invpcid_single ssbd ibrs ibpb stibp ibrs_enhanced tpr_shadow vnmi flexpriority ept vpid ept_ad fsgsbase tsc_adjust bmi1 avx2 smep bmi2 erms invpcid mpx avx512f avx512dq rdseed adx smap clflushopt clwb avx512cd avx512bw avx512vl xsaveopt xsavec xgetbv1 xsaves arat umip pku ospke avx512_vnni md_clear arch_capabilities

Обновление

Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите очистку неиспользуемых данных:

docker system prune -a

ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды

✨ Основные улучшения

🔐 Безопасность и интеграции

  • Версия python в backend ядре системы обновлена до 3.13
  • Администраторы теперь могут отключать 2FA у пользователей без подтверждения пароля.
  • Добавлена возможность использовать ключи идемпотентности в API запросах

🧠 AI и работа с ИИ

  • Добавлена возможность управлять промптами для ИИ-функций для кастомизации:
    • Ваш Tone of Voice
    • Создания черновиков статей в вашей структуре
    • Работа с переводами и редакцией текста для тикетов и статей
    • Промпты для Виртуального агента

📊 Отчёты и аналитика

  • Добавлены новые модификаторы для дат: неделя, месяц, квартал с учетом часового пояса.
  • Поддержка относительных дат
  • Добавлена возможность пересчёта агрегированных метрик через API и UI.
  • Возможность тонкой настройки Точности vs Скорости подсчета метрик в аналитике.

⚙️ Автоматизация и триггеры

  • Расширены возможности для действий по расписанию и событиям:
    • поддержка относительных дат в условиях для автоматизаций вида: "Отправить сообщение если нет ответа от агента последние 30 минут"
    • новые операторы (например, IEXCLUDES)
  • Автоматическая подстройка макросов под события в тикете event.ticket.id.

💬 Интерфейс и UX

  • Добавлены новые статусы агентов: Перерыв и В Работе.
  • Реализована возможность настройки кастомного лейаута экрана тикета: изменение порядка и минимизация блоков
  • Минималистичный (свернутый) интерфейс SLA-счетчиков в тикете
  • Поддержка открытия формы создания тикета с URL-параметром assignee=me
  • Добавлены hash-ссылки на события в тикете

🌐 Брендинг и настройки

  • В настройки бренда добавлена возможность конфигурации системы:
    • Протокол (https/http) доступа для конфигурации собственных обратных прокси
    • Имя домена (по которому доступна система)
    • Порт доступа

🔧 Исправленные ошибки

  • 📊 Исправлены расчёты SLA, прогресс-бары и обновление метрик в условиях race condition.
  • 💬 Исправлены ошибки отображения комментариев и шаблонов в определенных условиях/браузерах.
  • ⚙️ Повышена стабильность системы: кэш, фоновые задачи, обработка событий и API.
Обновлена: 17 окт. 2026 г.

Симптомы

После установки Свормки при попытке зайти в панель управления нон-стоп грузится спиннер заставки.

Решение

  1. Поправить DNS для указанного домена или же прописать у себя в /etc/hosts , чтобы сервер корректно резолвился по доменному имени в правильный IP адрес сервера
  2. Если сервер находится за NAT, то прописать локальный IP адрес сервера в его собственный /etc/hosts
  3. Перезапустить скрипт инсталлера

Причина

Указанный при установке домен не резолвится в корректный IP адрес или же попытка доступа напрямую по IP. Swarmica требуется доменное имя для корректной работы.
Проблема с доступом по https сервера к самому себе. Команда curl, которой мы проверяем готовность API, не может завершиться и инсталлер не может закончить установку.

Обновлена: 16 окт. 2026 г.

Симптомы

Установка Swarmica зависла на стадии скачивания образов (docker compose pull) на сервисах traefik, postgres и/или redis:

+] Pulling 72/97
 ✔️ celeryworker Skipped - Image is already being pulled by telegram                                                0.0s
 ✔️ celerybeat Skipped - Image is already being pulled by telegram                                                  0.0s
 ✔️ django Skipped - Image is already being pulled by telegram                                                      0.0s
 ✔️ telegram Pulled                                                                                               244.0s
 ✔️ frontend Pulled                                                                                               167.4s
 ⠧ postgres [⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀] Pulling                                                                             1055.8s
 ✔️ cron Skipped - Image is already being pulled by telegram                                                        0.0s
 ⠧ traefik [⠀⠀⠀⠀] Pulling                                                                                       1055.8s
 ⠧ redis [⣿⣿⣿⣿⠀⠀] Pulling                                                                                       1055.8s

Решение

Добавьте зеркало Docker Hub в конфигурацию Docker и перезагрузите сервис:

  1. Откройте файл /etc/docker/daemon.json любым удобным редактором
  2. Добавьте в секцию registry-mirrors зеркало Yandex:
{
  "registry-mirrors": ["https://cr.yandex/mirror","https://mirror.gcr.io"]
}
  1. Перезагрузите сервис docker
invoke-rc.d docker restart
  1. Запустите ./install.sh install - он продолжит установку с последнего успешного шага

Причина

Доступ к зеркалу Docker Hub от Google может быть замедлен, в зависимости от вашего провайдера интернета

Обновлена: 17 окт. 2026 г.

Симптомы

При развёртывании возникали ошибки, но всё же образ развернулся. Однако при входе на сайт выходит ошибка. При проверке через ./installer.sh check также появляется ошибка.

./installer.sh must be run from root user, exiting now

Решение

  1. Выполнить команду sudo для получения прав суперпользователя (root).
  2. Запустить установщик ещё раз.
Обновлена: 17 окт. 2026 г.

Симптомы

Не удается установить обновление Swarmica. На шаге docker compose pull ошибка:

Login did not succeed, error: Error response from daemon: Get "https://reg.gl.swd.im/v2/": unauthorized: HTTP Basic: Access denied. If a password was provided for Git authentication, the password was incorrect or you're required to use a token instead of a password

Решение

Обратитесь в поддержку Swarmica, чтобы получить новый токен доступа к репозиторию

Причина

Истек срок действия токена доступа к репозиторию Swarmica

Обновлена: 15 окт. 2026 г.

Быстрый старт

  1. Создайте новую виртуальную машину из образа Swarmica
  2. На вашей рабочей станции добавьте в /etc/hosts внешний IP этой виртуальной машины, указывающий на доменное имя vk-cloud.swarmica.com
  3. Зайдите через браузер, используя следующие данные:
https://vk-cloud.swarmica.com
admin@swarmica.local
VK-Cloud!Swarmica

Смена доменного имени

Чтобы заменить доменное имя с vk-cloud.swarmica.com на ваше собственное, необходимо выполнить команду внутри виртуальной машины:

sudo make -f /root/swarmica/Makefile change-hostname HOSTNAME=my.new.hostname.tld

Смена пароля администратора

  1. Зайдите в раздел Настройки > Управление сотрудниками
  2. Найдите учетную запись администратора по почте admin@swarmica.local
  3. Нажмите кнопку Задать пароль

Рекомендуется создать новую учетную запись в разделе Управление сотрудниками, а предустановленную учетную запись заблокировать.

Смена лицензии

  1. Зайдите в раздел Настройки > Лицензия Swarmica
  2. Загрузите новый лицензионный ключ

Для дальнейшей настройки обратитесь к пошаговому руководству:
Первоначальная настройка Swarmica

Обновлена: 15 окт. 2026 г.

Быстрый старт

  1. Создайте новую виртуальную машину из образа Swarmica
  2. На вашей рабочей станции добавьте в /etc/hosts внешний IP этой виртуальной машины, указывающий на доменное имя yandex-cloud.swarmica.com
  3. Зайдите через браузер, используя следующие данные:
https://yandex-cloud.swarmica.com
admin@swarmica.local
YCloud!Swarmica

Смена доменного имени

Чтобы заменить доменное имя с yandex-cloud.swarmica.com на ваше собственное, необходимо выполнить команду внутри виртуальной машины:

sudo make -f /root/swarmica/Makefile change-hostname HOSTNAME=my.new.hostname.tld

Смена пароля администратора

  1. Зайдите в раздел Настройки > Управление сотрудниками
  2. Найдите учетную запись администратора по почте admin@swarmica.local
  3. Нажмите кнопку Задать пароль

Рекомендуется создать новую учетную запись в разделе Управление сотрудниками, а предустановленную учетную запись заблокировать.

Смена лицензии

  1. Зайдите в раздел Настройки > Лицензия Swarmica
  2. Загрузите новый лицензионный ключ

Для дальнейшей настройки обратитесь к пошаговому руководству:
Первоначальная настройка Swarmica

Обновлена: 15 окт. 2026 г.

При помощи этой статьи вы сможете выполнить первоначальную конфигурацию Swarmica за несколько шагов: настроить ваш новый аккаунт, подключить каналы, сотрудников, отрегулировать распределение обращений и подключить трекер задач.

Шаг 1. Основные настройки

Настройте языки, валюту и конфигурацию Email.

Перейдите в раздел Настройки в боковом меню и выберите раздел Настройки Swarmica.

Выберите используемые в интерфейсе языки, задайте язык интерфейса по умолчанию, валюту для расчёта бюджета поддержки и включите Email конфигурацию SMTP.

Обязательно переключите email конфигурацию в SMTP, чтобы работала исходящая почта.

Подробнее о глобальных настройках можно прочитать здесь.

Если вы хотите добавить языки или валюту, обратитесь, пожалуйста, в службу поддержки Swarmica.

Шаг 2. Подключение исходящей почты

Подключите корпоративный почтовый ящик, с которого будут отправляться ответы по Email.

Перейдите в раздел Настройки и нажмите на блок SMTP relay.

Откроется страница с настройками. Ниже показываем пример заполненных настроек.

Сверху вниз внесите следующие данные:

  1. Адрес вашего почтового сервера.
  2. Порт для исходящей почты вашего сервера.
  3. Имя пользователя, через которого будет проходить исходящая почта.
  4. Пароль пользователя.
  5. Шифрование: нет, SSL или TLS.
  6. Активируйте переключатель Включен, если все настройки внесены, и сервер готов к работе.
  7. Нажмите Проверить настройки, чтобы убедиться, что всё корректно работает.

Шаг 3. Подключение входящей почты

После подключения в Swarmica попадут все письма в статусе "Не прочитано" в формате заявок, потребуют ненужной обработки, в них могут уйти автоответы, если они настроены. Если Email использовался для работы с клиентами в течение длительного времени, желательно подготовить его к подключению к Swarmica, сменив статус всех непрочитанных сообщений на "Прочитано".

1. Перейдите в Swarmica в раздел бокового меню Настройки, выберите Каналы, нажмите Email.

2. Справа вверху нажмите "Создать"

3. Откроется окно для заполнения основных данных:

Название - произвольное название вашего почтового канала.

Получатель - адрес email, на который вы получаете почту.

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

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

После заполнения основных данных нажмите "Сохранить"

4. Откроется страница настроек почты. Заполните её данными вашего почтового клиента и прочими настройками по образцу.

Следующие бегунки должны быть включены:

  • Использовать системный SMTP сервер (его настраивали на предыдущем этапе). Если ваши настройки отличаются от предыдущего этапа, и вы не используете системный SMTP сервер, то бегунок не включайте, а внесите эти настройки, см. подробности о них в отдельных статьях в следующем абзаце.
  • Разрешить создание заявок.
  • Включен.

Подробности настроек вы можете увидеть в отдельных статьях:

Шаг 4. Создание сотрудников

Чтобы создать сотрудника, нажмите "Создать" в правом верхнем углу раздела Настройки - Управление сотрудниками.

После нажатия на Создать откроется выбор:

Мы рекомендуем по стандартной процедуре пригласить пользователя. В этом случае сотруднику отправляется на почту специальное приглашение, он переходит по ссылке и сам вводит свои данные и пароль. Ссылка действительна 24 часа!

С выбором этого способа создания сотрудника открывается такое окно:

Нужно ввести email пользователя, выбрать его роль и нажать "Послать приглашение". После этого приглашение отправится пользователю.

Альтернативный вариант - создать карточку пользователя самостоятельно, выбрав по нажатию кнопки Создать вариант Создать пользователя. В этом случае вы самостоятельно задаёте его имя, логин и пароль.

Сотрудникам, которые будут работать с обращениями клиентов, задайте роль "Агент".

Подробнее об управлении сотрудниками вы можете прочитать здесь.

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

Дальнейшие шаги позволят вам расширить функционал вашей системы: добавьте telegram, разбейте пользователей на группы, настройте отображение заявок, установите автораспределение обращений!

Шаг 5. Подключение telegram-бота

О том, как создать telegram-бота, вы можете прочитать здесь.

Перейдите в Swarmica в раздел Настройки - Каналы и выберите Telegram. На открывшейся странице нажмите Создать вверху справа.

Введите название канала, на которое вам удобно будет ориентироваться при обработке заявок и нажмите "Сохранить"

Откроется страница настроек:

Прежде всего, сюда нужно ввести токен вашего бота. Его можно найти в сообщении, которое пришло вам в ответ на успешно добавленный никнейм бота в чате с BotFather.

Для быстрой обработки заявок из мессенджеров рекомендуем выбрать Создавать - Чаты.

Активируйте бегунок Включен, чтобы канал заработал, и сохраните настройки:

После сохранения настроек бота обратитесь в службу поддержки Swarmica для его активации!

Подробности подключения читайте здесь.

Шаг 6. Группы пользователей

Пользователей-сотрудников можно разбить по группам для дальнейшего распределения обращений и разграничения статистики.

  1. Перейдите в Настройки - Управление группами.
  2. В правом верхнем углу нажмите на кнопку Создать новую.
  3. Введите название группы. Например, "1 линия" или "Инженеры".
  4. Нажмите кнопку Сохранить.
    Откроется такое окно.
  5. В правом блоке нажмите Добавить сотрудника и начните вводить его имя, выберете из предложенного списка нужного пользователя для добавления. Присутствие пользователей в конкретной группе позволяет разграничить работу с тикетами в нужной группе, а также группировать статистику по выбранным группам.
  6. Остальные опции можно пока оставить нетронутыми.
  7. Нажмите Сохранить для сохранения изменений.

Подробнее об опциях группы можно прочитать здесь.

Шаг 7. Создание фильтров заявок

Настройте представление заявок глобально или по-разному для разных ролей сотрудников при помощи фильтров. Сотрудник сможет выбрать такой фильтр из добавленных вами, либо создать свой фильтр.

Фильтры в списке заявок выглядят так:

Чтобы добавить и настроить системные фильтры, нажмите Настройки в боковом меню, и затем Управление фильтрами.

Справа вверху нажмите "Создать фильтр" и выберите Заявки. Откроется окно настройки фильтра.

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

Поля - отображаемые колонки в списке заявок.

Условия - сами фильтры, которыми будут выбираться нужные для отображения заявки.

Сортировка - параметр, по которому будут сортироваться заявки.

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

Шаг 8. Автоназначение заявок

Теперь можно настроить автоматическое распределение заявок по группам и пользователям.

Для этого перейдите в раздел Настройки - Автоназначение заявок.

Здесь вы можете создать разные правила для назначения входящих заявок в разные группы. Правила создаются по принципу "Если (условие 1), то поместить в группу (группа) и назначить сотрудника, удовлетворяющего условию (условие 2). Создав несколько таких правил, можно настроить их порядок работы. Правила в списке правил работают сверху вниз. Если первое правило не определило подходящего для новой заявки сотрудника, система применяет для заявки следующее правило, и так до тех пор, пока условие в каком-либо правиле не будет соблюдено. Кроме того, вы можете настроить режим периодического перераспределения заявок - он позволит периодически обновлять для правил информацию о доступности сотрудника в настоящий момент.

Чтобы создать новое правило, нажмите "Создать новое правило" в правом верхнем углу раздела. Откроется окно создания правила. Вот пример заполненного окна.

Правило будет добавлено в список Доступные правила. Чтобы оно начало работать, перенесите его в список Действующие правила нажатием на + возле его названия:

Не забудьте сохранить изменения кнопкой "Сохранить" в правом нижнем углу окна.

Подробнее о работе с правилами автоназначения можно прочитать здесь.

Шаг 9. Подключение трекера задач

К Swarmica можно подключить трекер задач для связывания задач с заявками. На данный момент доступны к подключению следующие трекеры:

  • Yandex Tracker
  • Jira
  • Gitlab
  • Youtrack

По запросу подключается:

  • Kaiten

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

Если задача имеет ключевое отношение к заявке, сотрудник прикрепляет задачу к заявке опцией Добавить в заявку.

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

Для интеграции с вашим трекером перейдите в настройки системы в боковом меню и выберите Трекеры задач.

На открывшейся странице нажмите на название вашего трекера.

Откроется страница с полями для заполнения. Заполните их данными трекера. Поясним значение общих полей:

  1. Дополнительные поля - опциональные поля из трекера, которые должны содержаться в задаче для её передачи в Swarmica.
  2. Таймаут - временной промежуток в секундах, в течение которого Swarmica будет обращаться к трекеру при отсутствии моментального ответа. По умолчанию 30 секунд, менять этот параметр не рекомендуется, за исключением особых требований вашего девопса или сетевого администратора.
  3. Активен - включите бегунок для активации интеграции.

О том, как заполнять поля с данными трекера, мы подробнее рассказали в отдельной статье.

Первичные настройки окончены! Теперь вы можете обрабатывать заявки от клиентов по подключенным каналам и через личный кабинет клиента, внешний вид списка заявок настроен под ваш рабочий процесс, заявки будут автоматически распределяться по сотрудникам и группам, их можно будет привязывать к тикет-системе. Самое время для того, чтобы начать внедрение методологии знаний по принципу KCS! И в этом вам поможет интерактивная дорожная карта. Следующий шаг - обучение сотрудников в соответствии с методологией.

Команда Swarmica желает вам успешной работы!

Обновлена: 15 окт. 2026 г.

Системные требования

ВНИМАНИЕ! Сервер может быть виртуальным, но только на технологиях гипервизорной виртуализации. Установка и запуск внутри гостевой ОС на контейнерной платформе виртуализации не поддерживается

ОС

Поддерживаемые версии ОС:

  • Логотип Alt Server 11.1: поддерживаемая SwarmicaAlt Server 11.1 (Альт Сервер 11.1)
  • Логотип Astra Linux 1.8: поддерживаемая Swarmica Astra Linux 1.8
  • Логотип RedOS 8 стандартная: поддерживаемая Swarmica RedOS 8 Стандартная
  • Логотип RedOS 8 сертифицированная: поддерживаемая Swarmica RedOS 8 Сертифицированная
  • Логотип Ububtu 26.04 стандартная: поддерживаемая Swarmica Ubuntu 26.04.x LTS
  • Логотип Ububtu 24.04 стандартная: поддерживаемая Swarmica Ubuntu 24.04.x LTS
  • Логотип Ububtu 22.04 стандартная: поддерживаемая Swarmica Ubuntu 22.04.x LTS (рекомендуется перейти на более новые версии)

Минимальные

Минимальные требования для запуска приложения и его функционального тестирования:

CPU: 4 vCPU (Intel Core i5 / Xeon)
RAM: 16 GB
HDD: 50 GB SSD

Рекомендованные

Для рабочих режимов эксплуатации:

CPU: Intel Xeon / i7 8 Core
RAM: 32 GB
HDD: 500GB SSD (желателен RAID массив)

Требования к инфраструктуре

Исходящий трафик

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

  • https://reg.gl.swd.im - реестр образов контейнеров для приложения
  • https://license.swarmica.com - сервер лицензионных ключей Swarmica
  • https://mirror.gcr.io - зеркало реестра образов контейнеров для связанных сервисов, таких как redis, postgres, traefik и т.д.
  • Зеркала или репозитории пакетов для ОС Ubuntu, настроенные на сервере

Если будет использоваться SMTP Relay для исходящей почты, то он также должен быть доступен с сервера приложения.

Входящий трафик

  • Порты 80 и 443 - для WEB интерфейса
  • Порт 25 - если будет использоваться входящий канал электронной почты через SMTP

DNS

  • Выбранное доменное имя должно разрешаться во внешний IP адрес системы (запись A типа)

Пример:

Для того, чтобы система была доступна по адресу support.swarmica.com, установленном на сервере с IP адресом 79.141.74.181 и нужно добавить следующие записи в DNS:

support.swarmica.com   A      79.141.74.181

Входящая почта

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

  • Адрес сервера
  • Порт (993)
  • Пользователь (обычно тот же, что и адрес почты, например, support@company.tld)
  • Пароль (обычно тот же, что и для пользователя, за исключением почты на сервисах Gmail, Yandex Mail, Mail.ru - там требуется создать пароль приложения)

Исходящая почта

Для отправки исходящей почты требуется настроить SMTP Relay - авторизованный SMTP сервер, который будет пересылать почту из системы внешним получателям.

Поддерживаются протоколы:

  • SMTP (25)
  • SMTP SSL (465)
  • SMTP TLS (587)

Лицензия

Получите у представителя Swarmica следующие данные, необходимые для корректного запуска системы:

  • Лицензионный ключ Swarmica
  • Данные учетной записи для реестра образа контейнеров (логин и токен доступа)

Установка

1. Скачайте архив на сервер, где планируется установка:

mkdir swarmica-installer
cd swarmica-installer
wget https://support.swarmica.com/attachments/installer/installer.tar.gz

На RedOS необходимо установить утилиту wget следующей командой: sudo dnf install wget, если ее нет по умолчанию

2. Распакуйте архив подходящей утилитой:

tar -xvzf installer.tar.gz

3. Добавьте пермиссий на выполнение:

chmod +x installer.sh

4. Запустите установку:

./installer.sh install

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

Помощь: ./installer.sh help

Запуск в режиме DEBUG: export DEBUG=1; ./installer.sh install

Обновлена: 16 окт. 2026 г.
Всего результатов: 22
Элементов на странице
Страница
  • 1(current)
  • 2
  • 3