Подключение почты (Email)

Как подключить рабочий почтовый ящик к AISAR: где взять пароль приложения в Gmail, Яндексе и Mail.ru, как пройти мастер подключения, как отвечать на письма из чата и что делать, если проверка ящика не проходит.

Что даёт канал

Вы подключаете ящик, на который пишут клиенты, например zakaz@ или info@. Письма из папки «Входящие» появляются в общем чате рядом с WhatsApp и Telegram, а сотрудники отвечают прямо из чата: ответ уходит клиенту обычным письмом в ту же цепочку, с подписью компании.

Канал входит в лимит каналов вашего тарифа, отдельной платы за него нет. Состав тарифов и актуальные условия — на aisar.app.

Что понадобится

Роль в AISAR с правом подключать каналы (обычно администратор компании).
Адрес ящика и пароль приложения для Gmail, Яндекса или Mail.ru. Обычный пароль от аккаунта эти сервисы для сторонних программ не принимают.
Для почты на своём домене или у хостинга: адреса серверов входящей (IMAP) и исходящей (SMTP) почты, порты и пароль ящика.

Шаг 1. Получите пароль приложения

Пароль приложения — отдельный пароль, который сервис выдаёт для одной программы. Его можно отозвать, не меняя пароль от аккаунта. Сервис показывает такой пароль один раз, поэтому скопируйте его сразу целиком.

Gmail и Google Workspace

Включите двухэтапную аутентификацию: аккаунт Google, раздел «Безопасность», пункт «Двухэтапная аутентификация». Без неё пароли приложений недоступны.
Откройте страницу «Пароли приложений» (myaccount.google.com/apppasswords), введите название, например «AISAR», и нажмите «Создать».
Скопируйте пароль из 16 букв.

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

Яндекс 360

В почте откройте «Все настройки», затем «Почтовые программы». Включите доступ с сервера imap.yandex.ru по протоколу IMAP, способ входа — «Пароли приложений и OAuth-токены».
В Яндекс ID откройте «Безопасность», затем «Пароли приложений», создайте пароль с типом «Почта» и названием «AISAR».
Скопируйте пароль.

Без включённого доступа по IMAP проверка не пройдёт, даже если пароль верный.

Mail.ru

В почте откройте «Настройки», затем «Безопасность», раздел «Пароли для внешних приложений», и нажмите «Добавить».
Укажите название, например «AISAR», и разрешите доступ к почте.
Скопируйте пароль. Обычный пароль от почты не подойдёт.

Почта на своём домене или у хостинга

Адреса серверов и порты даёт хостинг: обычно они есть в разделе «Почта» панели управления или в письме о создании ящика.
Нужны два сервера: входящей почты (IMAP) и исходящей (SMTP). Часто это одно имя, например mail.вашдомен.kz.
Порты: IMAP 993 (SSL) или 143 (STARTTLS); SMTP 465 (SSL) или 587 (STARTTLS). Пароль обычно тот же, что для входа в веб-почту хостинга.

Соединение без шифрования и самоподписанные сертификаты не поддерживаются. Укажите имя сервера из настроек хостинга, а не IP-адрес: сертификат выдан на имя.

Шаг 2. Мастер подключения

В кабинете откройте Настройки → Каналы → Подключить → Почта. Мастер состоит из пяти шагов.

Обзор. Коротко о том, как работает канал, и что стоит знать заранее (ограничения описаны ниже).
Почтовый сервис. Выберите, где живёт ящик: Gmail и Google Workspace, Яндекс 360, Mail.ru или «Свой сервер». Если адрес на домене компании, а почту держит Google или Яндекс, выберите их. Для первых трёх серверы подставятся сами. Microsoft 365 и Outlook.com пока недоступны: мастер сообщит, что подключение появится позже.
Ящик и проверка. Введите адрес, пароль приложения (для своего сервера ещё серверы, порты и при необходимости логин, если он отличается от адреса) и необязательное имя отправителя: так клиент увидит вас в своей почте. Нажмите «Проверить подключение». AISAR войдёт в ящик и на сервер отправки, откроет «Входящие» и найдёт папку «Отправленные». Результат показан отдельно по получению писем (IMAP) и по отправке (SMTP). Тестовое письмо не отправляется, пароль до подключения не сохраняется. Обычно проверка занимает до 20 секунд.
Параметры. Подпись (простой текст, до 2000 символов, добавляется в конец каждого ответа); «Сохранять копию ответа в «Отправленные»» (для Gmail не нужно: он сохраняет сам, для Яндекса, Mail.ru и своего сервера лучше включить); «Письма, которые уже лежат в ящике»: загрузить только новые, письма за 3 дня или за 7 дней. Старые письма попадают в чат как история: ИИ-агент, автоматизации и уведомления на них не сработают. Всё это можно поменять позже на странице канала.
Готово. Мастер показывает итог: с какого адреса уходят ответы, загружались ли старые письма и кто видит письма. Первые письма появятся в чате в течение нескольких минут.

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

Как письма выглядят в чате

Каждое письмо — сообщение с темой, отправителем и адресатами (кому, копия). Длинная цитата предыдущих писем свёрнута, её можно показать кнопкой «Показать цитату». Письмо целиком открывается в изолированном просмотре кнопкой «Открыть письмо целиком».
Картинки из интернета в письме по умолчанию скрыты: по ним отправитель может узнать, что письмо открыли. Кнопка «Показать изображения» загружает их через AISAR, отправитель при этом не видит ваш адрес.
Рассылки, автоответы и автоматические письма помечены (бейджи «Рассылка», «Автоответ», «Автоматическое письмо»). Если почтовый сервер не подтвердил отправителя, письмо помечено «Отправитель не подтверждён»: прежде чем платить или менять реквизиты, уточните у клиента другим способом. На такие письма, на автоответы и рассылки ИИ-агент и автоматизации не отвечают.
Вложения доступны для скачивания; потенциально опасные файлы AISAR помечает и просит подтвердить скачивание. Письмо больше 25 МБ AISAR не загружает: в чате будет заглушка с просьбой открыть его в почтовом ящике.

Ответ на письмо

Напишите ответ в поле ввода, как в любом другом канале. Тема подставляется автоматически: «Re: …» и тема исходного письма, ответ уходит в ту же цепочку.
Ответ уходит только отправителю. Адреса из копии (Cc) в исходном письме видны, но в ответ не добавляются. Кнопки «Ответить всем» нет.
К ответу добавляется подпись ящика, а если в настройках канала включено «Цитировать письмо клиента в ответе», то и цитата его письма.

Первое письмо контакту

Чтобы написать первым, откройте диалог контакта, у которого в карточке записан адрес почты (если адреса нет, чат предложит открыть карточку и добавить его). В поле «Куда отправить» выберите почтовый канал и адрес получателя. Для первого письма тема обязательна: без неё письмо не отправить. К письму добавится подпись ящика.

Вкладка «Почта» на странице канала

Откройте Настройки → Каналы, выберите почтовый канал и перейдите на вкладку «Почта».

Подключение и проверка ящика. Адрес, логин, серверы; статус проверки («Работает», «Проверка идёт с задержкой», «Остановлена», «Нет связи с сервером»), время последней проверки и последней успешной.
Интервал проверки. «Проверять ящик каждые» несколько минут; изменение применяется со следующей проверки.
Входящие письма. Тумблеры «Пропускать рассылки» (письма с пометкой рассылки не попадут в чат) и «Не показывать автоответы» (если выключено, автоответы вроде «я в отпуске» попадут в чат с пометкой).
Отправка. Имя отправителя, подпись, «Цитировать письмо клиента в ответе», «Сохранять копию ответа в «Отправленные»».
«Обновить пароль». Здесь же меняются логин и серверы (кнопка «Изменить серверы или логин»). AISAR сначала проверяет вход с новым паролем и заменяет прежний только после успешной проверки; адрес ящика изменить нельзя.

Если пароль приложения отозвали или вы сменили пароль аккаунта, канал получит статус «Истёк», проверка остановится, а в чате у неотправленных писем появится подсказка. Создайте новый пароль приложения и введите его через «Обновить пароль»: письма, пришедшие за это время, подтянутся.

Ограничения

Ящики Microsoft 365 и Outlook.com пока подключить нельзя: Microsoft отключила вход по паролю, а вход через учётную запись Microsoft появится позже. Если у компании есть другой ящик, например на Gmail или у хостинга, подключите его.
Новые письма приходят не мгновенно: ящик проверяется раз в 2–3 минуты (Gmail и своя почта по умолчанию раз в 2 минуты, Яндекс и Mail.ru раз в 3 минуты).
AISAR читает только папку «Входящие». Отметка «прочитано» в ящике не меняется, а прочитанные письма и письма, отправленные из самой почтовой программы мимо AISAR, в чат не попадают.
Это не почтовая программа: папки, черновики и поиск по ящику остаются в почте.
«Ответить всем» нет: ответ уходит только отправителю.
Письма и вложения до 25 МБ. Из одного письма загружается до 50 вложений, остальные остаются в ящике.
Email не используется для рассылок: канал создан для переписки с клиентами, а не для массовой отправки.
Если к каналу подключён ИИ-агент, его ответы уходят письмом с адреса компании и влияют на репутацию ящика у почтовых сервисов. Каждое такое письмо помечено как автоматическое.

Частые ошибки

Если проверка ящика не прошла, мастер показывает код ошибки и подсказку. Коды одинаковы в мастере, на странице канала и в API.

Код	Что значит и что делать
`email_auth_failed`	Почтовый сервер не принял пароль. Чаще всего введён обычный пароль вместо пароля приложения, пароль скопирован не целиком, пароль приложения отозван, либо в настройках почты выключен доступ по IMAP (особенно в Яндексе). Создайте новый пароль приложения, проверьте, что IMAP включён, и скопируйте пароль заново. Если логин отличается от адреса, впишите его в поле «Логин». Если проверка падает снова и снова, после серии ошибок она временно блокируется (см. `email_test_rate_limited`).
`email_tls_failed`	Не удалось установить защищённое соединение: сертификат сервера выдан на другое имя, самоподписанный или сервер не поддерживает шифрование на выбранном порту. Укажите имя сервера из настроек хостинга (например mail.company.kz), а не IP-адрес, и проверьте пару порт и шифрование (993 и 465 это SSL, 143 и 587 это STARTTLS).
`email_host_blocked`	Адрес сервера недопустим: AISAR подключается только к почтовым серверам в интернете. Адреса локальной или внутренней сети и служебные адреса не принимаются. Проверьте имя сервера.
`email_timeout`	Сервер не ответил вовремя. Повторите проверку через минуту. Если повторяется, проверьте имя сервера и порт, а также что хостинг не закрывает порты для внешних подключений.
`email_provider_requires_oauth`	Это ящик Microsoft 365 или Outlook.com: он не подключается по паролю. Подключение через вход в учётную запись Microsoft появится позже. Пока подключите другой ящик.
`email_test_rate_limited`	Слишком много неудачных проверок для этого ящика. Проверка снова станет доступна позже (обычно через час), ответ API содержит заголовок `Retry-After`. Чтобы не тратить попытки, создайте новый пароль приложения и скопируйте его целиком: частые ошибки почтовый сервис принимает за подбор пароля.

Реже встречаются email_dns_failed (имя сервера не найдено, проверьте написание), email_host_unreachable (сервер не отвечает на этом порту, возможно, хостинг открывает только 465 для отправки и 993 для приёма), email_port_not_allowed (подойдут IMAP 993 или 143 и SMTP 465 или 587), email_folder_not_found (не удалось открыть «Входящие», проверьте, что IMAP включён) и email_protocol_error (сервер ответил не так, как ожидается от почтового сервера, проверьте адрес и порт). Повторное подключение этого же ящика отвечает ошибкой mailbox_already_connected: откройте существующий канал.

Смотрите также

Обзор возможностей канала — на странице aisar.app/ru/integrations/email. Отправка писем и остальные операции по API описаны в разделах REST «Каналы», «Сообщения» и «Диалоги».