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

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

Как читать таблицы и редактировать значения, описано в разделе [Настройки в Constance](https://webim.ru/kb/11.0/settings/constance/).

## Файлы { #files }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `ALLOWED_UPLOAD_FILE_TYPES` | Список строк | См. [ниже](#default-allowed-upload-file-types) | Расширения файлов (без точки), которые разрешено отправлять посетителям.<br>Пример: `["png", "jpg", "pdf"]`. |
| `ALLOWED_UPLOAD_FILE_CONTENT_TYPES` | Список строк | См. [ниже](#default-allowed-upload-file-content-types) | Медиатипы (MIME-типы) файлов, которые разрешено отправлять посетителям.<br>Пример: `["image/png", "image/jpeg", "application/pdf"]`. |
| `ENHANCED_FILE_SECURITY` | Логический | Выключено | Включает строгую проверку файлов от посетителей: запрещаются файлы с неопределённым медиатипом и файлы без расширения, медиатип не определяется по содержимому файла. |
| `ROBOT_ALLOWED_UPLOAD_FILE_TYPES` | Список строк | См. [ниже](#default-robot-allowed-upload-file-types) | Расширения файлов (без точки), которые разрешено отправлять ботам. Формат такой же, как у `ALLOWED_UPLOAD_FILE_TYPES`. |
| `ROBOT_ALLOWED_UPLOAD_FILE_CONTENT_TYPES` | Список строк | См. [ниже](#default-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-хранилище](https://webim.ru/kb/11.0/settings/env/files.html#limits)), действует значение параметра. |
| `MAX_ROBOT_UPLOAD_FILE_SIZE` | Целое число | 10 | Максимальный размер файла от бота в мегабайтах. Ограничивается параметром `NGINX_UPLOAD_SIZE` файла `.env` так же, как `MAX_VISITOR_UPLOAD_FILE_SIZE`. |
| `FILE_URL_EXPIRING_TIMEOUT` | Длительность | 1 день<br>`1 00:00:00` | Срок действия ссылки на скачивание файла. |
| `FILE_URL_HASH_KEY` | Строка | Пусто | Ключ для вычисления параметра `hash` в ссылках на файлы. Если значение пустое, ключ генерируется автоматически при первом обращении. После смены ключа ранее выданные ссылки на файлы перестают работать.<br>Значение скрыто в форме редактирования. |
| `AUDIO_PLAYABLE_FILE_EXTENSIONS` | Список строк | `[]` | Расширения файлов (без точки), которые в РМО воспроизводятся встроенным аудиопроигрывателем вместо ссылки на скачивание.<br>Пример: `["mp3", "ogg", "wav"]`. |
| `FILES_EXTENSIONS_TO_HIDE_FILENAME` | Список строк | `[]` | Расширения файлов (без точки), имена которых не показываются посетителю в сообщениях оператора.<br>Пример: `["pdf"]`. |
| `CUSTOM_THUMBNAIL_SIZES` | JSON-объект | `{}` | Собственные размеры миниатюр изображений по платформам. Ключ — платформа (`ios`, `android`, `web`), значение — ширина и высота в пикселях. Пустой объект — размеры по умолчанию.<br>Пример: `{"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 }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `EMAIL_NOTIFICATIONS` | Логический | Включено | Включает отправку уведомлений и историй диалогов по электронной почте. Связанные элементы интерфейса показываются только при включённой настройке. |
| `PASSWORD_RECOVERY_BY_EMAIL` | Логический | Выключено | Разрешает восстанавливать пароль по электронной почте и отправлять пароль новому сотруднику. При выключенной настройке ссылка «Забыли пароль?» и флажок «Отправить пароль» скрыты. |
| `DEFAULT_EMAIL_SUBJECT` | Строка | `Сообщение от оператора` | Тема исходящего письма в канале электронной почты по умолчанию.<br>Зависит от тарифной возможности `email_integration`: без неё действует пустое значение. |
| `STATS_EMAIL` | Строка | Пусто | Зарезервированное поле адресов для ежедневного отчёта со статистикой. Несколько адресов разделяются запятой или точкой с запятой.<br>Пример: `stats@example.local, head@example.local`.<br>В интерфейсе: «Настройки» → «Общие» → «Email-уведомления». Можно задать и в настройках отдела.<br>В Webim 11.0 **ежедневная рассылка писем со статистикой не реализована** — значение параметра на отправку писем не влияет. См. [Ежедневная рассылка писем со статистикой](https://webim.ru/kb/11.0/for-analytics/statistics/daily-email-reports.html). |
| `OFFLINE_EMAIL` | Строка | Пусто | Адреса для сообщений, оставленных посетителями в отсутствие операторов. Первый адрес используется как обратный адрес исходящих писем. Несколько адресов разделяются запятой или точкой с запятой.<br>В интерфейсе: «Настройки» → «Общие» → «Email-уведомления». Можно переопределить в настройках отдела. |
| `SUPERVISER_EMAIL` | Строка | Пусто | Адреса для уведомлений о негативных оценках операторов и о занятости операторов. Несколько адресов разделяются запятой или точкой с запятой.<br>В интерфейсе: «Настройки» → «Общие» → «Email-уведомления». Можно переопределить в настройках отдела. |
| `SEND_OPERATOR_RATE_MAIL_IMMEDIATELY` | Логический | Включено | Отправляет письмо о негативной оценке оператора сразу после оценки. |
| `SEND_OPERATOR_RATE_MAIL_ON_CHAT_CLOSE` | Логический | Выключено | Отправляет письмо о негативной оценке оператора после закрытия диалога. |
| `UNREAD_CHAT_SENDING_TO_VISITOR_BY_EMAIL_TIMEOUT` | Длительность | 10 минут<br>`00:10:00` | Время, через которое непрочитанные посетителем сообщения отправляются ему по электронной почте. |
| `UNREAD_CHAT_SENDING_TO_VISITOR_BY_EMAIL_MAX_TIMEOUT` | Длительность | 1 день<br>`1 00:00:00` | Максимальный возраст непрочитанных сообщений, которые ещё отправляются посетителю по электронной почте. Более старые сообщения не отправляются. |
| `SEND_UNREAD_MESSAGES_TO_VISITOR_BY_EMAIL` | Строка | `always` | Режим отправки непрочитанных сообщений посетителю по электронной почте. Допустимые значения: `always` — всегда, `never` — никогда, `started_offline` — только для обращений, начатых в офлайн-режиме.<br>В интерфейсе: «Настройки» → «Общие» → «Email-уведомления». Можно переопределить в настройках отдела. |
| `TIMEOUT_FOR_SEND_EMAIL_ABOUT_VISITOR_WAITING` | Длительность | 4 минуты<br>`00:04:00` | Время ожидания посетителя, после которого отправляется письмо о том, что посетитель ждёт ответа. |

## Пуш-уведомления { #push }

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

## Поллинг { #polling }

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

## Значения по умолчанию { #defaults }

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

### ALLOWED_UPLOAD_FILE_TYPES { #default-allowed-upload-file-types }

```json
[
  "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 { #default-allowed-upload-file-content-types }

```json
[
  "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 { #default-robot-allowed-upload-file-types }

```json
[
  "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 { #default-robot-allowed-upload-file-content-types }

```json
[
  "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"
]
```

---

Источник: https://webim.ru/kb/11.0/settings/constance/files-notifications.html
