Управление наблюдателями
Робот «Управление наблюдателями» добавляет, удаляет или заменяет наблюдателей у текущей сущности CRM в бизнес-процессах и роботах Битрикс24. Работает со сделками, лидами, контактами, компаниями и смарт-процессами — тип определяется автоматически. На входе действие (добавить, удалить или заменить) и список пользователей. Возвращает итоговое число наблюдателей и признак успеха (Y/N).
Робот управляет списком наблюдателей текущей сущности CRM через универсальный API — добавляет указанных пользователей к уже имеющимся, удаляет их из списка или полностью заменяет список наблюдателей. Сущность определяется автоматически по процессу, в котором запущен робот: поддерживаются сделки, лиды, контакты, компании и смарт-процессы. На входе два поля: «Действие» (добавить / удалить / заменить) и список пользователей-наблюдателей; при действии «Заменить» с пустым списком все наблюдатели снимаются. Робот возвращает итоговое количество наблюдателей и признак успеха (Y/N). Типовые случаи применения: автоматически подключать руководителя или профильного специалиста наблюдателем при попадании сделки на нужную стадию, снимать наблюдателей при закрытии, синхронизировать состав наблюдателей по правилам отдела.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Действие | select | да | add |
| Наблюдатели | user | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Наблюдателей стало | int |
| Успешно (Y/N) | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Ошибка: текущая сущность не поддерживает наблюдателей
- Ошибка: неверное действие (add / remove / replace)
- Ошибка: не указаны наблюдатели
- Ошибка API
Сценарий: подключить руководителя наблюдателем на важной стадии
- Сделка переходит на стадию «Согласование»
- Робот «Управление наблюдателями» в режиме «Добавить» добавляет руководителя отдела
- Руководитель видит сделку в списке наблюдаемых, число наблюдателей возвращается в процесс