CRM Роботы + AI 2.0

Получить текст из письма в сделке

Робот «Получить текст из письма в сделке» для Битрикс24: автоматический анализ содержания переписки

Что делает

Робот извлекает полный текст последнего письма из указанной сделки и возвращает его вместе с темой и списком вложений. В отличие от роботов, работающих по текущей сущности, этот робот принимает ID сделки как параметр — его можно использовать в любом контексте, даже если бизнес-процесс запущен не в сделке.

Робот поддерживает режим очистки HTML: если письмо пришло в формате HTML, робот может автоматически удалить теги и оставить только чистый текст. Это особенно важно, когда текст письма передаётся на анализ другим роботам или используется для заполнения полей CRM, где HTML-разметка не нужна.

Сценарии использования

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

Сохранение текста письма в пользовательское поле. Менеджеру нужно видеть текст последнего письма прямо в карточке сделки, не открывая почтовую историю. Робот извлекает текст и сохраняет его в пользовательское поле — теперь ключевая информация всегда на виду, даже при быстром просмотре воронки.

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

Архивирование переписки для истории. При закрытии сделки робот извлекает текст последнего письма и сохраняет его в комментарий или отдельную карточку смарт-процесса «Архив обращений». Это формирует полную историю взаимодействия с клиентом, доступную для аудита и анализа даже после завершения сделки.

Настройка

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

ID сделки — идентификатор сделки, из которой нужно извлечь письмо. Может быть передан как значение поля, переменная бизнес-процесса или результат другого робота.
Очистка HTML — опция включения/выключения удаления HTML-тегов из текста письма. Рекомендуется включать, если текст дальше передаётся на анализ или сохраняется в текстовые поля.

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

Результат

Робот возвращает в переменные бизнес-процесса:

text — текст письма (очищенный или исходный, в зависимости от настройки);
subject — тема письма;
files — список ID файлов-вложений из письма (через запятую);
status — Y (письмо найдено, текст извлечён) или N (писем нет или ошибка).

Интеграция с другими роботами

Парсинг текста по промпту: text → ИИ-анализ → извлечение сущностей, параметров заказа.
Парсинг по регулярным выражениям: text → извлечение телефонов, email, сумм и других структурированных данных.
Классификация писем: text → определение категории: заказ, вопрос, жалоба, спам.
Создание задачи: text → описание задачи, subject → заголовок задачи.
Действия над текстом: text → очистка, приведение к регистру перед сравнением.

Типичные ошибки при настройке

Ошибка	Причина	Решение
Статус `N`, текст пуст	По указанному ID сделки нет писем, или ID недействителен	Проверьте, что ID корректен и в сделке есть email-активности
В тексте видны HTML-теги	Не включена опция очистки HTML, а письмо пришло в HTML-формате	Включите параметр очистки HTML в настройках робота
Текст обрезан или неполный	Письмо очень большое	Робот возвращает полный текст, но для очень длинных писем проверьте настройки полей CRM: некоторые текстовые поля имеют ограничение по длине
Список файлов пуст, хотя вложения были	Вложения не зарегистрированы в CRM или имеют большой размер	Проверьте, отображаются ли вложения в карточке сделки; для очень больших файлов CRM может не сохранять их в историю
Робот не запускается в другом контексте	ID сделки не передан или пуст	Убедитесь, что параметр ID сделки заполнен — значением поля, переменной или константой