13 сентября 2019 1С-Битрикс Битрикс24
Возникла задача интеграции лендинга с 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