Повторное обращение в Битрикс24: как найти контакт и связать его с новым лидом

Сценарий предназначен для порталов, где доступны лиды. На Базовом тарифе лидов нет. Наличие лидов на Стандартном само по себе ещё не подтверждает установку и запуск приложения: доступ и условия подключения нужно проверять на конкретном портале.

Какую задачу решает сценарий

Клиент может оставить новую заявку, хотя его контакт уже есть в CRM. Менеджеру нужно понять, какую карточку использовать, и связать её с обращением. Если каждый раз создавать контакт заново, история клиента окажется в разных карточках.

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

Это не универсальное устранение дублей. Сценарий выбирает карточку для текущего лида. Уже существующие дубли остаются в CRM, а параллельное создание другими роботами или сотрудниками требует отдельного контроля.

Редактор контактного сценария с условием, слиянием и общим шагом привязки. Здесь показано устройство схемы, а не результат настоящего обращения к CRM.

Как выбирается существующий контакт

Первым делом проверяются связи самого лида. Если подходящий контакт уже связан, повторный поиск по коммуникациям не нужен.

Если связи нет, поиск использует телефон или email лида. Совпадение по любому из этих каналов подходит. Повторяющиеся ID в результатах учитываются один раз. Когда найдено несколько контактов, используется контакт с наименьшим положительным ID.

Это конкретное правило выбора. Оно не доказывает, что выбранная карточка содержит самые свежие сведения или нужного ответственного. Если компания требует другого решения при нескольких совпадениях, сначала согласуйте новое правило и способ его настройки.

Ошибку доступа нельзя трактовать как отсутствие клиента. Если поиск завершился ошибкой, факт отсутствия контакта не установлен.

Сценарий выбирает контакт для текущего лида, но не объединяет дубли и не гарантирует уникальность параллельных записей.

Модель найденного контакта вернула ID 501 и признак «Создан новый контакт: Нет». Ответ внешнего поиска задан синтетически.

Когда создаётся новый контакт

Ветка создания выполняется после результата «контакт не найден». Перед записью блок ещё раз проверяет лид, его связи и поиск. Если за это время контакт появился, используется уже существующая карточка, а признак создания остаётся «Нет».

Новый контакт получает имя, фамилию, отчество, телефоны и email лида. При пустом имени используется название лида. Ответственный за новый контакт передаётся отдельно; он должен быть активным и доступным сотрудником.

У блока фиксированное заполнение. Пользовательские поля, адреса, реквизиты и другие произвольные данные лида автоматически не переносятся. Если обязательное поле портала не входит в поддерживаемый набор, создание может остановиться до отправки записи.

Без телефона и email поиск по коммуникациям не найдёт совпадение. Если готовой связи нет, схема может перейти к созданию из оставшихся данных. Обязательные поля и права исполнителя всё равно должны позволять такую операцию.

В модели отрицательный ответ поиска ведёт к ветви создания: ID 501 и «Создан новый контакт: Да». Фактическая запись CRM не выполнялась.

Учебный ответ блока создания сообщает уже существующий ID 501 и created=false. Он иллюстрирует контракт результата; реальную защиту от конкурентных дублей этот кадр не проверяет.

Что происходит после выбора контакта

Найденный или созданный контакт передаётся в общий шаг привязки. Существующие связи сохраняются. Если нужный контакт уже связан, повторная привязка не выполняется. Наличие других связей не означает, что этот шаг заменит их основной контакт.

После успешной привязки сценарий возвращает:

Значение created=false нормально: контакт мог существовать раньше. Для успеха всего сценария проверяйте swb_ok=Да или swb_status=succeeded.

Пример не конвертирует лид, не создаёт сделку, не меняет стадию и не назначает нового ответственного существующему контакту. Такие действия настраиваются отдельно после проверки результата.

Что подготовить перед настройкой

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

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

Почему нельзя вслепую повторять запуск после ошибки

Создание и привязка выполняются отдельно. Контакт мог появиться, а следующий шаг завершиться ошибкой. Подтверждённое создание не откатывается.

Перед повтором откройте журнал и фактические карточки. Проверьте, создан ли контакт и существует ли связь. При неизвестном результате записи ответ мог потеряться после принятия операции; новая попытка требует сверки.

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

Частые вопросы