Битрикс24: лиды, сделки и маппинг полей

Как устроено подключение к Битрикс24

Интеграция работает через входящий вебхук самого Битрикс24, а не через OAuth-приложение — отдельного вендорского приложения на маркетплейсе Битрикс для этого не требуется. Со стороны Нотифлоу нужно заполнить два поля: домен портала вида company.bitrix24.ru и URL входящего вебхука вида https://company.bitrix24.ru/rest/1/xxxxxxxx/.

После сохранения кабинет сразу проверяет соединение с порталом. Если проверка не проходит — например, вебхук отозван или права выданы не полностью — интеграция не сохраняется, и нужно исправить данные и повторить попытку. Сам URL вебхука хранится в зашифрованном виде, доступа к нему в открытом тексте после сохранения нет.

Если виджет на портал Битрикс24 еще не установлен, начните с инструкции по установке на Битрикс24 — интеграция с CRM настраивается уже после того, как виджет появился на сайте.

Где взять входящий вебхук в Битрикс24

Вебхук создается внутри самого портала Битрикс24, в разделе «Разработчикам → Другое → Входящий вебхук». При создании нужно выдать три группы прав: crm, im и task — без них часть функций интеграции работать не будет, например отправка сообщений в таймлайн диалога или создание задач. После сохранения портал покажет готовый URL — его и нужно скопировать в кабинет Нотифлоу.

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

Лид или сделка: что выбрать целевой сущностью

В настройках интеграции можно выбрать, какую сущность создавать в CRM при обращении клиента — лид или сделку. По умолчанию используется лид. Разница между ними в Битрикс24 принципиальная: у сделок есть воронки с несколькими стадиями, у лидов — только статус без деления на воронки. Если у компании выстроен процесс продаж с этапами, логичнее выбрать сделку; если задача — просто собрать обращения для дальнейшей обработки менеджером, обычно достаточно лида.

При выборе сделки сначала создается или обновляется контакт: имя, email и телефон уходят именно в карточку контакта, а сама сделка уже привязывается к нему и получает свою воронку и стадию из настроек интеграции.

Когда создается лид или сделка

Момент создания карточки настраивается отдельно — в параметре «создавать при». Доступны два триггера: новый диалог с посетителем (chat_new) и отправка формы, встроенной в виджет (widget_submit). Их можно включить оба сразу или оставить только один.

Для триггера по форме есть дополнительное условие: на конкретном виджете должен быть включен тумблер отправки данных формы в CRM — без него форма продолжит работать, но в Битрикс24 ничего не уйдет. Помимо автоматических триггеров, оператор в любой момент может создать лид вручную прямо из карточки диалога, если это нужно вне общих правил.

Какие данные передаются в карточку автоматически

При создании лида или сделки Нотифлоу передает базовый набор данных: название карточки в формате «Notiflow: имя или email», источник WEB, статус или стадию согласно настройкам интеграции, а также email, телефон и имя контакта. Для сделок этот набор сначала уходит в контакт, а на саму сделку дополнительно передается привязка к воронке и стадии.

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

Как настроить маппинг дополнительных полей

Помимо базового набора, в кабинете доступен отдельный экран маппинга: слева — поля Нотифлоу, справа — поля портала. Со стороны Нотифлоу можно сопоставить name, email, phone, utm_source, utm_medium, utm_campaign, lead_score, lead_tier и кастомные свойства контакта, которые заведены в системе. Со стороны Битрикс24 список полей подтягивается из портала автоматически, включая пользовательские поля вида UF_CRM_ — их не нужно вписывать вручную, кабинет сам покажет актуальный список после подключения вебхука.

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

Что происходит при повторном обращении контакта

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

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

Как в карточку попадают примечания и переписка

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

При закрытии диалога в карточку дополнительно может попадать AI-сводка — короткое резюме того, о чем шел разговор и чем он закончился. Это избавляет менеджера, который позже открывает карточку в Битрикс24, от необходимости читать всю переписку заново.

Обновляется ли стадия сделки автоматически

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

Интеграция с Битрикс24 доступна на всех тарифах Нотифлоу без отдельного ограничения — подробнее о составе тарифов можно почитать на странице тарифов. Если в компании уже используется amoCRM, схожий принцип подключения через ключи доступа описан в статье про интеграцию с amoCRM.

Часто задаваемые вопросы