Почта

Об инструменте

Инструмент Почта позволяет агенту отправлять электронные письма — одному получателю или сразу нескольким. Поддерживаются копии (CC), скрытые копии (BCC), вложения и преобразование текста из Markdown в оформленный HTML. Письма отправляются через протокол SMTP от имени подключённого почтового ящика.

Настройка

1. Авторизация в Evo

На платформе откройте: Инструменты > Почта > Конфигурация авторизации ключа API и заполните поля в зависимости от того почтового сервиса, который планируете использовать.

  • Mail.ru — метод шифрования SSL, SMTP-сервер smtp.mail.ru, порт 465. Создайте пароль приложения в настройках безопасности аккаунта. Как это сделать, а также данные сервера — в инструкции от Mail.ru.

  • Яндекс — метод шифрования SSL, SMTP-сервер smtp.yandex.ru, порт 465. Сначала включите доступ по протоколу IMAP в настройках почты, затем создайте пароль приложения. Как включить доступ и где создать пароль — в инструкции от Яндекса.

  • Gmail — метод шифрования STARTTLS, SMTP-сервер smtp.gmail.com, порт 587. Сначала включите двухфакторную аутентификацию (без неё пароль приложения создать нельзя) по инструкции от Google, затем сгенерируйте пароль приложения. Как создать пароль приложения — в инструкции от Google.

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

  • Microsoft Exchange — метод шифрования STARTTLS, порт 587, SMTP-сервер — полное имя почтового сервера вашей компании, например mail.company.ru. Пароль приложения создавать не нужно, подойдёт обычный пароль от учётной записи. Адрес сервера, учётные данные и разрешение на отправку выдаёт администратор почты вашей компании — если подключение не проходит, обращайтесь к нему. Подробнее — в инструкции от Microsoft.

Личные ящики Microsoft на outlook.com и hotmail.com подключить нельзя: Microsoft не разрешает для них отправку по логину и паролю.

Пример заполнения формы

Поле в Evo

Что вписать

Имя авторизации

Произвольный текст, например «Рабочая почта»

Электронная почта

Полный адрес почты (логин)

Пароль для внешнего приложения

Пароль приложения, а не пароль от почты. Обычно создаётся в разделе безопасности аккаунта

Метод шифрования

Выбирается переключателем: «Без шифрования», SSL или STARTTLS. Для Mail.ru — SSL

Порт SMTP-сервера

Выбирается в соответствии с методом шифрования. Для Mail.ru — 465

SMTP-сервер

Указывается в почтовом сервисе. Для Mail.ru — smtp.mail.ru

Адрес отправителя

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

2. Использование инструмента

Добавьте инструмент Почта агенту. Сформулируйте задачу (например: «Напиши письмо…») и укажите обязательные поля: получатель, тема, текст.

3. Расширенные возможности

  • Копии (CC и BCC). Можно добавить получателей в копию (CC) и скрытую копию (BCC). Адреса задаются списком.

  • Адрес для ответа (Reply-to). Адрес, на который уйдёт ответ, если получатель нажмёт «Ответить»; может отличаться от почты-отправителя.

  • Вложения. К письму можно прикрепить файлы — они уйдут вместе с письмом.

  • Преобразование Markdown в HTML. Включите опцию, чтобы текст письма из Markdown превратился в оформленный HTML и письмо выглядело аккуратно. Поддерживается: форматирование (жирный, курсив, заголовки), ссылки и инлайн-код, таблицы, встроенные в тело письма картинки.

4. Подключение нескольких ящиков

К инструменту Почта можно подключить несколько почтовых ящиков: например, общий ящик отдела и личный ящик руководителя. Ящики подключаются отдельно — в разделе Инструменты или в настройках агента при добавлении инструмента Почта. Для каждого подключения нужно указать своё имя авторизации. Два одинаковых имени платформа не примет.

Почтовый ящик по умолчанию. Одна из авторизаций отмечена как «по умолчанию». Она используется, если в настройках агента почтовый ящик не выбран вручную. Чтобы назначить другую авторизацию по умолчанию, перейдите в раздел Инструменты вкладка→ Встроенные → Почта и нажмите Установить по умолчанию.

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

Если выбран вариант Рабочее пространство по умолчанию, агент не привязывается к конкретному ящику и использует авторизацию, которая назначена по умолчанию для рабочего пространства.

Изменение и удаление. Добавить или изменить авторизацию можно в разделе Инструменты и в настройках агента.

Удалить авторизацию, которая используется хотя бы одним агентом, нельзя — платформа покажет список таких агентов. Чтобы её удалить:

  1. Откройте каждого агента из списка и удалите инструмент «Почта» из его настроек.

  2. Вернитесь в раздел Инструменты → Встроенные → Почта и удалите авторизацию в карточке.

Если авторизация не используется ни одним агентом, она удаляется сразу после подтверждения. Чтобы отключить почту только для одного агента, достаточно удалить инструмент «Почта» из его настроек — авторизация останется.

Частые ошибки подключения

  • Использован обычный пароль от почты вместо пароля приложения — авторизация не проходит.

  • Метод шифрования не совпадает с портом (SSL на 587 или STARTTLS на 465) — соединение зависает / таймаут.

  • Для Gmail не включена двухфакторная аутентификация — пароль приложения создать нельзя.