# Email

**Содержание страницы**

1. [Импорт](#id-1.-import)
2. [Экспорт](#id-2.-eksport)
3. [Массовое редактирование](#id-3.-massovoe-redaktirovanie)
4. [Редактирование одной почты](#id-4.-odinochnoe-redaktirovanie)
5. [Присвоить Email к профилю](#id-5.-prisvoit-email-k-profilyu)
6. [Статусы](#id-5.-statusy-emeila)
7. [Проверка подключения](#id-6.-proverka-podklyucheniya-pocht)
8. [Получение писем](#id-7.-poluchenie-pisem-s-pocht)
9. [Суб-таблица](#id-8.-sub-tablica-s-pismami)
10. [Колонки таблицы](#id-5.-kolonki-tablicy)
11. [Ограничения](#id-10.-ogranicheniya)

***

### 1. Импорт

<figure><img src="/files/ImTTf7sv35pZIfSWgizr" alt=""><figcaption><p>Пример импорта почты</p></figcaption></figure>

**Что делает**\
Позволяет добавить одну или несколько почт с заданным форматом, паролями, 2FA и распределением по группам.

**Как это сделать**

1. Нажмите кнопку **«Импорт» -** <img src="/files/nbpR9KQCeZcgRW6BXXnc" alt="" data-size="line">.
2. В открывшемся окне заполните поля:
   * **Имя** — название, которое будет присвоено этому почтовому аккаунту.
   * **Группа** — группа, в которую попадёт почта (см. раздел «Работа с группами»).
   * **Разделитель** — символ, который разделяет части данных (например, `:` или `,`).
   * **Универсальный формат** — шаблон, в котором вы указываете, какие поля содержатся:
     * `email` — адрес почты
     * `password` — пароль почты
     * `appPassword` — пароль приложения (для IMAP)
     * `code2FA` — код двухфакторной аутентификации
   * **Поле данных** — вставьте строки с данными почт, соответствующие формату.
3. Нажмите «Импорт».
4. Новые почты добавятся в таблицу.

**Советы / примечания**

* Убедитесь, что строки соответствуют формату, иначе часть данных может быть проигнорирована или обработана некорректно.
* Если у почты есть 2FA, обязательно укажите `code2FA`.
* Детальные инструкции по импорту каждой почты - [тут](/agent-x/kak-dobavit-pochty.md)

***

### 2. Экспорт

<figure><img src="/files/PfRnxhv1FbFJ0M2lnqvY" alt=""><figcaption><p>Пример экспорта почты</p></figcaption></figure>

**Что делает**\
Позволяет выгрузить почтовые данные из системы в выбранном формате (для резервного копирования или использования вне системы).

**Как это сделать**

1. Выберите почты, которые нужно экспортировать.
2. Нажмите кнопку **Экспорт** - <img src="/files/sD36KC9l5dgI70uG2H36" alt="" data-size="line">.
3. В диалоговом окне:
   * Измените **разделитель** экспортируемых полей.
   * Настройте формат (перечень полей): `email`, `password`, `appPassword`, `code2FA`.
4. Нажмите **Скопировать**.

***

### 3. Массовое редактирование

<figure><img src="/files/R0XJUVaLhFmmj04p66Ih" alt=""><figcaption><p>Пример массового редактирования почт</p></figcaption></figure>

**Что делает**\
Позволяет изменить свойства сразу у группы выбранных почтовых аккаунтов (имя, IMAP‑параметры, заметка).

**Как это сделать**

1. Отметьте те почты, которые хотите отредактировать.
2. Нажмите кнопку массового редактирования - <img src="/files/Lid4ZBEGamA6wCpYJ2H2" alt="" data-size="line">.
3. В открывшемся окне доступны поля:
   * **Имя** — задаёте новое имя; при множественном редактировании к названиям добавится порядковый номер (например, Имя1, Имя2…).
   * **IMAP** — выбираете, к какому провайдеру относится почта (gmail, outlook, firstmail и др.).
   * **Заметка** — можно **перезаписать** существующую заметку или **добавить к ней** текст.
4. Нажмите **Сохранить**.

**Особенности / советы**

* При режиме «перезаписать» старая заметка будет удалена, заменена новой.
* При добавлении — текст будет прикреплен к существующей заметке.
* Убедитесь, что все выбранные почты должны получить одинаковые настройки — иначе лучше редактировать по одной.

***

### 4. Редактирование одного аккаунта

<figure><img src="/files/bHXcI7RduEn4IigZJ5KU" alt=""><figcaption><p>Пример одиночного редактирования почты</p></figcaption></figure>

**Что делает**\
Позволяет изменить параметры конкретного почтового аккаунта вручную: имя, заметку и др.

**Как это сделать**

1. В таблице найдите нужную почту и нажмите значок редактирования - <img src="/files/468Q2ToahezPP695tKDq" alt="" data-size="original">.
2. В открывшемся окне можно изменить:
   * **Имя** — название почты
   * **Заметку** — произвольный текст, связанный с почтой
3. Нажмите **Сохранить**.

***

### 5. Присвоить Email к профилю

**Что делает**\
Связывает почтовый ящик с конкретным профилем для дальнейшего использования.

**Как выполнить**

* Указать профиль можно прямо при **импорте**
* либо через **редактирование** (одно/массовое) — поле **Profile**.

**Примечания**

* Без привязки к профилю будет статус **Warning** (неполная настройка).

***

### 6. Статусы

**Назначение**\
Отображение текущего состояния email-аккаунта.

<figure><img src="/files/xBcNvkp766PPHn1f9CQZ" alt=""><figcaption></figcaption></figure>

Доступные статусы:\
1\. Error - ошибка при подключении/аутентификации (наведите для деталей).\
2\. None - начальный статус, действий ещё не было.\
3\. Warning - не привязан к профилю или не заданы прокси в профиле.\
4\. Processing - идёт проверка/операция.\
5\. Ready - данные валидны, email готов к работе.

***

### 7. Проверка подключения почт

**Назначение**\
Убедиться, что логин/пароль и хосты корректны, и есть соединение.

<figure><img src="/files/22IpqO7It5kNJyJ4PHKU" alt=""><figcaption></figcaption></figure>

Чтобы проверить подключение почты по имап, необходимо выбрать аккаунты для проверки в таблице и после нажать на кнопку проверки <img src="/files/PKoo4ElUHoOJH3lNIpgB" alt="" data-size="original">, после надо дождать пока аккаунт не перейдет со статуса Processing в другой статус\
Если статус Error - надо навести на этот статус мышкой и высветится более подробная информация об ошибке\
Если статус Warning - надо подвязать почту к профилю или на профиль привязать прокси\
Если статус Ready - аккаунт смог успешно подключится и получать листы с почты

**Как выполнить**

1. Отметьте один или несколько email-аккаунтов.
2. Нажмите **Проверить -** <img src="/files/PKoo4ElUHoOJH3lNIpgB" alt="" data-size="original">.
3. Дождитесь результата: статус обновится автоматически.

**Что проверяется**

* Подключение к **IMAP** (логин/пароль/порт/SSL-режим).

**Примечания**

* При 2FA используйте **app password** — обычный пароль не подойдет.

***

### 8. Получение писем

<figure><img src="/files/BobPML1Iug694LitrKkZ" alt=""><figcaption></figcaption></figure>

Чтобы получить письма с почты необходимо выбрать желаемые почты в таблице и после нажать на кнопку получения писем - <img src="/files/TjJSspCzJp4pIJdi8Qtm" alt="" data-size="line">\
После все письма что есть на почте высветятся в суб-таблице, чтобы ее открыть нужно нажать на плюсик слева от каждого аккаунта, как показано на видео

**Что делает**\
Загружает письма из выбранных ящиков и показывает их в **суб-таблице** под каждой строкой.

**Как выполнить**

1. Отметьте почты, с которых хотите получить письма.
2. Нажмите кнопку **Получить письма** - <img src="/files/TjJSspCzJp4pIJdi8Qtm" alt="" data-size="line">.
3. После загрузки у каждой почты появится значок **плюс** слева — нажмите, чтобы открыть суб-таблицу с письмами.
4. Для обновления списка используйте **Refresh** (рядом со строкой почты).

**Примечания**

* В колонке **Last update** видно время последнего получения писем.
* Если письма не подтянулись — проверьте IMAP-доступ и повторите попытку.

***

### 9. Суб-таблица

#### 1. Чтение писем

* **Непрочитанные** — отображаются **белым** текстом.
* **Прочитанные** — отображаются **серым** текстом.\
  Открытие письма помечает его как прочитанное.

Письма можно отметить как прочитанные **массово** или **по одному**:

<figure><img src="/files/2nef5usYHUgqsixzdILn" alt=""><figcaption></figcaption></figure>

* Массово — отметьте письма галочками и нажмите **Прочитать** на верхней панели суб-таблицы.

<figure><img src="/files/TdRnkPujoh4wOFVydJFz" alt=""><figcaption></figcaption></figure>

* По одному — откройте письмо  - <img src="/files/3wWdgeJpnLiw2ZorNMnV" alt="" data-size="line">. После открытия письмо становится прочитанным.

#### 2. Удаление писем

Удаление происходит и в программе, и на самой почте.

<figure><img src="/files/2swnj7IF1wN4ced0uEMG" alt=""><figcaption></figcaption></figure>

* Массово — выберите письма галочками в суб-таблице и нажмите **Удалить** на верхней панели.

<figure><img src="/files/NdkJsK6FU19EbvLdEPBq" alt=""><figcaption></figcaption></figure>

* По одному — нажмите на иконку **корзины -** <img src="/files/8XQDJ7uuSP9YsVhHyzhq" alt="" data-size="line"> справа от конкретного письма

#### 3. Получить все письма на одном аккаунте

<figure><img src="/files/yIXMZUOYGWT6TGHmIRmA" alt=""><figcaption></figcaption></figure>

Кроме массового получения для нескольких почт, можно обновить письма **на одной конкретной почте** — нажмите **Refresh** в правом верхнем углу её суб-таблицы.

#### 4. Фильтрация данных

<figure><img src="/files/0IVQCCij4ATcmPpP5jGk" alt=""><figcaption></figcaption></figure>

Фильтровать письма можно по двум параметрам:

1. **По расположению:**
   * **Inbox** — все письма на почте
   * **Spam** — письма из спама
2. **По статусу:**
   * **All** — все письма
   * **Read** — прочитанные
   * **Unread** — непрочитанные

Оба параметра можно сочетать одновременно (например, *Inbox + Unread*).

#### 5. Поиск

<figure><img src="/files/UIZsF2SNwqsCb2BxcIER" alt=""><figcaption></figcaption></figure>

Введите текст в поле **поиска** — список отфильтруется по **отправителю** и/или **теме** письма.\
Так можно быстро найти нужное письмо по ключевому слову (например, сервис или код).

***

### 10. Колонки таблицы

<figure><img src="/files/CoE178m7X6QB1M8LMkDA" alt=""><figcaption></figcaption></figure>

**Что делает**\
Позволяет отображать или скрывать столбцы в таблице почт, чтобы видеть только нужные данные.

**Как это сделать**

1. Нажмите кнопку ![](/files/09u5c3J7olKa7LLeAea2).
2. В появившемся меню отметьте / снимите галочки напротив нужных столбцов.
3. Возможные колонки:
   * **ID** — уникальный индекс почты
   * **Profile** — профиль, к которому привязана почта
   * **Email** — адрес почты
   * **App password** — пароль приложения (для IMAP)
   * **Note** — заметка
   * **Name** — название почты
   * **Groups** — группы, в которых включена почта
   * **Password** — пароль почты
   * **2FA** — двухфакторная аутентификация

***

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

* Должен быть включён **IMAP**.
* Для Gmail/iCloud чаще требуется **App-Password**.
* Провайдеры ограничивают частоту подключений — воздержитесь от частых массовых операций.
* Письма с крупными вложениями загружаются дольше — дождитесь завершения.

**Прокси и подключение к почтам**\
Крупные прокси-сервисы часто блокируют подключение к почтам: их прокси активно используют для спама, из-за чего летят репорты и провайдеры режут доступ. Поэтому ваши прокси могут **не поддерживать IMAP** — в таком случае письма получать не получится.

**Список сервисов, которые не поддерживают подключение:**

* ProxyShard
* ProxyWing
* ProxySale
* ProxySeller

**Список сервисов, которые поддерживают подключение:**

* Proxys io
* ProxyLine
* Webshare


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://agent-x-1.gitbook.io/agent-x/profile-manager/email.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.