> ## 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.

# Яндекс Почта

> Загрузка писем из Яндекс Почты по IMAP

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

Коннектор «Яндекс Почта» — это готовая настройка обычного коннектора Email (IMAP) под сервер Яндекса (`imap.yandex.ru`,
порт 993). Вводить адрес и порт сервера не нужно — коннектор уже знает их.

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

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

## Настройка

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

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

**1. Включите доступ по IMAP**

В веб-версии Яндекс Почты откройте **Настройки → Почтовые программы** и включите **«С сервера imap.yandex.ru по
протоколу IMAP»** и **«Пароли приложений и OAuth-токены»**.

**2. Создайте пароль приложения**

Откройте [Яндекс ID](https://id.yandex.ru/security) → **Пароли приложений** и создайте пароль с типом **«Почта»**.
Пароль показывается один раз — сразу скопируйте и сохраните его.

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

Для обычного адреса `@yandex.ru` логин — часть адреса до «@» (для `ivanov@yandex.ru` это `ivanov`).
Для почты на своём домене (Яндекс 360) логин — полный адрес.

> [!NOTE]
>
> Чтобы создать пароль приложения, в Яндекс ID должна быть включена двухфакторная аутентификация.
> Без неё раздел создания паролей приложений недоступен.

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

**1. Откройте коннектор «Яндекс Почта»**

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

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

Укажите:

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

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

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

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

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

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

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


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