Привязать контакты к лиду
Робот «Привязать контакты к лиду» привязывает один или несколько контактов к лиду Битрикс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}
Сценарий: новый лид с телефона существующего клиента
- В CRM создаётся лид с номером телефона
- Робот «Найти контакт по телефону» находит контакт и отдаёт его ID
- Этот робот привязывает найденный контакт к лиду — менеджер сразу видит историю клиента