Подключить 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 Lines | email-канал в 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 сек).