Объединение лидов

Помогает автоматически объединять дублирующиеся лиды, чтобы сохранять чистоту CRM и единый контекст работы с клиентом.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

Робот полезен для администратора CRM, объединяющего подтверждённые дубли лидов. Проверенные дубли мешают вести одно обращение в одной карточке. Робот объединяет переданные лиды по своему правилу и возвращает сохранённый и удалённый ID для дальнейшей работы.

Что делает и когда применять

Робот полезен, когда по одному обращению создается несколько лидов и их нужно свести в одну рабочую карточку.

Что подготовить

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

Передайте проверенный список ID лидов и изучите правило сохранения, указанное в описании робота. Перед первым рабочим использованием проверьте данные и последствия удаления на учебной паре, включая историю и связи.

Как настроить и использовать

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Объединение лидов». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Передайте проверенный список ID лидов и изучите правило сохранения, указанное в описании робота. Перед первым рабочим использованием проверьте данные и последствия удаления на учебной паре, включая историю и связи.
3. Заполните ID лидов. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Проверьте статус и возвращённые данные; если действие не завершилось, разберите ошибку в журнале процесса до использования результата.

Параметры робота

В полях формы, которые допускают несколько значений, добавляйте каждое значение отдельным элементом через редактор. Обычные текстовые, числовые и списковые поля заполняйте в указанном для них формате.

Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.

Поле в настройках	Что передать	Обязательность и исходное значение
ID лидов (leadIds)	Список идентификаторов лидов для объединения Формат: целое число. Можно передать несколько значений.	Обязательно. Значение по умолчанию в настройках не задано

Учебный пример

Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.

• ID лидов (leadIds): [501,502].

После успешного объединения один ID используется дальше как сохранённый, а результат отдельно указывает удалённый. Само совпадение телефона не является подтверждением дубля: решение нужно принять до запуска этого действия.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
Статус выполнения (Y/N) (status)	строка
ID удаленных лидов (removeLeadId)	целое число, несколько значений
ID оставшегося лида (leadId)	целое число, несколько значений
Текст ошибки/статус (text)	строка

Используйте только «ID сохранённого лида» в следующих изменениях. Сохраните текст результата и проверьте, какие данные перенесены; объединение не следует повторять по уже удалённым ID.

Ошибки и ограничения

Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.