Обновить задачу по ID
Робот «Обновить задачу по ID» изменяет существующую задачу Битрикс24 по её ID из любого контекста бизнес-процесса. Поля передаются в виде JSON с кодами в ВЕРХНЕМ регистре (TITLE, RESPONSIBLE_ID, DEADLINE, PRIORITY и др.) и применяются через метод tasks.task.update. Возвращает признак «Успешно (Y/N)» по итогу вызова API.
Робот обновляет существующую задачу по её ID, вызывая метод tasks.task.update. На вход подаётся числовой ID задачи и набор полей в виде JSON; коды полей задаются в ВЕРХНЕМ регистре, как того требует API задач — например, {"TITLE":"Новый заголовок","RESPONSIBLE_ID":5,"DEADLINE":"2024-12-31T23:59:59+03:00","PRIORITY":"2"}. Когда применять: сменить ответственного или срок задачи, когда сделка переходит на новую стадию; дописать в заголовок маркер этапа; повысить приоритет по условию процесса. Робот возвращает «Успешно (Y/N)»: N, если не указан ID, JSON пуст или невалиден, либо API вернул ошибку (текст ошибки попадает в лог). Признак «Успешно» используйте в условии следующего шага, чтобы развести ветки удачного и неудачного обновления.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| ID задачи | int | да | |
| Поля для обновления (UPPERCASE JSON): {"TITLE":"Новый заголовок","RESPONSIBLE_ID":5,"DEADLINE":"2024-12-31T23:59:59+03:00","PRIORITY":"2"} | string | да |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Успешно (Y/N) | string |
Сценарий: смена ответственного по задаче при переходе сделки
- Сделка переходит на стадию «В работе»
- Робот вызывает обновление задачи по её ID с полями {"RESPONSIBLE_ID":5}
- При «Успешно» = Y процесс продолжается, при N уходит на ветку обработки ошибки