Роботека
Роботека · Роботы · Привязать контакты к лиду

Привязать контакты к лиду

Робот «Привязать контакты к лиду» привязывает один или несколько контактов к лиду Битрикс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}

Сценарий: новый лид с телефона существующего клиента

  1. В CRM создаётся лид с номером телефона
  2. Робот «Найти контакт по телефону» находит контакт и отдаёт его ID
  3. Этот робот привязывает найденный контакт к лиду — менеджер сразу видит историю клиента

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