Перейти к содержанию

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

У каждого агента есть собственный адрес электронной почты. Письма, отправленные на него, попадают в почтовый ящик на сервере агента: агент может читать их, искать и отвечать, а вы — читать их в панели.

✉️ agent1234@mintbot.ai📁 отдельный адрес для каждого проекта🔔 вы выбираете уведомления

Адрес

Адрес вашего агента — agent + его номер + @mintbot.ai: у агента 1234 это agent1234@mintbot.ai. Он доступен с момента создания агента на любом пакете, и ничего настраивать не нужно.

Вы найдёте его в панели в разделе Настройки → Электронная почта, а также на небольшой карточке, которая открывается при нажатии на имя агента вверху боковой панели. Нажатие на адрес в карточке копирует его.

Для чего он пригодится:

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

Ящик принадлежит агенту, а не отдельному человеку: все пользователи агента видят одни и те же письма. Письмо, которое прочитал один из вас, считается прочитанным для всех, а удалённое исчезает у всех.

Что агент делает с почтой

Просите обычными словами:

  • «Пришёл ли счёт из типографии?»
  • «Найди код подтверждения с сайта бронирования».
  • «Что пришло по проекту магазина на этой неделе?»
  • «Ответь Анне, что четверг подходит».

Агент может показывать список писем и искать в своей почте (по отправителю, дате, проекту, наличию вложений), читать письмо и сохранять его вложения, а также отправлять письма со своего адреса.

  • Он пишет от своего имени, а не от вашего. Письма отправляются с адреса агента. Если у агента есть имя, оно стоит в строке отправителя перед адресом: Name <agent1234@mintbot.ai>.
  • Отправка входит в платные пакеты. В бесплатном пробном периоде агент получает почту, но не отправляет её.
  • Никаких массовых рассылок. Агент отправляет до 100 писем в день, каждое — не более чем 20 получателям, суммарно — не более 300 получателям в день. Счётчик обнуляется в полночь UTC. Адрес не предназначен для рассылок или непрошеных коммерческих предложений.
  • Частые возвраты писем приостанавливают отправку. Если слишком много писем агента не удаётся доставить (адреса не существуют), отправка приостанавливается на сутки, а затем возобновляется автоматически. На получение это не влияет.

Письмо — не инструкция

Вашему агенту может написать кто угодно, поэтому он воспринимает содержание письма как внешний материал: читает его и рассказывает вам о нём, но не действует по нему. Единственное исключение — список, который вы сами настраиваете ниже в разделе Инструкции по электронной почте.

Почтовый ящик в панели

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

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

Здесь вы можете писать и сами. Новое письмо открывает новый разговор с формой письма (получатели, тема, текст): заполните её и нажмите Отправить или попросите агента написать письмо прямо там. Ответить под открытым письмом позволяет ответить таким же образом. Ваши письма уходят с адреса агента, учитываются в его дневном лимите и сохраняются в разделе Отправленные, где все пользователи агента видят их рядом с письмами, которые отправил сам агент. Скрепка рядом с Отправить прикрепляет файлы (до 10, общим размером 7 MB): они сразу сохраняются вместе с черновиком и остаются на месте, когда вы возвращаетесь к нему позже. Файл можно также перетащить на форму. Корзина на краю формы удаляет черновик. Для текста доступно то же форматирование, что и в поле сообщения чата: Ctrl+B — полужирный, Ctrl+I — курсив, Ctrl+U — подчёркивание, Ctrl+S — зачёркивание (⌘ на Mac).

Или поручите написать агенту: Попросить агента ответить под письмом или Попросить агента написать в форме открывает чат с готовым запросом. Добавьте, что нужно сказать в письме, и отправьте. Агент покажет черновик и отправит его после вашего согласия.

Закрепите Электронную почту в боковой панели: она будет доступна одним нажатием, а рядом появится число непрочитанных писем.

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

Письма, похожие на спам, попадают в Спам. Уведомлений о них нет, и через 30 дней они удаляются, если вы их не закрепили.

Адрес для каждого проекта

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

agent1234.shop@mintbot.ai

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

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

Полезно знать:

  • Вместо точки можно использовать плюс: agent1234+shop@mintbot.ai — тот же адрес.
  • Письма несуществующему проекту (опечатка или удалённый проект) не возвращаются отправителю. Они приходят в общий почтовый ящик.
  • Переименование проекта не меняет имя его папки, поэтому адрес остаётся прежним.

Когда приходит новая почта

В разделе Настройки → Электронная почта → Когда приходит новая почта выберите, где получать уведомления:

Вариант Что вы получаете
В панели и в Telegram Оба варианта ниже. Это значение по умолчанию.
Только в панели Уведомление с кнопкой, открывающей письмо.
Только в Telegram Сообщение с отдельной кнопкой для каждого письма: нажатие показывает его текст прямо в чате.
Нигде Ничего. Почта ждёт в ящике.

Выбор действует для всех пользователей агента.

Инструкции по электронной почте

Вы можете разрешить выбранным людям давать агенту задания по электронной почте. По умолчанию это выключено. Чтобы включить, откройте Настройки → Электронная почта → Инструкции по электронной почте, включите переключатель и добавьте адреса, которым доверяете (до 20).

После этого, когда с одного из этих адресов пишут агенту:

  1. В панели открывается разговор с маленьким значком конверта, а письмо становится его первым сообщением.
  2. Агент выполняет то, о чём просят в письме.
  3. Он отвечает на письмо с результатом.

Ответ в той же почтовой цепочке продолжает тот же разговор, поэтому агент знает, что уже сделал.

Прежде чем добавить адрес:

  • Учитывается только подтверждённая почта. Почтовый сервис отправителя должен подтвердить, что письмо действительно пришло с этого адреса (проверка называется DMARC, см. ниже). Письмо, которое лишь выдаёт себя за отправленное с адреса из списка, игнорируется, как и письмо, попавшее в Спам.
  • Запросом считается только собственный текст письма. Его вложения и страницы, на которые ведут ссылки, — внешний материал: агент читает их, но не выполняет найденные там инструкции.
  • Любой, кто может отправлять письма с адреса из списка, может управлять вашим агентом и сервером, на котором он работает. Добавляйте только адреса, которые вы контролируете или которым полностью доверяете.
  • О некоторых действиях агент всё равно сначала спрашивает: удалении данных, тратах, передаче личных данных или доступа другим. Он отвечает и спрашивает разрешения, а не выполняет их на основании одного письма.

Какая почта считается подтверждённой

DMARC — проверка, позволяющая принимающему серверу подтвердить, что письмо действительно отправлено с домена в адресе From. Без неё любой может указать любой адрес отправителя.

  • Работает без настройки: Gmail, Outlook, Hotmail, Yahoo, iCloud, Proton Mail, Fastmail, GMX, Zoho.
  • Собственный домен (Google Workspace, Microsoft 365, почта хостинг-провайдера): работает, если для домена есть запись DMARC вместе с SPF или DKIM. Это настраивает тот, кто управляет доменом.
  • Не учитывается: домен без записи DMARC, а также часто письма, автоматически пересланные или отправленные через список рассылки.

Письмо, не прошедшее проверку, не теряется: оно остаётся в ящике как обычная почта, просто его задание не выполняется.

Ограничения

  • Входящее письмо может занимать до примерно 15 MB вместе с вложениями; отправляемое агентом — до 10 MB.
  • Ящик вмещает до 2 GB. Когда он заполнен, приём новой почты откладывается, а сервер отправителя в течение нескольких дней просят повторить попытку позже. Удалите письма, чтобы освободить место.
  • Пока работа агента приостановлена, его почта не принимается: сервер отправителя продолжает попытки, обычно в течение нескольких дней, и почта приходит, когда агент снова работает.