Привязка текущей задачи к CRM
Робот «Привязка текущей задачи к CRM» управляет связью задачи с элементами CRM прямо в автоматизации или бизнес-процессе самой задачи — ID указывать не нужно. Привязывает, отвязывает или заменяет контакт, компанию, сделку или лид. Режим «Заменить» меняет элемент того же типа, сохраняя остальные. Возвращает «Успешно», «Изменилось» и список привязок.
Робот для воронки задач: добавьте его в правило автоматизации стадии или в бизнес-процесс задачи, и он изменит поле UF_CRM_TASK текущей задачи — определять её ID не нужно, робот берёт задачу из контекста. На вход: тип элемента (контакт/компания/сделка/лид), ID элемента и режим. «Привязать» добавляет связь, «Отвязать» убирает указанную, «Заменить» снимает все привязки того же типа и ставит новую (привязки других типов сохраняются). Операции идемпотентны: если менять нечего — «Изменилось» = N и записи не будет. Типичный сценарий — при переходе задачи на стадию канбана сменить привязанный контакт. Чтобы работать с задачей по её ID из процесса другой сущности, используйте «Привязка задачи к CRM (по ID)». Возвращает «Успешно» (Y/N), «Изменилось» (Y/N) и список привязок (CONTACT_7, DEAL_10…).
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Тип элемента CRM | select | да | contact |
| ID элемента CRM | int | да | |
| Что сделать | select | да | replace |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Успешно (Y/N) | string |
| Привязка изменилась (Y/N) | string |
| Текущие привязки (CONTACT_7, DEAL_10…) | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Ошибка: неверные параметры (тип/ID элемента или режим)
- Ошибка: не указан ID задачи
- Ошибка: робот «текущей задачи» нужно запускать из бизнес-процесса или автоматизации самой задачи
- Ошибка API
Сценарий: сменить контакт при переходе задачи на стадию «В работе»
- В автоматизации стадий задачи добавьте робота «Привязка текущей задачи к CRM»
- Режим «Заменить», тип «Контакт», ID нужного контакта — ID задачи не нужен
- Робот вернёт «Успешно» = Y и «Изменилось» = Y, если контакт сменился