Помогает одним действием получить основные данные последнего письма и использовать их в следующих шагах процесса.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для менеджера, который передаёт последнее письмо в дальнейшую обработку целиком. Тему, адреса и текст письма приходится получать разными ручными действиями. Робот возвращает основные данные последнего доступного письма одним шагом, отдельно от файловых вложений.
Что делает и когда применять
Робот полезен, когда для дальнейшей автоматизации нужны сразу тема, адреса, текст и вложения письма. Особенно удобен как единая точка получения всех ключевых данных без набора отдельных роботов.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Разместите действие в нужной CRM-карточке с почтовой историей. Выберите, удалять ли HTML-разметку; если текст нужен для анализа, обычно удобен очищенный текст, но форматирование при этом меняется.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Получить данные письма: тема, адреса, текст, файлы». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Разместите действие в нужной CRM-карточке с почтовой историей. Выберите, удалять ли HTML-разметку; если текст нужен для анализа, обычно удобен очищенный текст, но форматирование при этом меняется.
- Заполните Удалить html теги. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Проверьте статус и возвращённые данные; если действие не завершилось, разберите ошибку в журнале процесса до использования результата.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Удалить html теги (delete_html) |
Удалить HTML теги из текста письма Формат: да/нет. | Необязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Удалить html теги (
delete_html):Y.
Из учебного письма с темой «Заявка» вернутся тема, адреса отправителей и получателей и текст. Наличие файлов в результате не означает, что робот понимает их содержание.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Заголовок письма (result_subject) |
строка |
Адреса отправителя (sender_emails) |
строка, несколько значений |
Адреса получателя (recipient_emails) |
строка, несколько значений |
Текст письма (result_text) |
текст |
Файлы (files) |
целое число, несколько значений |
Статус (status) |
да/нет |
Передайте тему в маршрутизацию, текст в разбор заявки, а файлы в отдельную обработку. Не считайте все найденные адреса адресами клиента: среди них могут быть служебные ящики и копии.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.