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