Почта

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

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

Настройка

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

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

• Mail.ru

  • Отправка: SMTP-сервер smtp.mail.ru, порт 465, шифрование SSL.

  • Чтение: IMAP-сервер imap.mail.ru, порт 993, шифрование SSL.

  • Обычный пароль от ящика не подойдёт — нужен пароль приложения. Как его создать в настройках безопасности Mail.ru, а также данные серверов — в инструкции от Mail.ru.

• Яндекс

  • Отправка: SMTP-сервер smtp.yandex.ru, порт 465, шифрование SSL.

  • Чтение: IMAP-сервер imap.yandex.ru, порт 993, шифрование SSL.

  • Сначала включите доступ по протоколу IMAP в настройках почты — он нужен и для отправки, и для чтения. Затем создайте пароль приложения. Как включить доступ и где создать пароль — в инструкции от Яндекса.

• Gmail

  • Отправка: SMTP-сервер smtp.gmail.com, порт 587, шифрование STARTTLS.

  • Чтение: IMAP-сервер imap.gmail.com, порт 993, шифрование SSL (настройки серверов от Google).

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

• Microsoft Exchange

  • Отправка: SMTP-сервер — полное имя почтового сервера вашей компании, например mail.company.ru; порт 587, шифрование STARTTLS.

  • Чтение: IMAP-сервер — обычно то же имя, что и у SMTP-сервера, точный адрес нужно уточнить у администратора; порт 993, шифрование SSL. Если администратор настроил чтение на порту 143, выберите шифрование STARTTLS.

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

  • Доступ по IMAP по умолчанию выключен — его включает администратор почты вашей компании. Он же выдаёт адрес сервера, учётные данные и разрешение на отправку. Если подключение не проходит, обращайтесь к нему. Подробнее — в инструкции от Microsoft.

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

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

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

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

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

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

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

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

4. Чтение входящих писем

Попросите агента показать письма — например, «Покажи непрочитанные письма за сегодня» или «Какие письма пришли от Иванова на прошлой неделе?». Агент вернёт список: отправитель, тема, дата, прочитано письмо или нет. Затем попросите прочитать нужное — «Прочитай второе письмо», — и агент покажет его текст.

Вложения. Открыв письмо, агент видит список вложений: название, тип и размер. Попросите разобрать вложение — например, «Проверь договор из этого письма» или «Возьми все файлы из письма», — агент получит файлы и поработает с ними так же, как с файлами, приложенными в чат: прочитает, сверит, передаст другому инструменту.

Агент не получает:

• исполняемые файлы;

• служебные файлы Outlook (winmail.dat);

• пустые файлы;

• файлы больше 50 МБ.

Картинки, встроенные в текст письма, вложениями не считаются. Вложенное письмо приходит файлом .eml, архив — как есть, без распаковки.

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

Ограничения:

• только папка «Входящие»;

• письмо, текст которого больше 1 МБ, агент не покажет, но вложения из такого письма получить может;

• за один запрос — до 50 писем (по умолчанию 10), просматривается не больше 200; если писем больше, агент предложит сузить период или фильтр;

• длинное письмо показывается частично — первые 10 000 символов, агент об этом предупредит;

• агент не отвечает в ту же цепочку и не запускается сам при поступлении нового письма.

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

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

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

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

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

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

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

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

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

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

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

При подключении и авторизации

При чтении писем