Главная / Документация / Настройки продуктаОбщий ящик (IMAP): прием писем организацииПодключение общего почтового ящика по IMAP: поля, первое и повторное получение, автоматический опрос, права канцелярии и разбор ошибок.Обновлено 27.09.2026Общий ящик - это корпоративный адрес организации (например info@ или канцелярия). volrix.pm забирает из него письма по IMAP в раздел «Почта», где канцелярия назначает их исполнителям и регистрирует как входящие документы. Ящик читается только на чтение: на сервере письма не удаляются и не помечаются прочитанными.«Администрирование» → «Настройки продукта» → «Почта» → вкладка «Общий ящик (IMAP)». Личные ящики сотрудники подключают сами в разделе Почта. Общий IMAP: сервер, папка, TLS и автоматическое получение. Пароль скрыт.

Общий IMAP: сервер, папка, TLS и автоматическое получение. Пароль скрыт.

Кто что может

Действие

Право

По умолчанию

Видеть и менять настройки, проверять подключение

mailbox.read_settings, mailbox.update_settings, mailbox.test_connection

администратор системы

Запускать получение писем

mailbox.fetch

администратор системы, «Канцелярия»

Читать письма, назначать, менять статус

mailbox.read_messages, mailbox.manage_messages

администратор системы, «Канцелярия»

Регистрировать письмо во входящие

mailbox.convert

администратор системы, «Канцелярия»

Кому из имеющих право на «Почту» виден сам общий ящик, задается списком на вкладке «Провайдеры и доступ»: пока список пуст, ящик видят все с правом на почту.Поля

Поле

Что указать

«Хост IMAP»

Имя IMAP-сервера, например mail.company.ru.

«Порт»

993 при включенном «SSL/TLS» (по умолчанию), 143 при выключенном.

«Логин (email)»

Учетная запись ящика.

«Пароль»

Пароль или пароль приложения. Пустое поле при сохранении - «не менять». В шапке значок «Пароль установлен» или «Пароль не задан».

«Папка»

Откуда забирать письма, по умолчанию INBOX. Для другой папки укажите имя точно как на сервере.

«SSL/TLS»

Включено: шифрование с первого байта (порт 993). Выключено: обычное подключение, которое сразу переводится в шифрование командой STARTTLS (порт 143). Незашифрованный IMAP не поддерживается.

«Проверять сертификат»

Проверка сертификата сервера. Выключают для самоподписанного сертификата или сертификата внутреннего центра.

«Включить автоматический fetch»

Забирать письма по расписанию. Выключено - только кнопкой «Получить письма сейчас».

«Периодичность (минут)»

От 1 до 1440, по умолчанию 5.

Как проходит получение

**Первое получение** забирает последние письма папки: их число задает параметр «Первая загрузка ящика» в Пределах и порогах, по умолчанию 50. Подсказка на экране всегда пишет 50, даже если параметр изменен. Более старая переписка не загружается.

**Следующие получения** забирают только письма, пришедшие после последнего полученного. Повторный запуск не создает дублей: каждое письмо опознается по его номеру (UID) в папке.

**Смена папки или пересоздание папки на сервере** сбрасывает отсчет: снова забираются последние письма в пределах «Первой загрузки ящика».

**Вложения** сохраняются в хранилище файлов вместе с письмом.

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

**Автоматический опрос** выполняет планировщик: он проверяет настройку каждую минуту, а к серверу обращается не чаще, чем задано в «Периодичность (минут)». В стандартной установке это отдельный контейнер volrix-scheduler.

Порядок настройки

Заполните и сохраните Заполните поля и нажмите «Сохранить» - появится «Настройки IMAP обновлены». Кнопки блока «Действия» работают только с сохраненными значениями.

Проверьте подключение Нажмите «Проверить подключение». При успехе появится «Подключение успешно» с числом писем: «Подключение успешно. В папке 'INBOX' писем: N.» При ошибке над формой появится красная плашка с ответом сервера.

Получите тестовое письмо Отправьте в ящик письмо с узнаваемой темой и небольшим вложением. Нажмите «Получить письма сейчас». Итог: «Скачано: X, сохранено: Y, пропущено (уже было): Z».

Проверьте в разделе «Почта» Откройте общий ящик в разделе «Почта», найдите письмо и откройте вложение.

Повторите получение Снова нажмите «Получить письма сейчас»: новых сохранений быть не должно, уже полученные письма уходят в «пропущено».

Включите автоматический опрос Включите «Включить автоматический fetch», задайте «Периодичность (минут)» и сохраните. Отправьте еще одно письмо и убедитесь, что оно появилось само через заданный интервал.

Если не получается

Что видно

Причина и что сделать

«IMAP не настроен. Заполните хост, пользователя и пароль.»

Не сохранены хост, логин или пароль. Заполните и нажмите «Сохранить» до проверки.

«IMAP error: ... AUTHENTICATIONFAILED ...» или «Сервер не принял логин или пароль»

Неверный логин или пароль. У Яндекса и Gmail обычный пароль аккаунта не подходит - нужен пароль приложения.

«В настройках почтового ящика выключен доступ по IMAP»

Включите IMAP в настройках ящика на стороне почтового сервиса.

«Не удалось открыть папку '...'»

Папки с таким именем нет. Проверьте «Папку» - имя должно совпадать с сервером.

Ошибка с «wrong version number» или «certificate verify failed»

Порт не соответствует режиму: 993 - с «SSL/TLS», 143 - без. Для самоподписанного сертификата выключите «Проверять сертификат».

«Почтовый сервер не отвечает по этому адресу и порту» или долгое ожидание

Порт закрыт или сервер недоступен из сети volrix.pm. Проверьте адрес, порт и сетевой экран.

Проверка проходит, но письма сами не появляются

Не включен или не сохранен «Включить автоматический fetch», либо не работает планировщик. Проверьте контейнер: docker logs --since 1h volrix-scheduler, ищите строку «IMAP fetch failed».

Нет старых писем

При первом подключении загружаются только последние письма в пределах «Первой загрузки ящика». Увеличьте параметр до подключения ящика.

Письмо получено, но во входящих его нет

Получение и регистрация - разные шаги. Зарегистрируйте письмо из раздела «Почта» (право mailbox.convert), см. Входящие письма.

Почта

Входящие письма

Провайдеры и доступ

Работа с письмами общего и личных ящиков.Регистрация, назначение исполнителя и контроль.Кому виден общий ящик и вход через провайдера.

Интеграции и REST API

СЭД на своих серверах