> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mail.ru

> Загрузка писем из почты Mail.ru по IMAP

## Как это работает

Коннектор Mail.ru — это готовая настройка обычного коннектора Email (IMAP) под сервер Mail.ru (`imap.mail.ru`,
порт 993). Он подходит и для адресов на доменах `@inbox.ru`, `@list.ru`, `@bk.ru` и `@internet.ru`.
Вводить адрес и порт сервера не нужно — коннектор уже знает их.

По умолчанию (поле **Mailboxes** пустое) индексируются все папки ящика, кроме «Спама» и «Корзины».
«Черновики» и «Исходящие» индексируются. В отличие от Яндекс Почты,
вкладки «Социальные сети» и «Рассылки» у Mail.ru — настоящие IMAP-папки: если почта туда разложена,
они индексируются отдельно.

Из письма индексируются тема, текст, отправитель, получатели (To/Cc), дата и папка.
Вложения не разбираются и не индексируются — как и у коннектора Gmail. Коннектор только читает почту:
он ничего не меняет и не удаляет на сервере.

## Настройка

### Авторизация

Mail.ru не выдаёт доступ по IMAP с обычным паролем от аккаунта — нужен отдельный пароль для внешних приложений.

**1. Создайте пароль для внешних приложений**

В веб-версии почты откройте **Настройки → Все настройки → Безопасность → Пароли для внешних приложений** и создайте
новый пароль. Пароль показывается один раз — сразу скопируйте и сохраните его.

**2. Определите логин**

Логин — всегда полный адрес почты, например `name@mail.ru`.

> [!NOTE]
>
> Чтобы создать пароль для внешних приложений, к аккаунту должен быть привязан номер телефона.
> Без привязанного телефона Mail.ru не выдаёт такой пароль.

### Индексирование

**1. Откройте коннектор Mail.ru**

Откройте панель администратора и выберите коннектор **Mail.ru**.

**2. Создайте учётные данные**

Укажите:

* **Логин**: полный адрес почты, например `name@mail.ru`.
* **Пароль приложения**: пароль, созданный на предыдущем шаге.

**3. Настройте сведения о коннекторе (необязательно)**

В поле **Mailboxes** можно перечислить конкретные папки для индексации, например `INBOX`, `Отправленные`.
Оставьте поле пустым, чтобы индексировать все папки, кроме «Спама» и «Корзины».

> [!NOTE]
>
> Системные папки Mail.ru называются по-английски даже в кириллическом интерфейсе (`INBOX`, `Sent`, `Drafts`,
> `Spam`, `Trash`). Папки, которые создал сам пользователь, называются так, как их назвали, в том числе кириллицей.
> В поле нужно вводить IMAP-имя папки, а не то, что показано в веб-почте.

Коннектор опрашивает ящик каждые **30 минут** (настраивается полем **«Обновлять каждые»**). Письмо,
пришедшее только что, появляется в поиске в течение этого интервала, не мгновенно.
Поле **«Индексировать документы после»** ограничивает глубину истории: письма старше указанной даты не индексируются.
Поле **«Очищать каждые»** (по умолчанию 7 дней) убирает из индекса письма, которых больше нет в ящике,
например удалённые или перенесённые в «Спам».

## Ограничения

* Вложения не разбираются и не индексируются.
* В ответах чата нет ссылки на письмо в веб-почте Mail.ru: сервис не позволяет открыть письмо по его `Message-ID`.
* Один коннектор индексирует один ящик. Для нескольких ящиков нужно несколько коннекторов.
* Для общего (служебного) ящика доступ к его письмам в Yahont получат все участники группы коннектора
  либо только тот, кто создал учётные данные — раздачи прав по отправителю или получателю для этого коннектора нет.
* Письмо, которое вернули из «Спама» позже дня получения, не подхватится очередным опросом
  автоматически — для него нужна полная переиндексация коннектора.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.