Почтовый ящик подключается к Gratio по IMAP и SMTP — как почтовая программа. Канал получает письма уведомлениями и даёт API со всем, что умеет почтовая программа: папки, поиск, ответы в цепочку, пересылка, черновики.
Подключение
В кабинете: карточка канала «Почта» → «Вход в ящик», введите адрес. Серверы почты Gratio находит сам.
| Почта | Как входим |
|---|---|
| Gmail и Google Workspace, Outlook и Microsoft 365, Яндекс и Яндекс 360, Mail и VK WorkMail | через сервис: «Войти через …» → страница сервиса → «Разрешить» → назад в кабинет. Пароль Gratio не видит |
| Остальные: Рамблер, iCloud, почта хостингов, своя почта | логин и пароль от ящика (обычно логин — это адрес) |
Если вход через сервис для этой почты пока недоступен, кабинет попросит пароль. Gmail в этом случае принимает только пароль приложения; iCloud и часть ящиков Яндекса и Mail тоже пускают почтовые программы только по отдельному паролю — его вводят в поле пароля.
Почта на своём сервере — укажите адреса IMAP и SMTP вручную: mail.example.ru:993 и starttls://mail.example.ru:587.
Подключить ящик можно и из своего приложения — методом connectMailbox: он вернёт ссылку на страницу входа или проверит пароль сразу.
Что важно знать
- Пароль и ключи хранятся только после успешной проверки IMAP и SMTP. Неверным паролем Gratio сервер почты не долбит: одна попытка — и отметка «вход отвергнут».
- Пароль сменили или доступ отозвали — приём останавливается, канал переходит в
notAuthorized. Новый вход в кабинете снимает отметку. Доступ, выданный через сервис, можно отозвать и в своём аккаунте почты. - Ящик ничего не теряет. Gratio читает письма, не помечая их прочитанными; меняет ящик только по явному вызову API: флаги, перенос, удаление, черновики, копия отправленного.
- Письма до подключения не приходят уведомлениями. Нужны старые — задайте
sinceпри подключении через API или читайте папки методамиgetMessagesиsearchMessages. - Приходят все письма. Рассылки, автоответы и уведомления сервисов помечены, но не отсеяны. Не нужны — включите
emailSkipBulk.
Адреса
| Что | Как |
|---|---|
chatId |
адрес собеседника в нижнем регистре: "maria@client.ru"; домен — юникодом: "info@пример.рф" |
| Письмо | folder + uid, или idMessage (20 hex-знаков от Message-ID), или messageId |
Цепочка писем — свойство письма (threadId), а чат — переписка с одним адресом. Подробно — Почта через API.
Пределы
Письмо — до 20 МБ, не больше 300 писем в сутки с ящика, пауза 2 секунды между письмами.
Чего у почты нет
checkAccount, editMessage, deleteMessage, реакции, группы, звонки, истории — 501. Удалить письмо в ящике — deleteMessages.
Проверить подключение
После привязки номера проверьте канал из своего приложения:
curl "$GRATIO_URL/waInstance$GRATIO_ID/getStateInstance/$GRATIO_TOKEN"
Ответ {"stateInstance": "authorized"} — канал работает. Что умеет канал — getCapabilities.
Что дальше
- Почта через API — как устроены методы ящика.
- Почтовый ящик в helpdesk — сценарий интеграции с полным кодом.