AGONTS
Руководство пользователя

Подключить email

AI-сотрудник в корпоративной почте. Сейчас доступна отправка писем как инструмент агента; приём входящих писем — в разработке.

Email — один из главных каналов в B2B. В AGONTS работа с почтой разбита на две независимые возможности: AI отправляет письма как инструмент (готово), и AI принимает письма как канал (в разработке).

Что готово сейчас

Отправка писем как инструмент агента. Подключение Email (отправка) в Подключения → Инструменты — AI-сотрудник может слать подтверждения, уведомления и follow-up в рамках диалога. Шаблоны и адресаты настраиваются в карточке инструмента.

Что в разработке

Приём входящих писем как канал. Полноценный inbound через IMAP / SMTP / провайдера с превращением каждого письма в диалог пока не доступен в self-service. Описанный ниже UX — целевой. До запуска тикеты подключаем через CRM или тикет-систему (Bitrix24 / Okdesk / HelpDesk) — там приём писем уже работает.

Как работает email-канал

Вы выделяете адрес — например help@yourcompany.ru или support@yourcompany.ru. AG0NTS подключается к ящику по IMAP (приём писем) и SMTP (отправка ответов). Каждое входящее письмо превращается в диалог, AI-сотрудник отвечает в стиле email (с приветствием, подписью), ответ уходит обратно клиенту.

Если вы используете тикет-систему (HelpDesk, Okdesk, Bitrix24), AG0NTS подключается к ней и работает поверх тикетов.

Три способа подключить

Способ 1. Выделенный ящик через IMAP/SMTP

Самый универсальный путь. Работает с любым email-провайдером: Яндекс 360, Mail.ru, Google Workspace, Microsoft 365, корпоративный Exchange.

Плюсы: полная свобода, любая почта.
Минусы: нужны логин/пароль ящика или app password.
Рекомендуем для: малого бизнеса, первого запуска.

Способ 2. Алиас на существующую почту

Если у вас уже работает info@yourcompany.ru, но вы хотите, чтобы часть писем обрабатывалась ботом, — создайте алиас ai@yourcompany.ru или bot@yourcompany.ru, и перенаправляйте на него письма по правилу («если в теме слово "вопрос"» и т.п.).

Плюсы: основная почта не трогается.
Минусы: нужно настраивать правила форвардинга.
Рекомендуем для: компаний с устоявшимся email-процессом.

Способ 3. Интеграция с тикет-системой

Если клиенты пишут через форму на сайте, которая создаёт тикет в HelpDesk / Okdesk / Zendesk / Bitrix24, AG0NTS подключается к API тикет-системы и работает как ещё один «оператор». Бот берёт тикет из очереди, отвечает комментарием в тикете, или закрывает, если вопрос решён.

Плюсы: сохраняется привычный процесс, аналитика.
Минусы: нужна интеграция с API тикет-системы.
Рекомендуем для: средних и крупных компаний.

Путь 1. Подключение через IMAP/SMTP

Создайте выделенный ящик у вашего провайдера

Например, support@yourcompany.ru в Яндекс 360, или help@yourcompany.ru в Google Workspace. Нужна корпоративная почта, не личная @gmail.com.

Получите данные доступа

Для Яндекс 360 и Google Workspace нужен app password (пароль приложения), а не обычный пароль аккаунта. Обычный пароль не сработает, т.к. Google и Яндекс требуют 2FA для сторонних клиентов.

  • Яндекс 360: Настройки → Безопасность → Пароли приложений → Создать
  • Google Workspace: myaccount.google.com → Security → 2-Step Verification → App passwords
  • Mail.ru Бизнес: Настройки → Пароли для внешних приложений

Сохраните пароль — он показывается один раз.

Откройте AG0NTS: Каналы → Email → Добавить

Выберите «IMAP/SMTP» как тип подключения.

Заполните параметры

  • Адрес ящика: support@yourcompany.ru
  • Пароль: app password из предыдущего шага
  • IMAP-сервер: AG0NTS подставит автоматически по домену (например imap.yandex.ru:993 для Яндекса)
  • SMTP-сервер: аналогично (smtp.yandex.ru:465)
  • Шифрование: SSL/TLS — оставьте по умолчанию

Нажмите «Проверить соединение». Увидите «Активно» — значит, AG0NTS успешно вошёл в ящик.

Выберите AI-сотрудника

Какой бот будет отвечать на письма. Обычно тот же, что работает в Telegram или на сайте.

Настройте подпись и тон

Email-ответы отличаются от чата: нужно приветствие («Здравствуйте!»), завершение («С уважением, …»), подпись. AG0NTS автоматически добавляет это, но вы можете задать свой шаблон подписи:

---
С уважением,
Команда поддержки
Компания YYY
support@yourcompany.ru | +7 (xxx) xxx-xx-xx
yourcompany.ru

Запустите

Отправьте тестовое письмо на support@yourcompany.ru с другого почтового ящика. AG0NTS обработает и ответит за 15–60 секунд.

Сколько времени на ответ

В email клиенты не ждут мгновенного ответа, как в чате. AG0NTS обычно отвечает за 30–90 секунд, но может и подождать — например, если вы хотите, чтобы ответы уходили «пачкой» раз в 15 минут для более человечного ощущения. Настраивается в Каналы → Email → Поведение → Задержка ответа.

Путь 2. Алиас с форвардингом

Удобен, когда у вас уже настроен info@yourcompany.ru и вы не хотите там ничего трогать.

Создайте алиас ai@yourcompany.ru

В панели вашего провайдера почты — как новый ящик или как forwarding alias. У Яндекс 360 это делается в «Сотрудники → Почтовые алиасы».

Подключите алиас в AG0NTS

Как в Пути 1 — данные IMAP/SMTP для ai@yourcompany.ru.

Настройте правила форвардинга

В основном ящике info@yourcompany.ru создайте правило: «если письмо содержит [условие] → переслать на ai@yourcompany.ru».

Примеры условий:

  • От незнакомого отправителя (новый клиент)
  • В теме слова «вопрос», «consultation», «как»
  • От адреса form@yourcompany.ru (все заявки с сайта)

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

Путь 3. Интеграция с тикет-системой

Типовой сценарий — у вас уже работает HelpDesk/Okdesk/Zendesk, клиенты пишут через web-форму, письма превращаются в тикеты. Вы хотите, чтобы AG0NTS подключался как ещё один оператор и брал тикеты из очереди.

Поддерживаемые системы (из коробки)

СистемаЧто умеет бот
Okdeskвзять тикет, ответить комментарием, закрыть, эскалировать
HelpDesk.ruто же + автоматическое категоризирование
Bitrix24 Open Linesemail-канал в bx24 подключается напрямую
Zendeskвзять тикет, ответить, triage по тэгам
Jira Service Managementработа с тикетами, SLA-компонент

Шаги подключения Okdesk (пример)

Получите API-ключ в Okdesk

Okdesk → Настройки → Интеграции → API → Создать токен. Права: read + write тикеты, read users.

Подключите в AG0NTS

Каналы → Email → Добавить → Okdesk. Укажите:

  • Адрес инстанса Okdesk (https://yourcompany.okdesk.ru)
  • API token

Нажмите «Проверить» — должно показать «Активно, найдено N открытых тикетов».

Настройте правила: какие тикеты брать

  • Категории: «Общие вопросы», «Биллинг», «Как сделать…» — эти возьмёт бот.
  • Приоритет: обычный и низкий — бот. Высокий и критичный — только люди.
  • Автор: любой внешний клиент. Внутренние тикеты не трогать.

Бот отвечает

AG0NTS каждые 30–60 сек пулит очередь, берёт подходящие тикеты, отвечает комментарием. Если вопрос выходит за рамки — возвращает тикет в общую очередь с пометкой «AI не справился, требуется оператор».

Формат ответов

Email — не чат. Хорошие ответы бота выглядят так:

Здравствуйте, Иван!

Спасибо за обращение. Отвечаю на ваш вопрос про возврат товара.

По правилам нашего магазина вы можете вернуть товар в течение 14 дней
после получения, если он не был в употреблении и сохранена упаковка.
Подробнее — в разделе «Возвраты» на нашем сайте: yoursite.ru/returns

Если товар уже был использован или повреждён, напишите мне детали —
я передам вопрос менеджеру, она свяжется с вами в течение рабочего дня.

---
С уважением,
Анна, консультант поддержки
Компания YYY
support@yourcompany.ru

Плохо:

да, в течение 14 дней можно вернуть

Настройка тона — в профиле AI-сотрудника. Обычно достаточно указать «деловой, развёрнутый, с обращением по имени», и AG0NTS пишет в нужном стиле.

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

AUTH LOGIN failed для Яндекс / Google

99% причин — обычный пароль вместо app password. 2FA блокирует IMAP/SMTP для сторонних клиентов. Сгенерируйте app password заново.

Письма приходят, но AG0NTS их не видит

Проверьте, не настроены ли в ящике правила «архивировать входящие автоматически» — AG0NTS читает папку INBOX, а не Архив. Также: проверьте, что у app password есть право на IMAP (в Яндексе есть галочка «включить IMAP»).

Ответы бота уходят клиенту, но не видны в отправленных

Некоторые провайдеры не сохраняют в «Отправленные» письма, посланные через SMTP. Это нормально. Смотрите логи в AG0NTS → Каналы → Email → История.

Клиент пишет на support@, ответ приходит с noreply@agonts.xyz

Не настроен SMTP-сервер в AG0NTS — или настроен неправильно. Проверьте SMTP-настройки в Каналы → Email → Параметры. Если ответ должен приходить от вашего домена, нужно подключить SMTP именно вашей почты.

Бот отвечает медленно (больше 5 минут)

Проверьте период опроса IMAP. По умолчанию — 60 сек, при необходимости уменьшите до 15 сек. Учтите: частый пуллинг может упереться в лимиты провайдера (Gmail — 1 запрос в 10 сек).

Что дальше

On this page

Как работает email-каналТри способа подключитьСпособ 1. Выделенный ящик через IMAP/SMTPСпособ 2. Алиас на существующую почтуСпособ 3. Интеграция с тикет-системойПуть 1. Подключение через IMAP/SMTPСоздайте выделенный ящик у вашего провайдераПолучите данные доступаОткройте AG0NTS: Каналы → Email → ДобавитьЗаполните параметрыВыберите AI-сотрудникаНастройте подпись и тонЗапуститеПуть 2. Алиас с форвардингомСоздайте алиас ai@yourcompany.ruПодключите алиас в AG0NTSНастройте правила форвардингаПуть 3. Интеграция с тикет-системойПоддерживаемые системы (из коробки)Шаги подключения Okdesk (пример)Получите API-ключ в OkdeskПодключите в AG0NTSНастройте правила: какие тикеты братьБот отвечаетФормат ответовЧастые ошибкиAUTH LOGIN failed для Яндекс / GoogleПисьма приходят, но AG0NTS их не видитОтветы бота уходят клиенту, но не видны в отправленныхКлиент пишет на support@, ответ приходит с noreply@agonts.xyzБот отвечает медленно (больше 5 минут)Что дальше