Получить последнее завершённое дело звонка или письма
Находит последнее записанное завершённое дело связи с клиентом в основной карточке.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для руководителя продаж, контролирующего паузы в записанных контактах с клиентом. Дата изменения карточки обновилась, но это не говорит о звонке или письме. Робот ищет последнее завершённое дело встроенной телефонии или почты в основной карточке за указанный период.
Что делает и когда применять
Находит последнее записанное завершённое дело связи с клиентом в основной карточке.
Принимает тип и ID основной карточки, период ISO с часовым поясом и CHANNELS: JSON-массив call/email. Учитывает только входящие и исходящие завершённые дела встроенной телефонии и почты, с известной датой начала. Сроки планирования, изменения карточки и дополнительные привязки не используются. Завершённость дела не доказывает состоявшийся разговор или доставку письма. Возвращает дату, канал, направление, автора и ID. При одинаковом времени выбирает больший ID и возвращает ambiguous и все tiedIds. Отсутствие: found=N; неполное чтение или более 10000 найденных записей: ошибка. Будущая часть периода исключается.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Укажите основную CRM-карточку, обе границы периода с часовым поясом и каналы call/email. Дела, видимые лишь через дополнительную привязку, не входят в эту проверку.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Получить последнее завершённое дело звонка или письма». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Укажите основную CRM-карточку, обе границы периода с часовым поясом и каналы call/email. Дела, видимые лишь через дополнительную привязку, не входят в эту проверку.
- Заполните Тип основной карточки CRM, ID основной карточки CRM, Начало периода: ISO с часовым поясом, Конец периода: ISO с часовым поясом, Каналы call/email: JSON. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Тип основной карточки CRM (OWNER_TYPE_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID основной карточки CRM (OWNER_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Начало периода: ISO с часовым поясом (FROM) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Конец периода: ISO с часовым поясом (TO) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Каналы call/email: JSON (CHANNELS) |
Формат: текст. | Обязательно. По умолчанию: ["call","email"] |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Тип основной карточки CRM (
OWNER_TYPE_ID):2. - ID основной карточки CRM (
OWNER_ID):501. - Начало периода: ISO с часовым поясом (
FROM):2026-10-01T00:00:00+03:00. - Конец периода: ISO с часовым поясом (
TO):2026-10-10T23:59:59+03:00. - Каналы call/email: JSON (
CHANNELS):["call","email"].
Каналы call/email: JSON (CHANNELS)
Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Здесь нужен JSON-массив в квадратных скобках. Пустой массив [] означает отсутствие элементов; объект {} его не заменяет. Допустимы строки call и email: звонки и письма. Для одного канала передайте ["call"] или ["email"]. Эти коды являются значениями элементов массива, а не ключами объекта.
[
"call",
"email"
]
При завершённом письме 8 октября и звонке 9 октября последнее время относится к звонку. Завершённость дела не доказывает разговор или доставку письма. Если у нескольких дел одинаковое последнее время, результат отдельно показывает неоднозначность.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Дело найдено (found) |
да/нет |
ID дела (activityId) |
целое число |
Зафиксированное время начала (interactionAt) |
строка |
Канал (channel) |
строка |
Направление (direction) |
строка |
ID автора (authorId) |
целое число |
Есть несколько дел с тем же временем (ambiguous) |
да/нет |
ID дел с последним временем (tiedIds) |
целое число, несколько значений |
Статус выполнения (status) |
да/нет |
Пояснение ошибки (error) |
строка |
Используйте «Зафиксированное время начала» для последующего расчёта паузы. При found=N выделите ветку отсутствия подходящего дела; при ambiguous=Y сохраните все ID с последним временем для разбора.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.