# Gmail

Разбирайте входящие Gmail, не открывая почтовый ящик

Почта Gmail и Google Workspace по паролю приложения: письма, папки, отправка и пересылка

## Как агент работает с Gmail

Агент подключается к ящику Gmail по IMAP и SMTP. Сначала он читает список папок, а дальше работает с самими письмами: темой, отправителем, датой, текстом и вложениями. Он находит письмо по отправителю или теме и открывает вложенный счёт, акт или договор, чтобы разобрать содержимое, а не пересказать имя файла.

Подключается не пароль от аккаунта Google, а пароль приложения из 16 символов. Его создают на странице «Пароли приложений» после включения двухэтапной проверки. Одна пара адреса и пароля обслуживает и чтение, и отправку. Отзывается доступ удалением этого пароля, без смены основного.

Папки Gmail это ярлыки: одно письмо может лежать под несколькими, а названия служебных папок зависят от языка аккаунта. Поэтому агент берёт имена папок из самого ящика, а не угадывает их. Удалённое письмо уходит в корзину Gmail, а отправленное Gmail сам сохраняет в «Отправленных».

У отправки есть суточные лимиты Google: около 500 получателей в сутки у личного аккаунта и до 2000 писем у Google Workspace, письмо не тяжелее 25 МБ. Агент планирует рассылку с их учётом и прямо говорит, если ящик или письмо уперлись в ограничение.

## Сценарии интеграции

### Утренний разбор входящих
Агент пройдёт по непрочитанным письмам и покажет, какие ждут ответа, с темой, отправителем и датой, не открывая Gmail.

### Счета и договоры из вложений
Агент найдёт письмо по отправителю или теме, скачает вложение (счёт, акт или договор) и разберёт, что в нём написано.

### Ответ в переписку
Агент напишет ответ в нужную ветку, перешлёт письмо коллеге или отправит новое письмо с вашего адреса Gmail.

### Порядок в ярлыках
Агент разложит письма по ярлыкам, отметит разобранные прочитанными и уберёт лишнее в корзину.

### История переписки с клиентом
Агент соберёт письма с одним адресатом за период, выстроит их по датам и покажет, о чём договорились и что осталось без ответа.

### Кто наполняет ящик
Агент посчитает письма за месяц по отправителям и покажет, кто пишет чаще всего и сколько из этого так и не открыто.

## Как подключить

**Перед подключением**

- Полный адрес Gmail или Google Workspace и включённая двухэтапная проверка.
- Агент читает все папки ящика и отправляет письма от вашего имени.

### Включите двухэтапную проверку
В аккаунте Google, который подключаете, откройте «Безопасность» и включите двухэтапную проверку. Без неё пароли приложений недоступны.

### Откройте «Пароли приложений»
Перейдите на myaccount.google.com/apppasswords, введите любое название и нажмите «Создать». Google покажет пароль из 16 символов один раз.

### Вставьте пароль с полным адресом
Скопируйте пароль в подключение вместе с полным адресом ящика. Основной пароль аккаунта Google здесь не подходит.

### Google Workspace: спросите администратора
В аккаунте Google Workspace пароли приложений может запретить администратор. Если страница их не предлагает, попросите его разрешить.

## Частые вопросы

### Как подключить Gmail?
Адресом ящика и паролем приложения. Включите двухэтапную проверку в аккаунте Google, откройте myaccount.google.com/apppasswords, создайте пароль и вставьте его в подключение.

### Почему не подходит обычный пароль от Google?
Google не пускает почтовые программы по основному паролю. Для них нужен отдельный пароль приложения из 16 символов, который можно удалить в любой момент.

### Что делать, если страница паролей приложений не открывается?
Проверьте, что двухэтапная проверка включена. В аккаунте Google Workspace пароли приложений может запретить администратор, тогда их включает он.

### Сколько писем агент может отправить?
Столько, сколько разрешает Google: около 500 получателей в сутки у личного аккаунта, до 2000 писем в сутки и 100 получателей на письмо у Google Workspace, письмо до 25 МБ.

[Открыть Gmail](https://myaccount.google.com/apppasswords)