Инструкция

Подготовка

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

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

Обновление

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

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. Запустите команду создания отсутствующих шаблонов сообщений для WhatsApp и Telegram ботов:

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

3. Если используете модуль Контроль Качества Сервиса, пересчитайте метрику Несоблюдение критериев качества сервиса:

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

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

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

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

docker system prune -a

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

• 🔎 Подключение внешних источников для поиска (доступно в Премиум)
  • Теперь Swarmica может искать информацию за пределами своей базы. Можно подключать внешние порталы документации, базы знаний и т.д (при наличии соответствующего API) для поиска непосредственно:
    • В хелпцентре
    • В KCS-виджете, чтобы быстрее находить решения.
    • В веб-виджете
  • Helpcenter также получил поддержку внешнего поиска.
• 📊 Гибкие отчеты (Beta доступно в Премиум)
  • В системе появились система гибких отчетов - построение сводных таблиц по собственному выбору и компоновке метрик с сортировкой, усреднением, суммаризацией и т.д.
• 🧠 KCS и статьи
  • Поддержка ревизий статей и события при их добавлении (для автоматизаций и вебхуков)
  • Добавлено поле issues в /api/articles/ и в экспорт — теперь статьи можно связывать с задачами.
  • Добавлен фильтр по задачам для статей в API и языке запросов.
• 💌 Мессенджеры
  • Реализована отправка и обработка CSAT-оценок в Telegram и WhatsApp.
  • При отправке файлов в Telegram теперь сохраняются оригинальные имена.
• 🧩 UX
  • Теперь при создании шаблона из комментария копируются вложения.
  • Добавлен поиск по имени в в списке фильтров..

---

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

• 🗂 SLA и метрики
  • Теперь уведомление "тикет назначен" отправляется при создании тикета с заведомо назначенным агентом.
  • Исправлен экспорт тикетов — корректное отображение timedelta и названий связей.
  • Исправлено сохранение и перерасчёт SLA через Celery.
  • Исправлены ошибки в диаграммах QA Criteria.
• 💬 Коммуникации и интеграции
  • Добавлены логи отправки и получения сообщений в WhatsApp.
  • Исправлено обновление выпадающего списка доменов электронной почты.
  • Helpcenter теперь корректно сохраняет параметр URL при переходе по статье.
• ⚡ Производительность и стабильность
  • Исправлено поведение WebSocket-переподключений.
  • Исправлены циклические ссылки в дереве запросов.
  • Оптимизирована работа с кэшом Redis