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

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

Робот «Привязать контакты к сделке» привязывает один или несколько контактов к сделке Битрикс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. Процесс собирает ID всех контактов компании
  2. Этот робот в режиме «Добавить» привязывает их к сделке одним шагом
  3. Письма и звонки по сделке теперь видны по каждому участнику

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