Интеграция Битрикс24 с сайтом через PHP

bitrix24-3914739

Возникла задача интеграции лендинга с CRM Битрикс24. Лендинг самый обычный на HTML. Необходимо было создавать лиды из отправляемых с сайта форм обратной связи.

В формах была отправка не только данных о пользователе — имя, телефон и e-mail, но и передача нескольких нестандартных значений — название выбранного товара и пользовательский текст.

Нужно учитывать, что для создания лида в Битрикс24 поле Заголовок и Имя обязательно. Остальные поля заполняются по необходимости. Поле телефон и e-mail стандартные, а название товара и текст было решено передавать в пользовательский комментарий к лиду.

PHP скрипт для создания лида в CRM Битрикс24

В CRM 1C-Битрикс формы, созданные через модуль форм подключаются проще простого, достаточно включить это в настройках. Но и тут на деле все оказалось довольно просто. У Битрикс существует REST API, с помощью которого можно передавать лиды через PHP скрипт. И использовать популярную CRM для любого сайта.

Поле название товара передается через скрытый input в форме

И при отправке в CRM к нему добавляется комментарий, если он заполнен.

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

Стандартные имена ключей для полей Битрикс24

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

TITLE — название лида
NAME — имя
LAST_NAME — фамилия
SECOND_NAME — отчество
PHONE_WORK — рабочий телефон
PHONE_MOBILE — мобильный телефон
PHONE_HOME — домашний телефон
EMAIL_WORK — рабочий e-mail
EMAIL_HOME — личный e-mail
ADDRESS — адрес
COMMENTS — комментарий
COMPANY_TITLE — название компании
WEB_HOME — личная страница
WEB_WORK — корпоративный сайт
IM_OTHER — другой контакт

Передача значения в пользовательское поле Битрикс24 из PHP скрипта

Для начала необходимо создать пользовательское поле в самой CRM:

  • Зайти в раздел CRM → Настройки → Настройки форм и отчетов → Пользовательские поля → Лид и Добавить поле
  • Указать название поля
  • Установить галочку «Показывать в списке»
  • Выбрать тип поля, например «Строка»
  • Сохранить

Далее в массиве $postData добавить новое значение 'UF_CRM_XXXXXXXXXX' => $customField,
где XXXXXXXXXX — это ID пользовательского поля

$postData = array(
      'TITLE' => 'Заявка с сайта', // Заголовок для лида
      'NAME' => $name, // Имя
      'PHONE_WORK' => $phone, // Телефон
      'EMAIL_WORK' => $usermail, // E-mail
      'COMMENTS' => $product.' '.$comment, // Пользовательский комментарий
      'UF_CRM_XXXXXXXXXX' => $customField, // Пользовательское поле
   );

Как узнать ID пользовательского поля?

Чтобы узнать ID пользовательского поля, нужно:

  • Зайти в раздел CRM → Настройки → Настройки форм и отчетов → Пользовательские поля → Лид и Список поле
  • В списке найти нужное поле и перейти в него

В адресной строке, вы увидите значение UF_CRM_XXXXXXXXXX https://login.bitrix24.ru/crm/configs/fields/CRM_LEAD/edit/UF_CRM_XXXXXXXXXX/ , где UF_CRM_XXXXXXXXXX — это и есть ID

Читайте также: