Роботека
Роботека · Роботы · Привязка задачи к CRM (по ID)

Привязка задачи к CRM (по ID)

Робот «Привязка задачи к CRM (по ID)» управляет связью задачи Битрикс24 с элементами CRM: привязывает, отвязывает или заменяет контакт, компанию, сделку или лид у задачи по её ID. Режим «Заменить» меняет элемент того же типа, сохраняя привязки других типов. Возвращает «Успешно», признак «Изменилось» и итоговый список привязок.

Робот изменяет поле UF_CRM_TASK задачи по её ID — связь задачи с элементами CRM. На вход: ID задачи, тип элемента (контакт/компания/сделка/лид), ID элемента и режим. Режимы: «Привязать» добавляет связь, не трогая остальные; «Отвязать» убирает только указанную; «Заменить» снимает все привязки того же типа и ставит новую (привязки других типов сохраняются). Все операции идемпотентны: если менять нечего, робот вернёт «Изменилось» = N и пропустит запись. Применяйте из бизнес-процесса сделки или контакта, чтобы привязать к связанной задаче нужный элемент. Возвращает «Успешно» (Y/N), «Изменилось» (Y/N) и итоговый список привязок в формате CONTACT_7, DEAL_10 — его можно подать в робот поиска задач.

Какие параметры принимает робот?

Параметр Тип Обязательный? По умолчанию
ID задачи int да
Тип элемента CRM select Контакт, Компания, Сделка, Лид да contact
ID элемента CRM int да
Что сделать select Заменить (этого типа), Привязать (добавить), Отвязать (убрать) да replace

Что возвращает робот?

Параметр Тип
Успешно (Y/N) string
Привязка изменилась (Y/N) string
Текущие привязки (CONTACT_7, DEAL_10…) string

Какие ошибки может вернуть робот?

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

  • Ошибка: неверные параметры (тип/ID элемента или режим)
  • Ошибка: не указан ID задачи
  • Ошибка: робот «текущей задачи» нужно запускать из бизнес-процесса или автоматизации самой задачи
  • Ошибка API

Сценарий: заменить контакт у задачи из процесса сделки

  1. Бизнес-процесс сделки доходит до нужного шага
  2. Робот с режимом «Заменить», тип «Контакт», ID нового контакта и ID задачи
  3. Робот вернёт «Успешно» = Y и список привязок с новым контактом

Похожие роботы

Статьи по теме

Установить Опишите задачу — сделаем робота бесплатно