Синхронизация с Битрикс24: настройка, маппинг полей и все параметры

Синхронизация с Битрикс24 нужна, когда заявки приходят в CRM кабинета, а менеджеры ведут сделки в Битрикс24. Без неё лид после звонка бота или заявки с сайта переносят руками. Смена стадии в Битрикс24 не доходит до кабинета, и автоворонки работают по устаревшим данным.

Двусторонняя интеграция с Битрикс24 — это обмен лидами и сделками между двумя CRM через вебхуки Битрикс24. Лид встал на выбранный шаг — в Битрикс24 появляется или обновляется сделка. Сделка перешла на выбранную стадию — в кабинете меняется шаг лида. Вместе с шагом и стадией переносятся поля, ответственный, сумма, источник, диалог и запись разговора — по тому маппингу, который вы настроите. Всё настраивается на странице /land/bitrix/bitrix.php: ниже разобран каждый её блок, каждое поле и каждая галочка. Посмотрите видео на две минуты, а ниже — пошаговая настройка.

Зачем бизнесу синхронизация с Битрикс24

• Продажи в Битрикс24, первый контакт — у ботов. Лид, которого голосовой бот довёл до шага «Встреча назначена», сам встаёт сделкой на нужную стадию с телефоном, полями и записью разговора.
• Колл-центр в кабинете, отдел продаж в Битрикс24. Менеджер двигает сделку, а шаг лида в кабинете меняется следом — обзвон и автоворонки идут по актуальному статусу.
• Бот прозванивает сделки из Битрикс24. Менеджер передвигает сделки на стадию прозвона, бот звонит сам, а в отдел продаж возвращаются только целевые клиенты с записью разговора.
• Один ответственный в обеих системах. Пары сотрудников сопоставляются один раз, и сделка достаётся тому же менеджеру, что и лид.
• Руководитель видит одну картину. Не нужно сводить выгрузки из двух CRM, чтобы понять, сколько клиентов дошло до оплаты.

Как работает двусторонняя интеграция с Битрикс24

• Из кабинета в Битрикс24. Лид встаёт на шаг из блока 4. Интеграция ищет карточку сначала по связке: если этот лид уже передавался, она помнит его карточку год с последнего обмена. Связки нет — ищет по телефону, через контакт. Нашла — обновляет самую свежую карточку, не нашла — создаёт новую на выбранной стадии.
• Из Битрикс24 в кабинет. Битрикс24 сообщает о новых и изменённых лидах и сделках. Если карточка стоит на стадии из блока 3, интеграция находит лид кабинета по связке или по телефону и ставит шаг, поля и ответственного. Лида нет — создаёт новый.
• Лиды и сделки Битрикс24. В списке воронок есть пункт «Лиды Битрикс» — с ним обмен идёт с лидами Битрикс24 и их статусами. Остальные пункты списка — воронки сделок.
• Без петли. Каждый шаг и каждую стадию можно выбрать только один раз на оба блока. Кроме того, стадия не переписывается, если карточка уже на ней, а шаг — если лид уже на нём. Поэтому изменение, пришедшее из Битрикс24, не возвращается обратно.

Голосовой бот сам в Битрикс24 не пишет. Итоги звонка он записывает в карточку лида через раздел «Запись в CRM» — это описано в статье интеграция голосового робота с crm. Когда бот переводит лида на шаг из блока 4, данные уходят в Битрикс24.

Как настроить синхронизацию с Битрикс24

1. 1
   Создайте входящий вебхук в Битрикс24

   В разделе вебхуков Битрикс24 («Приложения» → «Разработчикам» → «Другое» → «Входящий вебхук», в некоторых версиях — «Приложения» → «Вебхуки») добавьте входящий вебхук с правами crm, user и telephony. Права telephony нужны, чтобы в карточку попадал звонок с записью. Скопируйте адрес вебхука вида https://…bitrix24.ru/rest/1/…/. От имени сотрудника, создавшего вебхук, интеграция создаёт и двигает сделки.
2. 2
   Создайте исходящий вебхук

   Выберите события ONCRMLEADADD, ONCRMLEADUPDATE, ONCRMDEALADD и ONCRMDEALUPDATE. Другие события, например регулярных сделок, отмечать не нужно: интеграция принимает только эти четыре. Адрес обработчика возьмите на странице настройки: ссылка «Вставьте эту ссылку для исходящего вебхука в Битриксе» копирует его, появится «Ссылка скопирована». Сохраните вебхук и только после этого скопируйте его токен приложения.
3. 3
   Откройте страницу настройки

   /land/bitrix/bitrix.php на домене вашего кабинета.
4. 4
   Заполните блок «1. Авторизация в Битрикс24»

   В «Введите Входящий вебхук Битрикса24» вставьте адрес входящего вебхука, в «Введите токен приложения исходящего вебхука Битрикса24» — токен. «Логин Битрикса» и «Пароль Битрикса» необязательны. Нажмите «Авторизоваться в Битриксе» и дождитесь «Все данные успешно загружены.».
5. 5
   Войдите в кабинет в блоке 2

   Укажите номер проекта, логин (email) и пароль кабинета и нажмите кнопку авторизации. Подгрузятся шаги воронки, поля, сотрудники и сохранённые настройки, а первые два блока скроются.
6. 6
   Настройте блок 3

   Что приходит из Битрикс24 в кабинет: воронка и статус Битрикс24 → шаг воронки кабинета.
7. 7
   Настройте блок 4

   Что уходит из кабинета в Битрикс24: шаг воронки кабинета → воронка и статус Битрикс24, плюс галочки дублей и контакта.
8. 8
   Сопоставьте поля

   В таблицах «Соответствие полей для воронки…» под каждым блоком: пары полей, значения списков и сотрудников.
9. 9
   Нажмите «Сохранить»

   Внизу страницы. Появится «Сохраняем настройки интеграции...», затем «Настройки интеграции сохранены.» и сообщение, что вебхук успешно установлен.

Блок 3: что приходит из Битрикс24 в кабинет

Строка блока — три списка: «Выберите воронку Битрикс», «Выберите статус воронки Битрикс» и шаг воронки кабинета. Когда карточка Битрикс24 попадает на этот статус, лид в кабинете встаёт на выбранный шаг. Следующую строку добавляет кнопка «Добавить воронку», лишнюю убирает «Удалить». Если одной стадии подходят несколько правил, срабатывает первое.

Повторный лид. Галочка «Заводить повторный лид» и список «Шаг воронки … для повторного лида». Без галочки новое обращение из Битрикс24 ложится в прежний лид клиента. С ней интеграция заводит новый лид того же контакта на выбранном шаге — так повторные обращения видны в воронке. Повторный лид заводится один раз на карточку Битрикс24: дальнейшие изменения этой карточки идут в него же. Поля берутся по маппингу исходного шага. Без выбранного шага настройка не включится. Сохраняется своей кнопкой «Сохранить» прямо в этом блоке.

Блок 4: что уходит из кабинета в Битрикс24

Строка блока — шаг воронки кабинета, «Выберите воронку Битрикс» и «Выберите статус воронки Битрикс». Лид встал на этот шаг — карточка в Битрикс24 создаётся или переходит на этот статус. На каждый шаг действует одно правило. Под статусом — галочки для этой строки:

• «Создавать 1 дубль». Цифра нажимается, в окне «Введите количество дублей:» задаётся число. Пока у клиента найдено столько карточек или меньше, интеграция создаёт новую, а не обновляет старую. Сделки считаются все, включая закрытые. Для карточки, найденной по связке, дубль не создаётся.
• «Создавать контакт». Включено по умолчанию: интеграция находит контакт по телефону и обновляет имя и email или создаёт новый контакт. Без галочки контакт не создаётся и не привязывается, а email дописывается в название и комментарий карточки.
• «Поиск дублей только по этой стадии». Выключено по умолчанию: карточка ищется во всей воронке, включая закрытые сделки. С галочкой учитываются только карточки на выбранной стадии.
• «Синхронизировать в обе стороны». При сохранении добавляет обратное правило: карточка попала на эту стадию в Битрикс24 — лид встаёт на этот шаг. Отдельная строка в блоке 3 не нужна. Работает, если для шага заведена одна строка.

Пример: бот прозванивает сделки из Битрикс24

Частая схема — менеджер отдаёт сделку на звонок голосовому боту прямо из Битрикс24, а итог разговора возвращается в сделку.

• Блок 3. Стадия «Для прозвона роботом» → шаг, с которого звонит голосовой бот: этот шаг выбран в его «Условиях запуска». Менеджер передвинул сделку — лид встал на шаг, и бот звонит клиенту.
• Блок 4. Шаг «Интерес подтверждён» → стадия «Целевой лид от робота». Бот сам ставит шаг по итогу разговора, и сделка переходит на эту стадию с записью звонка и комментариями.
• Автоответчики. Шаг «Автоответчик», на который бот переводит такие звонки, сопоставьте с отдельной стадией. Так автоответчики не смешаются с целевыми лидами.

Называйте шаги и стадии похоже — тогда связь видна в обеих CRM.

Как сопоставить поля: маппинг Битрикс24 и кабинета

Когда в строке выбрана воронка, под блоком появляется таблица «Соответствие полей для воронки … из Битрикс24 в …» (блок 3) или «Соответствие полей для воронки … в Битрикс24» (блок 4). Маппинг привязан к воронке Битрикс24 и к направлению: у каждой воронки и у «Лиды Битрикс» он свой, а одна и та же воронка в блоках 3 и 4 — это две отдельные таблицы.

1. В «Поле в Битрикс» (блок 3) или в поле кабинета (блок 4) выберите поле, с которого начинается пара.
2. Во втором списке появятся только поля подходящего типа. Под каждым полем видно «Тип поля:», а у списков — «Список значений:».
3. Для списков и полей да/нет заполните «Сопоставление значений:» — каждому значению одной стороны выберите значение другой. Одно значение нельзя выбрать дважды.
4. Следующую пару добавляет «Добавить поле», лишнюю убирает «Удалить». Строка, заполненная наполовину, не даёт сохранить.

В списке полей Битрикс24 — только пользовательские поля (их код начинается с UF_CRM_) и особые пункты. Стандартные название, стадию, телефон, email и контакт сопоставить нельзя: телефон, имя, фамилию и email интеграция передаёт сама — в контакт, а у лида Битрикс24 ещё и в карточку. Поля сделки показываются по настройке карточки этой воронки в Битрикс24. Со стороны кабинета доступны поля типов текст, список, число и дата, включая даты шагов воронки и день рождения.

Какие типы полей можно сопоставить

Поля типов «Привязка к CRM», «Сотрудник» и «Файл» в списках нет: их интеграция не передаёт ни в одну сторону. Пустое значение тоже не отправляется — поле в Битрикс24 при этом не очищается.

«Дата шага» — дата и время, которые клиент назвал для перезвона: голосовой бот записывает её после разговора. Сопоставьте её с полем «Дата и время» Битрикс24, и менеджер увидит в сделке, когда перезвонить. В блоке 3 работает и обратный путь: дата из Битрикс24 приходит в «Дату шага», и бот, который звонит по ней, перезвонит в новое время.

Особые пункты маппинга: сотрудники, сумма, источник, комментарии

• «Сотрудники Битрикс» и сотрудники кабинета. Выберите этот пункт — появятся списки сотрудников с кнопкой «Добавить сотрудника» с каждой стороны. Составьте пары менеджеров. Из кабинета владелец лида становится ответственным в Битрикс24; нет пары — ответственного ставит сам портал. Из Битрикс24 ответственный становится владельцем лида; нет пары — владелец не меняется.
• dealDefaultMoney. Стандартная «Сумма» сделки Битрикс24. Сопоставьте её с числовым полем кабинета: из кабинета сумма уходит в сделку в базовой валюте портала, запятая меняется на точку, из Битрикс24 — приходит в это поле.
• «Источник» → «Источник Битрикса». Только в блоке 4. Передаёт источник карточки, его описание и UTM-метки: utm_source, utm_campaign и utm_term, домен сайта — в utm_content, тип захвата — в utm_medium.
• «Комментарии» → «Комментарии Битрикс». Пункт есть в списке блока 4, но передачу диалога определяют галочка «Передавать комментарии … в карточку» и «Поле Битрикса для комментариев» ниже — о них в следующих разделах.

Из Битрикс24 лид в кабинете получает имя из названия карточки, а без него — из имени контакта. Телефон берётся из карточки или контакта, а если его нет — ищется в названии. Контакт в кабинете создаётся всегда.

Название сделки в Битрикс24: шаблон и подстановки

«Название сделки в Битрикс» — одна настройка на весь проект, она действует на все шаги блока 4. Пусто — название по умолчанию: у сделки — название системы и номер телефона, у лида Битрикс24 — имя, фамилия и телефон. Подстановки вставляет список «+ вставить подстановку…» в место курсора.

Например, шаблон «{fio} — {phone}, заявка {date}» даст «Анна Смирнова — 79001234567, заявка 08.11.2026». Неизвестные подстановки латиницей удаляются, длина названия — до 250 знаков. Новая карточка получает название по шаблону всегда, а у существующей сделки название меняется, только если шаблон задан.

Запись разговора, комментарии и звонки

• «Передавать ссылку на запись разговора в карточку». Включено по умолчанию. Ссылка кладётся в поле UF_CRM_CALL_RECORD_LEAD или UF_CRM_CALL_RECORD_DEAL и отдельным комментарием в ленту: по полю удобно открыть запись в один клик, отбирать сделки и строить отчёты. Сам звонок с записью попадает в ленту карточки всегда, и в новую, и в существующую. Выключайте галочку, только если поле мешает: оно защищает от повторной записи, когда портал не даёт читать карточку.
• «Передавать комментарии … в карточку». Включено по умолчанию: диалог из кабинета попадает в карточку Битрикс24. Снимите галочку — диалог не пишется ни в поле, ни в ленту.
• «Поле Битрикса для комментариев». По умолчанию — «Примечание». В списке только текстовые поля. Диалог дописывается к значению поля, а текст, который в карточке уже есть, повторно не пишется.
• «От кого записывать звонки». Сотрудник, на которого оформляется звонок в карточке. Не выбран — звонок оформляется на администратора портала.
• «Автор действий в Битрикс24». Только показывает, от чьего имени создаются и двигаются сделки. Сменить автора можно одним способом — пересоздать входящий вебхук от имени нужного сотрудника.

Защищённые стадии, остановка бота и синхронизация полей

• «Защищённые стадии: где интеграции разрешено работать». Отметьте стадии, с которыми интеграция работает. С остальными она не делает ничего в обе стороны: не создаёт на них карточку, не переводит туда, не трогает карточку, которая там стоит, и не принимает по ней события. Ничего не отмечено — работает на всех стадиях; воронка без отметок разрешена целиком. Кнопки — «Сохранить область» и «Снять все ограничения».
• «Остановить AI-бота по полю Битрикса». Создайте в карточке лида или сделки Битрикс24 поле типа «Список» (например, «Остановить бота» со значениями «Да» и «Нет») или «Да/Нет». На странице выберите «Где смотреть» (Лид или Сделка), «Поле-триггер» и значения, затем «Сохранить триггер». Когда в карточке выставлено это значение, AI-бот перестаёт писать клиенту. Срабатывает один раз на карточку, связанную с лидом. Вернуть бота — «Запустить бота» в карточке диалога; выключить функцию — «Выключить».
• «Синхронизировать изменения в полях без смены шага». Обычно данные уходят в Битрикс24, только когда лид встал на шаг из блока 4. С галочкой «Включить синхронизацию полей без смены шага» правки полей и записи разговоров доезжают и с других шагов: «На всех шагах без правила» или «Только на отмеченных шагах». Стадия при этом не меняется, новая карточка не создаётся — обновляется только уже связанная. Кнопка — «Сохранить синхронизацию».

Обязательные поля и несколько проектов на одном портале

Если портал отказывается создавать сделку из-за обязательного поля, на странице появится «Битрикс24 не создаёт сделки: не заполнены обязательные поля» со списком полей. Сопоставьте такое поле с полем кабинета в блоке 4 или снимите с него обязательность в Битрикс24. Системное обязательное поле сопоставить нельзя — только снять обязательность в настройках карточки. Пока поле не заполнено, лиды остаются в очереди и отправка повторяется.

Если к одному порталу подключено несколько проектов, страница пишет «На этом портале Битрикса работает ещё …» и показывает их настройки. Настройки у каждого проекта свои и не переносятся. Если правила двух проектов ведут с одной и той же стадии Битрикс24, лид получит только первый проект — разведите стадии.

Как сохранить настройки

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

После повторной авторизации в блоке 1 (в подсказках страницы она называется «Проверить подключение») воронки, поля и сотрудники подгружаются заново, но ничего не записывается: внизу появится «Проверка прошла, но настройки ещё НЕ сохранены.» и кнопка «Сохранить сейчас». Если в Битрикс24 добавили новые поля или воронки, выйдите кнопкой «Выйти» и войдите снова — списки обновятся.

Что передаётся в каждую сторону

Когда данные появляются в Битрикс24 и в кабинете

Из кабинета лид уходит не раньше чем через 15 секунд после последнего изменения: несколько правок одного клиента подряд отправляются одним обновлением. Если Битрикс24 не ответил, отправка повторяется на следующих проходах, создание сделки — до 5 попыток. Задание без движения больше суток снимается и попадает в журнал отклонённых. В очереди проекта одновременно — до 50 лидов.

Из Битрикс24 события приходят сразу, одинаковые события за 3 секунды склеиваются. На один вебхук обрабатывается до 120 событий в минуту — лишние не теряются, а проверяются пакетом раз в минуту. При ошибке отправка повторяется до 10 раз каждые 2 минуты, а при перегрузке портала — каждые 5 минут.

Почему сделка в Битрикс24 заполнена не полностью

1. Поле стандартное: название, стадию, телефон и email интеграция заполняет сама, а остальные стандартные поля, кроме суммы (dealDefaultMoney), не передаёт.
2. Поля нет в карточке этой воронки в Битрикс24 — тогда его нет и в списке. Добавили поле — выйдите и войдите на странице снова.
3. Тип поля не подходит — смотрите таблицу типов выше. «Привязка к CRM», «Сотрудник» и «Файл» не передаются.
4. У списка или поля да/нет не заполнено «Сопоставление значений:».
5. Значение пустое или дата не в виде дд.мм.гггг или дд.мм.гггг чч:мм.
6. Маппинг сделан для другой воронки: у каждой воронки Битрикс24 он свой.
7. Выключено «Создавать контакт» — тогда имени клиента в сделке нет, а email уходит в название и комментарий.
8. Карточка стоит на защищённой стадии или правило ведёт на неё.
9. Портал требует обязательное поле — смотрите предупреждение на странице.
10. У лида нет телефона или в очереди проекта уже 50 лидов.

Ошибка 502 и «File not found» при настройке

«Ошибка: HTTP 502» при загрузке воронок или полей, «Ошибка при проверке…: HTTP 502» и «Ошибка при сохранении настроек интеграции: Error: HTTP 502» значат, что сервер не дождался ответа. Так бывает на больших порталах с множеством воронок и полей: при сохранении все поля загружаются заново. Подождите минуту и повторите действие.

Если после сохранения написано «Настройки интеграции сохранены. Внешний сервис вернул HTTP-код 404» или 502, а в ответе «File not found.» или страница ошибки, настройки записаны, но вебхук в кабинете не поставлен. Нажмите «Сохранить» ещё раз и дождитесь сообщения, что вебхук установлен.

Старый адрес вида …/rest/bitrix/webhook?id=… относится к прежней интеграции через роботы и бизнес-процессы. Для исходящего вебхука он не подходит — берите ссылку только со страницы настройки.

Ошибки прав: ACCESS_DENIED, NO_AUTH_FOUND, OVERLOAD_LIMIT

Ошибки прав видно после входа в блоке 2: открывается окно «Ошибка при записи вебхуков» с пунктами «Обнаружены ошибки прав вебхука».

• insufficient_scope — у вебхука нет нужного права. Добавьте crm, user или telephony во входящий вебхук в Битрикс24 и сохраните его.
• ACCESS_DENIED — «REST API заблокирован или недоступен на вашем тарифе Битрикс24». Проверьте, что ваш тариф Битрикс24 поддерживает REST API.
• NO_AUTH_FOUND — неверный или истёкший токен вебхука. Пересоздайте вебхук в Битрикс24 и вставьте новый адрес в блок 1.
• OVERLOAD_LIMIT — REST API Битрикс24 временно заблокирован из-за перегрузки. Снять блокировку может техподдержка Битрикс24.

Как проверить и отключить синхронизацию с Битрикс24

Проверка: переведите тестового лида с телефоном на шаг из блока 4 и подождите 15 секунд — в Битрикс24 появится карточка на выбранной стадии с названием по шаблону и сопоставленными полями. Затем передвиньте сделку на стадию из блока 3 и проверьте шаг и поля лида в кабинете.

Отдельной кнопки отключения нет. Чтобы остановить передачу в Битрикс24, удалите вебхук интеграции в разделе вебхук crm — «Вебхуки при изменении лида». Чтобы остановить обратное направление, удалите исходящий вебхук в Битрикс24. Входящий вебхук отключает обмен в обе стороны. Чтобы обмен шёл только с частью стадий, отметьте их в «Защищённых стадиях».

Читайте также: Интеграция с Битрикс24, Вебхук CRM, Интеграция голосового робота с CRM, Дубли лидов в CRM