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

# Обзор триггера «При получении письма»

> Запускайте рабочий процесс при поступлении нового письма в отслеживаемый почтовый ящик

<Tip>Обратите внимание: все настройки триггера можно выполнить в ИИ-чате. Сообщите ИИ, что должен делать рабочий процесс, и он позаботится обо всём остальном.</Tip>

Этот триггер срабатывает, когда в отслеживаемый почтовый ящик поступает новое непрочитанное письмо.

## Создание с помощью ИИ

Откройте ИИ-чат на правой боковой панели Таблицы и опишите, что вам нужно.

ИИ сделает всё необходимое: выберет подходящий триггер, сопоставит нужные Поля и автоматически настроит все действия.

Достаточно один раз описать цель — и рабочий процесс будет готов без ручной настройки.

**Пример:** *"Когда я получаю письмо в службу поддержки, создай обращение и классифицируй его."*

## Конфигурация

| Настройка       | Обязательно | Описание                                                                |
| --------------- | ----------- | ----------------------------------------------------------------------- |
| Тип подключения | Да          | IMAP, Gmail или Outlook                                                 |
| Интервал опроса | Да          | Как часто проверять новые письма: от 10 до 60 минут (по умолчанию — 10) |

## Подробно о типах подключения

### IMAP

IMAP работает с любым почтовым провайдером, поддерживающим протокол IMAP, включая собственные почтовые серверы, корпоративную почту и таких провайдеров, как Yahoo или Zoho.

| Настройка        | Обязательно | Описание                                                                      |
| ---------------- | ----------- | ----------------------------------------------------------------------------- |
| Хост             | Да          | Адрес вашего IMAP-сервера (например, `imap.gmail.com`, `imap.mail.yahoo.com`) |
| Порт             | Да          | Обычно 993 (SSL/TLS) или 143 (без шифрования, не рекомендуется)               |
| Имя пользователя | Да          | Ваш адрес электронной почты или имя пользователя учётной записи               |
| Пароль           | Да          | Пароль приложения (обратите внимание: не пароль от электронной почты)         |
| Почтовый ящик    | Нет         | Отслеживаемая папка (по умолчанию — `INBOX`)                                  |

### Gmail (OAuth)

Подключение выполняется через OAuth-процесс Google. Пароль не требуется: вы разрешаете Teable доступ к своей учётной записи Gmail.

| Настройка             | Обязательно | Описание                                                              |
| --------------------- | ----------- | --------------------------------------------------------------------- |
| Учётная запись Google | Да          | Авторизация через OAuth — Teable запрашивает доступ только для чтения |
| Ярлык                 | Нет         | Выберите отслеживаемый ярлык Gmail (по умолчанию — «Входящие»)        |

### Outlook (OAuth)

Подключение к почтовым ящикам Outlook и Microsoft 365 выполняется через OAuth-процесс Microsoft.

| Настройка                | Обязательно | Описание                                                              |
| ------------------------ | ----------- | --------------------------------------------------------------------- |
| Учётная запись Microsoft | Да          | Авторизация через OAuth — Teable запрашивает доступ только для чтения |
| Папка                    | Нет         | Выберите отслеживаемую папку Outlook (по умолчанию — «Входящие»)      |

## Какие данные письма доступны следующим шагам

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

| Данные                 | Описание                                  |
| ---------------------- | ----------------------------------------- |
| **От кого**            | Адрес электронной почты отправителя       |
| **Тема**               | Строка темы письма                        |
| **Текст письма**       | Версия текста письма без форматирования   |
| **Тело письма (HTML)** | HTML-версия текста письма (если доступна) |
| **Дата**               | Время отправки письма                     |
| **Вложения**           | Файлы, прикреплённые к письму             |

Чтобы сослаться на любое из этих значений, нажмите **+** в Полях действия.

## Настройка на примере IMAP

1. Откройте Автоматизацию и добавьте новый триггер.
2. Выберите **При получении письма**.
3. В качестве типа подключения выберите **IMAP**.
4. Введите данные IMAP-сервера: хост, порт, имя пользователя и пароль.
5. При необходимости измените **Почтовый ящик**, если хотите отслеживать другую папку вместо INBOX.
6. Задайте **Интервал опроса** — частоту проверки новых писем. Чем короче интервал, тем быстрее реакция, но тем чаще выполняются обращения к серверу.
7. Нажмите **Тест**, чтобы проверить подключение. Teable попытается подключиться к почтовому ящику и сообщит об успехе или ошибке.
8. Сохраните и активируйте Автоматизацию.
9. Добавьте шаги действий, используя данные письма («От кого», «Тема», «Текст письма» и т. д.) в качестве переменных.

## Когда использовать

* **Создавать запись для каждого входящего обращения в службу поддержки.** Анализируйте тему и текст письма, чтобы автоматически заполнять Поля в Таблице обращений поддержки.
* **Извлекать данные счетов из писем с помощью ИИ.** Используйте действие «Генерация с помощью ИИ», чтобы прочитать текст письма или вложение и извлечь суммы, даты и названия поставщиков.
* **Направлять запросы клиентов нужной команде.** В зависимости от ключевых слов в теме или тексте обновляйте Поле «Команда» или отправляйте уведомления определённым людям.
* **Архивировать важные письма в виде записей.** Автоматически сохраняйте письма от определённых отправителей или с определёнными темами в Таблице Teable для удобного поиска и отслеживания.
* **Обрабатывать подтверждения заказов.** При поступлении письма с подтверждением заказа извлекайте его номер и сведения, чтобы обновить Таблицу заказов.

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

* **Не удалось подключиться (IMAP):** ещё раз проверьте хост, порт, имя пользователя и пароль. Убедитесь, что почтовый провайдер разрешает доступ по IMAP: некоторые провайдеры по умолчанию отключают его.
* **Gmail: ошибка «Небезопасное приложение»:** Gmail не разрешает вход с обычным паролем. Вместо него используйте **пароль приложения**. Инструкции см. в разделе [Настройка IMAP для Gmail](/ru/basic/automation/trigger/email/gmail-imap).
* **Письма не обрабатываются:** проверьте интервал опроса. Также убедитесь, что письма поступают в отслеживаемую папку или под отслеживаемый ярлык. Если выбран неверный почтовый ящик, письма во вложенных папках или с отфильтрованными ярлыками могут быть пропущены.
* **Повторная обработка:** триггер отслеживает, какие письма уже обработаны. Однако после деактивации и повторной активации Автоматизации он может заново обработать недавние письма. При необходимости отметьте письма во входящих как прочитанные.
* **Срок действия токена OAuth истёк:** если срок действия токена OAuth для Gmail или Outlook истёк, повторно авторизуйте подключение. Обычно это происходит через несколько месяцев или после отзыва разрешений Приложения.

## Советы

* Более короткий интервал опроса ускоряет реакцию на письма, но не гарантирует обработку в реальном времени. Если почтовый провайдер поддерживает вебхуки, используйте их для обработки в реальном времени.
* Настройте фильтры в почтовом клиенте, чтобы направлять нужные письма под определённый ярлык или в определённую папку, а затем отслеживайте в Teable только их. Это уменьшит лишний шум.
* Для почтовых ящиков с большим объёмом писем увеличьте интервал опроса и обрабатывайте письма пакетами, чтобы не перегружать рабочий процесс.

## Связанные разделы

* [Настройка IMAP для Gmail](/ru/basic/automation/trigger/email/gmail-imap) — подробные инструкции по подключению Gmail
* [Действие «Генерация с помощью ИИ»](/ru/basic/automation/actions/ai/ai-generate) — полезно для извлечения структурированных данных из содержимого писем
* [Действие «Создать запись»](/ru/basic/automation/actions/records/create-record) — часто используется вместе с почтовыми триггерами для сохранения писем в виде записей
* [Отправить письмо](/ru/basic/automation/actions/communication/send-email-overview)
