Интеграция с Битрикс24

Как выбрать способ интеграции

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

Второй — готовый модуль или плагин для вашей CMS. Для 1С-Битрикс и WordPress такие решения есть, и для стандартного сайта с парой форм их может быть достаточно. Ограничения проявляются, когда форм много, нужны свои поля, распределение по менеджерам или передача заказов с составом товаров: модуль делает то, что заложил его автор, и не больше.

Третий — интеграция через REST API, когда сайт сам отправляет данные в CRM по вашим правилам. Этот вариант требует больше разработки, зато работает с любой CMS и самописным сайтом, позволяет передавать произвольные поля, проверять дубли, выбирать воронку и ответственного, а также получать данные обратно из CRM. Его же я использую, когда нужно логировать каждую отправку.

Выбор зависит от того, сколько форм на сайте, есть ли интернет-магазин и как устроена ваша воронка. Часто подходы комбинируются: простые формы работают через модуль, а заказы и сложные сценарии — через API. После разбора задачи предложу вариант, который закрывает ваши сценарии без лишней разработки. Если позже понадобится больше возможностей, интеграцию через API можно добавить к уже работающему модулю.

Общие принципы связки сайта и CRM, а также вопросы, которые стоит решить до начала, я разбирал в статье «Интеграция сайта с CRM». Она пригодится, если вы ещё выбираете, что именно передавать и как распределять заявки.

Типичные ошибки интеграции

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

Вторая — не передавать источник. Если UTM-метки и страница входа не сохраняются вместе с заявкой, CRM знает о клиенте всё, кроме того, откуда он пришёл. Тогда невозможно понять, какая реклама окупается. Метки нужно сохранить при первом заходе посетителя и передать в CRM при отправке формы, даже если между этими моментами он открыл несколько страниц.

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

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

И наконец, отсутствие журнала отправок. Без него невозможно ответить на вопрос «куда делась заявка»: была ли она отправлена, дошла ли до CRM и что ответил сервер. Журнал занимает немного места и окупается при первом же разбирательстве. К тому же по журналу видно, если какая-то форма перестала отправлять данные после правок на сайте, и проблему можно исправить до того, как потеряются десятки обращений.

Типовые задачи интеграции с Битрикс24: что делаю и сколько это занимает

Ниже — запросы, с которыми обращаются чаще всего, и что за ними стоит технически. Время — ориентир при ставке 2 000 ₽/ч; методы, которые использую, описаны в моём справочнике REST API Битрикс24.

1. «Заявки с форм на WordPress должны создавать лиды в Битрикс24».Подключаюсь к событию отправки формы (для Contact Form 7 — wpcf7_before_send_mail), передаю данные через входящий вебхук методом crm.lead.add или crm.deal.add, а сам запрос выношу в фоновую очередь, чтобы посетитель не ждал ответа CRM.3–5 формот 6 чот 12 000 ₽
2. «Заказ из магазина должен приходить сделкой с товарами, а не текстом в комментарии».Создаю сделку и передаю строки товаров методом crm.deal.productrows.set — с привязкой к каталогу CRM по артикулу или просто названием, ценой и количеством. Доставку добавляю отдельной строкой, способ оплаты и адрес — в пользовательские поля сделки.от 12 чот 24 000 ₽Вместе с проверкой скидок и округлений.
3. «Покупатель должен видеть в личном кабинете, что заказ передан в доставку».Регистрирую обработчик события изменения сделки (onCrmDealUpdate). Портал присылает только ID, поэтому сайт сам запрашивает сделку через crm.deal.get, проверяет токен приложения и сопоставляет стадию воронки со статусом заказа.от 8 чот 16 000 ₽
4. «В CRM у всех лидов источник «Сайт» — непонятно, какая реклама работает».Заполняю стандартные поля UTM_SOURCE, UTM_MEDIUM, UTM_CAMPAIGN, UTM_CONTENT и UTM_TERM, а источник (SOURCE_ID) выбираю из справочника портала по метке или рефереру. При необходимости передаю ClientID Яндекс Метрики, чтобы потом связать сделки с визитами.от 3 чот 6 000 ₽Если формы уже подключены.
5. «Интеграция работала и перестала — заявки молча пропадают».Частая причина — вебхук создан от имени сотрудника, которого уволили: после деактивации пользователя он перестаёт работать. Ещё смотрю ответы портала — превышение лимита запросов (QUERY_LIMIT_EXCEEDED), ошибки доступа, ограничения тарифа — и переношу интеграцию на служебного пользователя или локальное приложение. Если журнала отправок нет, сначала добавляю его.диагностикаот 2 чот 4 000 ₽
6. «Синхронизировать товары и остатки между сайтом и CRM».Использую методы каталога CRM и пакетные запросы batch — до 50 команд за вызов: облачный портал ограничивает частоту запросов, и при поштучной отправке каталог в несколько тысяч позиций обновляется очень долго. Заранее определяю, какая система главная для цен и остатков, чтобы данные не перезаписывали друг друга.от 16 чот 32 000 ₽Срок — 2–3 недели с проверкой.