Электронная почта (IMAP)

Индексация почтового ящика по IMAP в Charo — подходит для любой почты, включая российские почтовые сервисы и корпоративные серверы.

Что индексируется

Письма выбранных папок почтового ящика (или всех папок).
Из письма берутся тема, отправитель, получатели, дата и текст; HTML-письма преобразуются в текст.
Вложения индексируются вместе с письмом; со сканов и картинок текст распознаётся.

Коннектор работает с любым сервером IMAP: корпоративная почта (Exchange с IMAP, Communigate, Postfix/Dovecot), российские сервисы (Яндекс 360, Mail.ru) и другие.

Предварительные требования

Доступ к ящику по IMAP (протокол должен быть включён на сервере или в настройках ящика).
Соединение всегда шифрованное: коннектор подключается только по IMAP over TLS, порт по умолчанию 993. Открытого IMAP без шифрования нет.
Для сервисов с двухфакторной аутентификацией — пароль приложения.

Получение учётных данных

Узнайте адрес и порт IMAP-сервера. Например: imap.yandex.ru:993, imap.mail.ru:993.
Если включена двухфакторная аутентификация, создайте пароль приложения в настройках безопасности почтового сервиса.
В Charo заполните «Имя пользователя IMAP» (полный адрес ящика) и «Пароль IMAP» (пароль или пароль приложения).

Настройка в Charo

Поле	Что указать
Хост IMAP-сервера	например `imap.yandex.ru`
Порт IMAP-сервера	по умолчанию 993
Почтовые ящики	список папок (например, `INBOX`, `Sent`); пусто — все папки ящика

Синхронизация прав

Не поддерживается: письма увидят все, кому виден коннектор. Подключайте общие ящики (поддержка, заявки), а не личную почту, либо ограничивайте видимость группами (см. «Права доступа»).

Ограничения и частота обновления

Обновления забираются инкрементально: коннектор проходит папки по очереди и запоминает, где остановился, поэтому большой ящик индексируется за несколько проходов.
Скорость зависит от ограничений вашего IMAP-сервера.

Устранение неполадок

Ошибка входа при сохранении коннектора

Проверка учётных данных — это реальный вход на сервер. Для Яндекса и Mail.ru при включённой двухфакторной аутентификации обычный пароль не подойдёт, нужен пароль приложения. Проверьте также, что IMAP включён в настройках ящика.

Ошибка соединения

Проверьте хост и порт и доступность сервера именно с сервера Charo. Порт должен быть портом IMAP over TLS (обычно 993): к серверу без TLS коннектор не подключится.

Папка не индексируется

Название папки должно совпадать с серверным. Для кириллических папок оно может отличаться от того, что показывает почтовый клиент.

Проиндексировано 0 писем

Если поле «Почтовые ящики» пустое, а сервер не вернул ни одной папки — проверьте права учётной записи на сервере.