Изменение сделки по ID

Изменяет поля сделки по указанному ID.

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

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

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

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

Робот меняет нужные поля сделки по её ID: например, сумму, стадию или комментарий.

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

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

Проверьте ID получателя и доступ к нему. Заполните только нужные поля; код стадии должен относиться к направлению выбранной сделки, а ID сотрудников и CRM-связей должен существовать.

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

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

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

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

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

Поле в настройках	Что передать	Обязательность и исходное значение
ID сделки (elementId)	Числовой ID изменяемой сделки, например 501, из результата поиска/создания сделки или заранее сохранённого ID. Само число 501 учебное: замените его ID доступной сделки вашего портала.	Обязательно. Значение по умолчанию в настройках не задано
Название (title)	Новое название сделки, например Поставка панелей — согласовано. Это обычный текст, не ID и не команда добавить комментарий.	Необязательно. Значение по умолчанию в настройках не задано
ID компании (companyId)	Числовой ID компании, например 101. Возьмите ID выбранной компании из результата её поиска или из сохранённого поля связи. Нужна компания этого портала; название организации и вся ссылка карточки не подходят.	Необязательно. Значение по умолчанию в настройках не задано
ID контакта (contactId)	Числовой ID контакта, например 201. Получите его из результата поиска контакта или подготовленной связи с контактом. ID компании и ID контакта — разные значения, даже если оба относятся к одному клиенту.	Необязательно. Значение по умолчанию в настройках не задано
Ответственный (assignedById)	Выберите одного сотрудника через поле выбора пользователей. При подстановке результата передайте его ID, например 23; допускается значение user_23. ФИО, email и ID отдела не заменяют ID сотрудника.	Необязательно. Значение по умолчанию в настройках не задано
Сумма (opportunity)	Число, например 20000 или 20000.50, без пробелов-разделителей, знака рубля и текста. Валюту укажите отдельно. Передавайте сумму в выбранной валюте, а не строку 20 000 руб..	Необязательно. Значение по умолчанию в настройках не задано
Валюта (currencyId)	Код доступной валюты, например RUB. Возьмите код валюты из настроек CRM или результата предыдущего шага. Для суммы в рублях в учебном примере используется RUB; на портале эта валюта должна быть доступна.	Необязательно. Значение по умолчанию в настройках не задано
Стадия (stageId)	Точный код стадии выбранной сделки. Например, NEW для учебной основной воронки или C4:NEW для учебной воронки 4, если эти стадии действительно настроены. Возьмите фактический код из настроек стадий/результата получения сделки; отображаемое название «Новая» не заменяет код. Код должен соответствовать воронке именно получателя.	Необязательно. Значение по умолчанию в настройках не задано
Комментарий (comments)	Обычный текст комментария, например Доставка согласована на 20 ноября.. Для изменения используйте полное новое содержимое: робот не дописывает фразу к прежнему комментарию автоматически.	Необязательно. Значение по умолчанию в настройках не задано
Наблюдатели (observerIds)	Выберите нескольких сотрудников, например учебных пользователей с ID 24 и 25, через добавление значений поля. Из предыдущего шага подставляйте список ID: например [24, 25] или список user_24, user_25. Строку 24,25 вместо списка передавать нельзя.	Необязательно. Значение по умолчанию в настройках не задано

Откуда брать значения и что оставить без изменения

Числа 101, 201, 501, 801 и ID сотрудников в примерах условные. В рабочем процессе сначала получите нужный ID поиском, созданием элемента или из подготовленного поля; в редакторе робота выберите подстановку соответствующего результата. Не копируйте номер из другого портала. Если следующий шаг возвращает несколько ID, сначала выберите нужный элемент: одиночный вход не принимает весь список.

Необязательные поля заполняйте по задаче. Не добавляйте чужую компанию, контакт или стадию только для повторения примера. Для учебной настройки можно оставить необязательное поле непереданным; это отличается от явной передачи пустого значения.

У этого робота нет переключателя защиты от очистки: явно переданная пустая строка в названии, комментарии или другом обычном поле участвует в изменении. Отсутствующий вход и значение null пропускаются. Для наблюдателей явно переданный пустой список очищает их список; если менять наблюдателей не нужно, не передавайте этот вход. Пустого ответственного робот не назначает. Проверьте подстановки до включения шага: выражение, которое вернуло пустой текст, может отличаться по результату от полностью отсутствующего входа.

Для наблюдателей при передаче списка между шагами пример значения выглядит так:

[24, 25]

Это значение множественного входа observerIds, а не строка, которую нужно набрать в поле поиска сотрудника. В самой форме найдите и выберите двух сотрудников. Один JSON-массив передавайте только из шага, который действительно выдаёт список; объект со всеми настройками робота сюда не нужен.

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

Есть доступная учебная сделка 501. В ней нужно обновить условия, назначить одного ответственного и двух наблюдателей. Сотрудники с ID 23, 24 и 25 и связанные CRM-карточки должны существовать на вашем портале; числа здесь вымышленные.

Поле	Значение
ID сделки	501
Название	Поставка панелей — согласовано
ID компании	101, если меняется компания сделки
ID контакта	201, если меняется контакт
Ответственный	Выберите сотрудника с учебным ID 23; при подстановке допускается user_23
Сумма	20000
Валюта	RUB
Стадия	Не передаётся, чтобы сохранить её; для смены в учебной основной воронке может использоваться NEW, если эта стадия существует
Комментарий	Условия доставки подтверждены.
Наблюдатели	Выберите сотрудников 24 и 25; из предыдущего шага нужен список [24, 25]

Ожидается изменение именно сделки 501. Наблюдатели задаются переданным списком, поэтому передайте весь нужный состав, включая прежних наблюдателей, которых требуется сохранить. Для фактического процесса включайте только те поля, которые нужно изменить. Если задача ограничена комментарием, не передавайте остальные изменяемые входы. Хотя бы одно новое поле должно быть передано; один ID изменения не задаёт.

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

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

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

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

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