Интеграция с 1С-Битрикс

Веб-формы и заказы магазина в CRM с источником визита. Скачать, установить и настроить.

Модуль передаёт в Linkodium CRM заявки из веб-форм и новые заказы магазина вместе с источником визита и ставит на страницы сайта общий код CRM. Работает с редакциями 1С-Битрикс: Управление сайтом, где есть модули «Веб-формы» или «Интернет-магазин», и с композитным кешем.

Скачать: linkodium-crm-bitrix.zip, версия 2.0.0 от 10 ноября 2026. Нужны PHP 7.4 или новее и расширение curl.

1. Ключ API

В CRM откройте «Настройки компании» → «API-ключи» и нажмите «Выпустить ключ».
Выберите сотрудника и отметьте область «Создание заявок» (leads:create).
Скопируйте ключ: он показывается один раз и начинается с crm_.

Ключ работает с правами выбранного сотрудника. Выпускайте его владельцу, администратору или сотруднику с правом «Менять статус, в том числе отмечать спам»: заявки со ссылками в сообщении модуль передаёт с этапом «Спам», и без этого права CRM их не примет. Кому назначаются заявки с ключа, рассказано в документации API.

2. Общий код CRM

Откройте «Настройки компании» → «Трекинг».
В разделе «Сайты» добавьте адрес сайта. Если сайт открывается и с www., и без него без переадресации, добавьте оба адреса.
В разделе «Код на сайт» найдите адрес вида https://crm.linkodium.com/lks/КЛЮЧ.js. Часть КЛЮЧ (20 латинских букв и цифр) и есть публичный ключ общего кода.

Код вставлять в шаблон не нужно: модуль ставит его на все страницы сам. Он добавляет в формы скрытое поле lkt_token (метка визита), заполняет поля utm_* и ym_client_id, если они есть в форме, и подключает модули, выбранные в CRM: антиспам и чат на сайте. Подробнее: Сквозная аналитика.

3. Установка и обновление

Распакуйте архив и загрузите папку linkodium.analytics в /local/modules/ сайта (по FTP или в панели хостинга). Владельцем файлов должен быть пользователь сайта.
В админке откройте «Marketplace» → «Установленные решения», найдите «Linkodium CRM» и нажмите «Установить».

Обновление. Замените файлы в /local/modules/linkodium.analytics файлами из нового архива. Переустанавливать модуль не нужно: обработчики событий и настройки сохраняются. Название папки прежнее, поэтому модуль версий 1.x, который назывался «Linkodium Analytics», обновляется так же.

4. Настройки модуля

Откройте «Настройки» → «Настройки продукта» → «Настройки модулей» → «Linkodium CRM».

Настройка	Что задать
Ключ API Linkodium CRM	Ключ из шага 1. После сохранения поле пустое, видно только начало ключа: сам ключ хранится в настройках сайта и в код страниц не попадает
Отправлять заявки в Linkodium CRM	Включено
Публичный ключ общего кода CRM	Ключ из шага 2
Общий код CRM на страницах сайта	Включено. Если код CRM уже вставлен в шаблон вручную, выключите, чтобы код не стоял дважды
Заявки из веб-форм, новые заказы с сайта	Что отправлять в CRM
Скрипт визита	Включено: из него заявка получает страницу входа и реферер
Не отправлять веб-формы	Символьные коды (SID) форм через запятую. По умолчанию исключены резюме, отзывы и «Намекнуть другу» (формы шаблонов Аспро)

Кнопка «Сохранить и отправить тестовую заявку в CRM» создаёт заявку «ТЕСТ Linkodium, удалить» на этапе «Спам» и показывает её номер. После проверки отправьте её в архив. Если на сайте включён композитный кеш, очистите его, чтобы общий код появился на всех страницах.

5. Что уходит в CRM

Веб-формы. Результат формы, который сохранил посетитель сайта:

имя из поля с кодом CLIENT_NAME, NAME или FIO, телефон из поля, в коде которого есть PHONE, email из поля с EMAIL;
сообщение из текстовых полей (MESSAGE, QUESTION, COMMENT и любые многострочные), остальные поля с подписями добавляются к сообщению;
название формы становится потребностью клиента.

Заказы. Только новые заказы, оформленные посетителем: покупатель (имя, телефон, email из свойств заказа), «Заказ № на сумму», до 10 позиций корзины и комментарий покупателя.

С каждой заявкой уходят страница заявки, страница входа (с метками UTM), реферер, IP-адрес и браузер посетителя, ClientID Яндекс Метрики, метка визита lkt_token. Источник заявки «Сайт ваш-домен».

Не отправляется то, что делает не посетитель: действия в админке, консоль, агенты и cron, обмен с 1С, REST.

Заявка уходит после ответа посетителю, поэтому медленный ответ CRM на скорость сайта не влияет. У каждой заявки свой номер (bx:домен:form:ID или bx:домен:order:ID), он же ключ идемпотентности: при повторе запроса вторая заявка не появится.

6. Спам и антиспам

Ссылка в сообщении. Если включена настройка «Заявка со ссылкой в тексте сообщения: спам», такая заявка уходит в CRM сразу на этап «Спам» без уведомлений. Ссылки в отдельных полях (например, «Ссылка на товар») не учитываются.
Антиспам CRM включается в «Настройки компании» → «Трекинг», блок «Модули скрипта». Заявки модуля проверяются: в них есть метка визита и страница заявки. Скрытое поле-ловушку lkt_hp модуль тоже передаёт. Подробнее: Антиспам.
Не проверять. Чтобы антиспам CRM не проверял заявки этого сайта, на вкладке «API-ключи» нажмите у его ключа «Не проверять заявки на спам».

7. Журнал

Файл logs/linkodium-analytics.log в корне хостинга, вне папки сайта. Режимы: «только ошибки» (по умолчанию), «все отправки» и «выключен». В журнале номер заявки CRM или код ошибки. Ключ API в журнал не пишется, телефон обрезается.

8. Частые проблемы

Что видно	Что делать
В журнале «нет ключа API или отправка выключена»	Сохраните ключ API и включите «Отправлять заявки в Linkodium CRM».
В журнале `http=401`	Ключ отозван или сотрудник ключа отключён. Выпустите новый ключ и сохраните его в настройках модуля.
В журнале `http=403` у заявок со статусом «Спам»	У сотрудника ключа нет права «Менять статус, в том числе отмечать спам». Дайте право или выпустите ключ администратору.
Заявок с формы нет, журнал пуст	Проверьте, что форма не в списке «Не отправлять веб-формы» и что сайт сохраняет результаты формы в модуль «Веб-формы».
Заявки приходят без визита, в форме нет поля `lkt_token`	Проверьте публичный ключ и галочку «Общий код CRM», очистите кеш, добавьте сайт в список «Сайты». Если на сайте есть заголовок Content-Security-Policy, разрешите `https://crm.linkodium.com` в `script-src` и `connect-src`.

9. Версии

2.0.0, 10 ноября 2026. Модуль называется «Linkodium CRM», идентификатор прежний. Заявки уходят только в Linkodium CRM: прежняя отправка в a.linkodium.com выключена и убрана со страницы настроек. На странице настроек подсказки и ссылка на справку, в журнале ошибка, если заявку некуда отправить.
1.1.0, 10 ноября 2026. Отправка в Linkodium CRM с ключом идемпотентности, общий код CRM на страницах, метка визита, UTM и ClientID, спам на этап «Спам».
1.0.2, 8 ноября 2026. Веб-формы и заказы, скрипт визита, спам-фильтр, журнал.

Плагин для сайтов на WordPress: Интеграция с WordPress (Contact Form 7).