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