Файлы, почта и уведомления
Ограничения на файлы и изображения, отдача файлов из 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_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"
]