Перейти к содержанию

Файлы, почта и уведомления

Ограничения на файлы и изображения, отдача файлов из S3-хранилища, почтовые и пуш-уведомления, частота опроса сервера виджетом.

Как читать таблицы и редактировать значения, описано в разделе Настройки в Constance.

Файлы

Параметр Тип По умолчанию Описание
ALLOWED_UPLOAD_FILE_TYPES Список строк См. ниже Расширения файлов (без точки), которые разрешено отправлять посетителям.
Пример: ["png", "jpg", "pdf"].
ALLOWED_UPLOAD_FILE_CONTENT_TYPES Список строк См. ниже Медиатипы (MIME-типы) файлов, которые разрешено отправлять посетителям.
Пример: ["image/png", "image/jpeg", "application/pdf"].
ENHANCED_FILE_SECURITY Логический Выключено Включает строгую проверку файлов от посетителей: запрещаются файлы с неопределённым медиатипом и файлы без расширения, медиатип не определяется по содержимому файла.
ROBOT_ALLOWED_UPLOAD_FILE_TYPES Список строк См. ниже Расширения файлов (без точки), которые разрешено отправлять ботам. Формат такой же, как у ALLOWED_UPLOAD_FILE_TYPES.
ROBOT_ALLOWED_UPLOAD_FILE_CONTENT_TYPES Список строк См. ниже Медиатипы файлов, которые разрешено отправлять ботам. Формат такой же, как у ALLOWED_UPLOAD_FILE_CONTENT_TYPES.
ROBOT_ENHANCED_FILE_SECURITY Логический Выключено Включает строгую проверку файлов от ботов. Правила такие же, как у ENHANCED_FILE_SECURITY.
MAX_VISITOR_UPLOAD_FILE_SIZE Целое число 10 Максимальный размер файла от посетителя в мегабайтах. Если значение больше параметра NGINX_UPLOAD_SIZE файла .env (по умолчанию 10 МБ, см. Файлы и S3-хранилище), действует значение параметра.
MAX_ROBOT_UPLOAD_FILE_SIZE Целое число 10 Максимальный размер файла от бота в мегабайтах. Ограничивается параметром NGINX_UPLOAD_SIZE файла .env так же, как MAX_VISITOR_UPLOAD_FILE_SIZE.
FILE_URL_EXPIRING_TIMEOUT Длительность 1 день
1 00:00:00
Срок действия ссылки на скачивание файла.
FILE_URL_HASH_KEY Строка Пусто Ключ для вычисления параметра hash в ссылках на файлы. Если значение пустое, ключ генерируется автоматически при первом обращении. После смены ключа ранее выданные ссылки на файлы перестают работать.
Значение скрыто в форме редактирования.
AUDIO_PLAYABLE_FILE_EXTENSIONS Список строк [] Расширения файлов (без точки), которые в РМО воспроизводятся встроенным аудиопроигрывателем вместо ссылки на скачивание.
Пример: ["mp3", "ogg", "wav"].
FILES_EXTENSIONS_TO_HIDE_FILENAME Список строк [] Расширения файлов (без точки), имена которых не показываются посетителю в сообщениях оператора.
Пример: ["pdf"].
CUSTOM_THUMBNAIL_SIZES JSON-объект {} Собственные размеры миниатюр изображений по платформам. Ключ — платформа (ios, android, web), значение — ширина и высота в пикселях. Пустой объект — размеры по умолчанию.
Пример: {"web": [300, 300], "ios": [400, 400]}.
MAX_SIZE_LOGO_AND_AVATAR Целое число 1 048 576 (1 МБ) Максимальный размер файла аватара или логотипа в байтах.
MAX_SIZE_BUTTON Целое число 10 485 760 (10 МБ) Максимальный размер файла изображения кнопки в байтах.
MAX_SIZE_CANNED_RESPONSES_CSV Целое число 5 242 880 (5 МБ) Максимальный размер CSV-файла при импорте шаблонов ответов в байтах.
MAX_SIZE_STICKER Целое число 10 485 760 (10 МБ) Максимальный размер файла стикера в байтах.
AVATAR_MAX_DIMENSION Целое число 200 Максимальный размер стороны аватара в пикселях; аватары большего размера уменьшаются.
AVATAR_MAX_PIXELS Целое число 4 194 304 (2048 × 2048) Максимальное количество пикселей в изображении аватара при обработке. Защищает сервер от изображений, распаковка которых требует слишком много памяти.
BUTTON_MAX_PIXELS Целое число 49 000 000 (7000 × 7000) Максимальное количество пикселей в изображении кнопки при обработке.
STICKER_MAX_PIXELS Целое число 49 000 000 (7000 × 7000) Максимальное количество пикселей в изображении стикера при обработке.
S3_FILE_SERVE_MODE Строка proxy Способ отдачи файлов из S3-хранилища. Допустимые значения: proxy — файл передаётся через сервер Webim; redirect — клиент перенаправляется на файл в хранилище (ответ 302).
S3_VISITOR_CONFIGS_REDIRECT_MODE Логический Выключено Отдаёт конфигурацию виджета перенаправлением на файл в S3-хранилище, а не через сервер Webim.

Email

Параметр Тип По умолчанию Описание
EMAIL_NOTIFICATIONS Логический Включено Включает отправку уведомлений и историй диалогов по электронной почте. Связанные элементы интерфейса показываются только при включённой настройке.
PASSWORD_RECOVERY_BY_EMAIL Логический Выключено Разрешает восстанавливать пароль по электронной почте и отправлять пароль новому сотруднику. При выключенной настройке ссылка «Забыли пароль?» и флажок «Отправить пароль» скрыты.
DEFAULT_EMAIL_SUBJECT Строка Сообщение от оператора Тема исходящего письма в канале электронной почты по умолчанию.
Зависит от тарифной возможности email_integration: без неё действует пустое значение.
STATS_EMAIL Строка Пусто Зарезервированное поле адресов для ежедневного отчёта со статистикой. Несколько адресов разделяются запятой или точкой с запятой.
Пример: stats@example.local, head@example.local.
В интерфейсе: «Настройки» → «Общие» → «Email-уведомления». Можно задать и в настройках отдела.
В Webim 11.0 ежедневная рассылка писем со статистикой не реализована — значение параметра на отправку писем не влияет. См. Ежедневная рассылка писем со статистикой.
OFFLINE_EMAIL Строка Пусто Адреса для сообщений, оставленных посетителями в отсутствие операторов. Первый адрес используется как обратный адрес исходящих писем. Несколько адресов разделяются запятой или точкой с запятой.
В интерфейсе: «Настройки» → «Общие» → «Email-уведомления». Можно переопределить в настройках отдела.
SUPERVISER_EMAIL Строка Пусто Адреса для уведомлений о негативных оценках операторов и о занятости операторов. Несколько адресов разделяются запятой или точкой с запятой.
В интерфейсе: «Настройки» → «Общие» → «Email-уведомления». Можно переопределить в настройках отдела.
SEND_OPERATOR_RATE_MAIL_IMMEDIATELY Логический Включено Отправляет письмо о негативной оценке оператора сразу после оценки.
SEND_OPERATOR_RATE_MAIL_ON_CHAT_CLOSE Логический Выключено Отправляет письмо о негативной оценке оператора после закрытия диалога.
UNREAD_CHAT_SENDING_TO_VISITOR_BY_EMAIL_TIMEOUT Длительность 10 минут
00:10:00
Время, через которое непрочитанные посетителем сообщения отправляются ему по электронной почте.
UNREAD_CHAT_SENDING_TO_VISITOR_BY_EMAIL_MAX_TIMEOUT Длительность 1 день
1 00:00:00
Максимальный возраст непрочитанных сообщений, которые ещё отправляются посетителю по электронной почте. Более старые сообщения не отправляются.
SEND_UNREAD_MESSAGES_TO_VISITOR_BY_EMAIL Строка always Режим отправки непрочитанных сообщений посетителю по электронной почте. Допустимые значения: always — всегда, never — никогда, started_offline — только для обращений, начатых в офлайн-режиме.
В интерфейсе: «Настройки» → «Общие» → «Email-уведомления». Можно переопределить в настройках отдела.
TIMEOUT_FOR_SEND_EMAIL_ABOUT_VISITOR_WAITING Длительность 4 минуты
00:04:00
Время ожидания посетителя, после которого отправляется письмо о том, что посетитель ждёт ответа.

Пуш-уведомления

Параметр Тип По умолчанию Описание
HIDE_VISITOR_MESSAGE_IN_PUSH Логический Включено Заменяет текст сообщения посетителя в пуш-уведомлении нейтральной фразой.
HIDE_VISITOR_FILENAME_IN_PUSH Логический Включено Заменяет имя файла от посетителя в пуш-уведомлении нейтральной фразой.
PUSH_NOTIFICATIONS_VERBOSE_LOG Логический Выключено Диагностическая настройка. Записывает в журнал подробности отправки пуш-уведомлений: создание уведомления, выбор устройств, маршрутизацию по платформам и результат.
SENDING_UNREAD_MESSAGES_TO_IOS Логический Выключено Отправляет непрочитанные сообщения на устройства iOS.
NEW_VISITOR_NOTIFICATION Логический Выключено Показывает оператору оповещение о новом посетителе.
В интерфейсе: «Настройки» → «Общие» → «Возможности».
FORCE_VISITOR_MESSAGE_ALARM Логический Выключено Включает звуковое оповещение о новых сообщениях посетителей, даже если оператор активен на странице.
NEW_VISITOR_NOTIFICATION_TIMEOUT Длительность 15 секунд
00:00:15
Время показа оповещения о новом посетителе.

Поллинг

Параметр Тип По умолчанию Описание
NORMAL_POLLING_PERIOD Длительность 10 секунд
00:00:10
Период опроса сервера виджетом, когда диалог не ведётся.
IN_CHAT_POLLING_PERIOD Длительность 2 секунды
00:00:02
Период опроса сервера виджетом во время диалога.

Значения по умолчанию

Значения по умолчанию, которые не поместились в таблицы.

ALLOWED_UPLOAD_FILE_TYPES

[
  "png", "jpg", "jpeg", "doc", "docx", "rtf", "gif", "txt", "pdf", "webp",
  "oga", "ogg", "ogv", "mp3", "wav", "mp4", "m4a", "mov", "aac", "odt", "amr",
  "jpe", "heic", "heif", "avif", "3gp", "xlsx", "mkv", "opus"
]

ALLOWED_UPLOAD_FILE_CONTENT_TYPES

[
  "image/png", "image/jpeg", "image/pjpeg", "application/msword",
  "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "application/rtf", "text/rtf", "image/gif", "text/plain", "application/pdf",
  "image/webp", "audio/ogg", "application/ogg", "video/ogg", "audio/mpeg",
  "audio/wav", "audio/mp4", "audio/x-m4a", "video/mp4", "video/quicktime",
  "audio/aac", "application/vnd.oasis.opendocument.text", "audio/amr",
  "image/heif", "image/heif-sequence", "image/heic", "image/heic-sequence",
  "image/avif", "image/avif-sequence", "video/3gpp", "audio/3gpp",
  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
  "video/x-matroska", "video/mkv", "video/x-mkv", "video/matroska",
  "audio/matroska", "audio/x-matroska", "video/webm", "audio/opus"
]

ROBOT_ALLOWED_UPLOAD_FILE_TYPES

[
  "png", "jpg", "jpeg", "doc", "docx", "rtf", "gif", "txt", "pdf", "webp",
  "oga", "ogg", "ogv", "mp3", "wav", "mp4", "m4a", "mov", "aac", "odt", "amr",
  "jpe", "heic", "heif", "avif", "3gp", "xlsx", "mkv", "opus"
]

ROBOT_ALLOWED_UPLOAD_FILE_CONTENT_TYPES

[
  "image/png", "image/jpeg", "image/jpg", "image/pjpeg", "application/msword",
  "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "application/rtf", "text/rtf", "image/gif", "text/plain", "application/pdf",
  "image/webp", "audio/ogg", "application/ogg", "video/ogg", "audio/mpeg",
  "audio/wav", "audio/mp4", "audio/x-m4a", "video/mp4", "video/quicktime",
  "audio/aac", "application/vnd.oasis.opendocument.text", "audio/amr",
  "image/heif", "image/heif-sequence", "image/heic", "image/heic-sequence",
  "image/avif", "image/avif-sequence", "video/3gpp", "audio/3gpp",
  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
  "video/x-matroska", "video/mkv", "video/x-mkv", "video/matroska",
  "audio/matroska", "audio/x-matroska", "video/webm", "audio/opus"
]