Перейти к основному содержимому
Версия: 4.12

Часто задаваемые вопросы (FAQ)

Документ содержит ответы на наиболее частые вопросы клиентов и внутренние технические инструкции для специалистов поддержки и администраторов.

Вопросы от клиентов​

Как открыть виджет iQChannels?​

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

/widget/example.html

Пример:

https://iqchannels.ru/widget/example.html

После перехода по данному адресу откроется страница виджета.

Как подключиться к виджету на сервере?​

После установки и запуска приложения будут доступны два веб-сервера:

Где настраивается конфигурация чат-платформы?​

Основной конфигурационный файл находится на сервере по пути:

/opt/iqchannels/config/config.yaml

Пример конфигурации доступен в файле:

/opt/iqchannels/config/config.sample.yaml

Перед внесением изменений рекомендуется ознакомиться с примером конфигурации.

Как изменить путь хранения файлов из чата?​

  1. Откройте конфигурационный файл: /opt/iqchannels/config/config.yaml

  2. Найдите блок:

files: 
    upload_path: "var/upload"
  1. Укажите необходимый путь для хранения файлов.

Пример:

files: 
    upload_path: "/data/iqchannels/uploads"`

Как изменить максимальный размер загружаемых файлов?​

  1. Откройте файл конфигурации: /opt/iqchannels/config/config.yaml

  2. Измените параметр:

files: 
    max_file_size_mb: 32

Значение указывается в мегабайтах.

Пример:

files: 
    max_file_size_mb: 50

Как изменить путь хранения логов и уровень логирования?​

  1. Откройте файл конфигурации: /opt/iqchannels/config/config.yaml

  2. Найдите раздел логирования:

logs: 
  file:
    enabled: true # Enables the logger.
    level: debug # trace|debug|info|warn|error # Самый оптимальный это уровень дебаг, однако и самый ресурсозатратный при этом
    path: var/log/iqchanneld.log  # Path to a log file.

Возможные уровни логирования​

УровеньОписание
traceмаксимальная детализация
debugдетальная отладочная информация
infoосновная информация о работе
warnпредупреждения
errorтолько ошибки

Рекомендация: наиболее оптимальным является уровень debug, однако он также наиболее ресурсоёмкий.

Перестала отправляться автоматическая отбивка о нерабочем времени​

Проверьте настройки ограничения распределения обращений в конфигурации.

Файл: /opt/iqchannels/config/config.yaml

Блок:

routes:
  route_to_groups_ticket_limit: 1000 # Максимальное количество обращений которое может быть одновременно направлено на группы.
  route_to_users_ticket_limit: 1000 # Максимальное количество обращений, которое может быть одновременно направлено на конкретных операторов.

Эти параметры позволяют контролировать объём одновременно распределяемых обращений и предотвращать перегрузку операторов и системы.

Сообщения не отправляются в виджете или SDK​

Необходимо проверить конфигурацию Nginx.

Основная причина - отключённая поддержка SSE (Server-Sent Events).

Поиск в базе знаний не находит существующие статьи​

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

Почему не все письма доходят через email-канал?​

Корректная работа email-канала может нарушаться в следующих случаях:

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

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

Рекомендации:

  • Не использовать почтовый ящик одновременно в нескольких системах.
  • Не открывать письма напрямую в почтовом интерфейсе.

Вопросы от администраторов​

Как записать HAR-файл?​

HAR-файл используется для анализа сетевых запросов браузера.

Порядок действий:

  1. Откройте инструменты разработчика браузера (F12).
  2. Перейдите на вкладку Network.
  3. Установите галочку Preserve log.
  4. Обновите страницу.
  5. Воспроизведите проблему.
  6. Нажмите на иконку Export HAR.
  7. Сохраните файл и передайте его в техническую поддержку.

Как изменить часовой пояс базы данных?​

Подключитесь к пользователю postgres:

sudo -u postgres psql

Выполните команду:

ALTER DATABASE iqchannels SET timezone TO 'UTC'

После этого база данных будет использовать указанный часовой пояс.

Как сформировать ссылку на Docker-сборку?​

# логинимся через команду (вводим логин и пароль, чтобы получить доступ)
docker login registry.iqstore.ru
# ссылка на docker формируется следующим образом:
registry.iqstore.ru/iqchannels:<версия>
# далее чтобы подтянуть сборку и сформировать образ, вводим команду
docker pull registry.iqstore.ru/iqchannels:<версия>