Завершить выбранные CRM-дела с результатом

Завершает явно выбранные дела и возвращает подробный итог по каждому.

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

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

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

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

Завершает явно выбранные дела и возвращает подробный итог по каждому.

Принимает JSON-список до 100 разных ID и необязательную заметку о результате. Заметка дописывается только в описание простого текстового формата. Уже завершённые дела пропускаются. Дела приложений не изменяются. Возвращает завершённые, пропущенные и неподтверждённые ID; частичный итог означает ошибку. Повторная проверка основана на текущем состоянии, общего ключа повтора нет.

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

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

Получите до 100 разных ID дел и проверьте, что работы по ним действительно выполнены. Если нужна заметка о результате, учтите: она дописывается только в простое текстовое описание.

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

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

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

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

Поле в настройках	Что передать	Обязательность и исходное значение
ID дел: JSON (IDS)	Формат: текст.	Обязательно. Значение по умолчанию в настройках не задано
Заметка о результате: необязательно (RESULT_TEXT)	Формат: текст.	Необязательно. Значение по умолчанию в настройках не задано

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

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

• ID дел: JSON (IDS): [900,901].
• Заметка о результате: необязательно (RESULT_TEXT): Заказ передан исполнителю; контроль завершён..

ID дел: JSON (IDS)

Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Здесь нужен JSON-массив в квадратных скобках. Пустой массив [] означает отсутствие элементов; объект {} его не заменяет. Учебные ID замените реальными ID выбранных карточек, дел, шаблонов или сотрудников; их можно передать из результатов предыдущего поиска. Коды полей берите из настроек вашей CRM. Каждое число обозначает положительный ID отдельного CRM-дела. Передавайте от 1 до 100 разных ID; пустой массив не задаёт подборку для завершения. Найденные ID можно получить роботом поиска CRM-дел и передать целым списком.

[
  900,
  901
]

Если дело 900 открыто, а 901 уже завершено, первый ID попадёт в завершённые этим запуском, второй в пропущенные. При неподтверждённом завершении хотя бы одного ID итог будет частичным и потребует разбора.

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

Результат	Какое значение получает следующий шаг
Завершены этим запуском (completedIds)	целое число, несколько значений
Пропущенные ID (skippedIds)	целое число, несколько значений
Неподтверждённые ID (failedIds)	целое число, несколько значений
Подробный итог: JSON (resultsJson)	текст
Все выбранные дела завершены (allCompleted)	да/нет
Статус выполнения (status)	да/нет
Пояснение ошибки (error)	строка

Используйте «Все выбранные дела завершены» для продолжения процесса. «Неподтверждённые ID» передайте ответственному, а подробный итог сохраните для сверки вместо слепого повторного закрытия всех дел.

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

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