Найти строку во входящем письме

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

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

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

Что делает и когда применять

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

Укажите ID сделки или лида и строки поиска, при необходимости отправителей. Регистр букв не влияет на поиск. Статус Да означает совпадение, Нет: отсутствие строки или подходящего письма; пояснение заполняется при ошибке.

Что подготовить

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

Запускайте действие в лиде или сделке и передайте ID карточки. В поле «Строка поиска» задайте буквальную фразу, а не регулярное выражение. При необходимости ограничьте отправителя.

Как настроить и использовать

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Найти строку во входящем письме». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Запускайте действие в лиде или сделке и передайте ID карточки. В поле «Строка поиска» задайте буквальную фразу, а не регулярное выражение. При необходимости ограничьте отправителя.
3. Заполните ID, Email отправителя, Строка поиска, HTML-Entities. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

Параметры робота

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

Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.

Поле в настройках	Что передать	Обязательность и исходное значение
ID (ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
Email отправителя (MAIL)	Формат: текст. Можно передать несколько значений.	Необязательно. Значение по умолчанию в настройках не задано
Строка поиска (REGULAR_EXPRESSION)	Формат: строка. Можно передать несколько значений.	Обязательно. Значение по умолчанию в настройках не задано
HTML-Entities (HTML_ENTITIES)	Формат: да/нет.	Необязательно. Значение по умолчанию в настройках не задано

Учебный пример

Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.

• ID (ID): 501.
• Email отправителя (MAIL): client@example.com.
• Строка поиска (REGULAR_EXPRESSION): заказ подтверждаю.
• HTML-Entities (HTML_ENTITIES): N.

Письмо «Заказ подтверждаю» даёт положительный статус совпадения независимо от регистра. Отрицательный статус может означать отсутствие фразы или подходящего письма; это не обязательно техническая ошибка. Пояснение ошибки проверяйте отдельно.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
Статус выполнения (status)	да/нет
Пояснение ошибки (error)	строка

Постройте ветку по статусу найденной строки и отдельно контролируйте «Пояснение ошибки». Нахождение буквальной фразы не доказывает смысловое согласование: она может встретиться в цитате старой переписки.

Ошибки и ограничения

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