Получить последнее письмо
Робот «Получить последнее письмо» достаёт в бизнес-процессе Битрикс24 последнее входящее письмо лида, сделки, контакта или компании: тему, текст без HTML, адрес и имя отправителя, дату и ID вложений на Диске.
Робот читает таймлайн элемента CRM и возвращает последнее письмо, чтобы следующий шаг процесса мог с ним работать. Штатные роботы содержимое писем не видят: нельзя проверить тему, скопировать текст в поле или переслать вложения. Робот находит самое свежее письмо нужного направления — по умолчанию входящее, можно исходящее или любое — и отдаёт его тему, текст в двух видах (чистый текст без разметки и исходный HTML), адрес и имя отправителя, дату, ID дела и ID файлов вложений на Диске, которые принимают роботы работы с файлами. По умолчанию берётся элемент, на котором запущен процесс, в том числе элемент смарт-процесса; любой лид, сделку, контакт или компанию можно указать по ID. Если писем нет, робот возвращает «Письмо найдено = Нет», и процесс может выбрать другую ветку.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Элемент | select | — | current |
| ID элемента (для режимов «по ID») | string | — | |
| Какое письмо искать | select | — | incoming |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Письмо найдено | bool |
| Тема | string |
| Текст письма (без HTML) | text |
| Текст письма (HTML) | text |
| E-mail отправителя | string |
| Имя отправителя | string |
| Дата письма | string |
| Направление (incoming / outgoing) | string |
| ID дела | int |
| ID файлов вложений на Диске | int |
| Количество вложений | int |
| Успешно | bool |
| Ошибка | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Не удалось определить элемент. Для режима «по ID» укажите корректный ID; текущий элемент должен быть лидом, сделкой, контактом, компанией или элементом смарт-процесса.
- Ошибка API при чтении писем элемента.
Сценарий: разобрать ответ клиента по теме
- Робот ставится на стадию «Ждём ответа» и срабатывает при входящем письме
- Он возвращает тему и текст последнего входящего письма сделки
- Условие проверяет, есть ли в теме слово «счёт», и передаёт сделку бухгалтеру вместе с вложениями