Loading...

Как передать лид из формы сайта в CRM bitrix24

Основной материал взят отсюда

Задача: При отправке через форму обратной связи или при заказе звонка с обычной формы на php создавать лид в CRM системе Битрикс24



Нам понадобится

  • Файл php, отвечающий за обработку данных из формы (например, "mail.php" или "action.php")
  • Созданный вебхук в Битрикс24 (Приложения - вебхуки - создать - Входящий вебхук)
  • Код формирования лида
Предположим, что в нашей форме 3 поля: Имя, Телефон, Почта, которые нам необходимо передать в Битрикс24

Быстрый ответ (скопировал-вставил)

Для того, чтобы все заработало, нужно:

  • скопировать код, вставить его в свой файл обработки (* в самом начале)
  • заменить в ссылке параметры на свои (адрес портала, id пользователя, вебхук)
  • проставить свои названия полей в значениях ["name"], ["phone"], ["email"]
Если каких-то полей в форме нет, например,["message"] или ["UTM_CALLBACK"], лид будет создан в любом случае, это никак не повлияет на передачу других параметров.
 
    
// определяем URL 
$Url = 'https://[ИМЯ].bitrix24.ru/rest/[id пользователя]/[код вебхука]/crm.lead.add.json';
// описываем параметры лида 
$ParamLid = http_build_query(array(
  'fields' => array(
    'TITLE' => str_replace(" "," ",$_POST["name"]), // НАЗВАНИЕ
    'NAME' => str_replace(" "," ",$_POST["name"]), // ИМЯ
 'PHONE' => Array(
           "n0" => Array(
               "VALUE" => str_replace(" ","",$_POST["phone"]),
               "VALUE_TYPE" => "WORK",
           )), // РАБОЧИЙ ТЕЛЕФОН в массиве
'OPENED' => 'Y', // Доступно для всех
'SOURCE_ID' => "WEB", //Источник вебсайт
'COMMENTS' => str_replace(" "," ",$_POST["message"]), // Комментарий клиента
'SOURCE_DESCRIPTION' => str_replace(" ","",$_POST["UTM_CALLBACK"]), // доп. описание источника
'EMAIL' => Array(
           "n0" => Array(
               "VALUE" => str_replace(" ","",$_POST["email"]),
               "VALUE_TYPE" => "WORK",
           ),
       ), // Рабочая эл. почта
'WEB' =>  "site", // UTM метка
'UTM_SOURCE' => "CALLBACK", //Источник вебсайт
'ASSIGNED_BY_ID' => 1, // Ид ответственного
 
  ),
  'params' => array("REGISTER_SONET_EVENT" => "Y")
));
// обращаемся к сформированному URL при помощи функции curl_exec для создания лида
$ch = curl_init();
curl_setopt_array($ch, array(
  CURLOPT_SSL_VERIFYPEER => 0,
  CURLOPT_POST => 1,
  CURLOPT_HEADER => 0,
  CURLOPT_RETURNTRANSFER => 1,
  CURLOPT_URL => $Url,
  CURLOPT_POSTFIELDS => $ParamLid,
));
$result2 = curl_exec($ch);
curl_close($ch);
    
* Для проверки работоспособности способа скопируйте ссылку со своими параметрами, и просто вставьте ее в адресную строку, нажмите энтер - в Битрикс24 будет создан лид без заполненных полей
https://[ИМЯ].bitrix24.ru/rest/[id пользователя]/[код вебхука]/crm.lead.add.json

Еще момент с кодом для таких же чайников в php как и я - вот это " ","",$_POST["phone"] убирает пробелы между символами.

 
    
"VALUE" => str_replace(" ","",$_POST["phone"]),
    

Например, если передать так поле ["name"], при условии, что посетитель при отправке написал "Евгений Гаврилов" в поле Имя, в Битрикс24 придет так: ЕвгенийГаврилов (одним словом, т.к. пробел удалится).

Параметры для передачи в Битрикс24

Оглавление

Таблица 1: Параметры для лидов

 

ПАРАМЕТР ТИП ОПИСАНИЕ ПРИМЕЧАНИЕ
LOGIN String Логин Обязательное поле только при использовании упрощенного Rest API
PASSWORD String Пароль Обязательное поле только при использовании упрощенного Rest API
TITLE String Заголовок лида Обязательное поле
HONORIFIC String Тип обращения к клиенту  
NAME String Имя клиента  
LAST_NAME String Фамилия клиента  
SECOND_NAME String Отчество клиента  
BIRTHDATE date Дата рождения клиента  
ADDRESS String Адрес клиента  
ADDRESS_2 String Вторая строка адреса клиента В некоторых странах принято разбивать адрес на 2 части
ADDRESS_CITY String Город клиента  
ADDRESS_COUNTRY String Страна клиента  
ADDRESS_COUNTRY_CODE String Код страны клиента  
ADDRESS_POSTAL_CODE String Почтовый индекс клиента  
ADDRESS_PROVINCE String Регион клиента  
ADDRESS_REGION String Район клиента  
COMPANY_ID crm_company Привязка лида к компании Только для чтения
COMPANY_TITLE crm_company Название компании, привязанной к лиду  
CONTACT_ID crm_company Привязка лида к контакту Только для чтения
POST String Должность клиента  
COMMENTS String Комментарий клиента  
SOURCE_DESCRIPTION String Дополнительно о статусе  
STATUS_DESCRIPTION String Дополнительно об источнике  
OPPORTUNITY Double Возможная сумма сделки  
CURRENCY_ID String Валюта Статус из справочника
PRODUCT_ID String Продукт Статус из справочника
SOURCE_ID String Источник Статус из справочника
STATUS_ID String Статус Статус из справочника
ASSIGNED_BY_ID user Ответственный за клиента  
PHONE_WORK String Рабочий телефон  
PHONE_MOBILE String Мобильный телефон  
PHONE_FAX String Номер факса  
PHONE_HOME String Домашний телефон  
PHONE_PAGER String Номер пейджера  
PHONE_OTHER String Другой телефон  
WEB_WORK String Корпоративный сайт  
WEB_HOME String Личная страница  
WEB_FACEBOOK String Страница Facebook  
WEB_LIVEJOURNAL String Страница LiveJournal  
WEB_TWITTER String Микроблог Twitter  
WEB_OTHER String Другой сайт  
EMAIL_WORK String Рабочий e-mail  
EMAIL_HOME String Частный e-mail  
EMAIL_OTHER String Другой e-mail  
M_SKYPE String Контакт Skype  
IM_ICQ String Контакт ICQ  
IM_MSN String Контакт MSN/Live!  
IM_JABBER String Контакт Jabber  
IM_OTHER String Другой контакт  
UTM_CAMPAIGN String Обозначение рекламной кампании  
UTM_CONTENT String Содержание кампании  
UTM_MEDIUM String Тип трафика  
UTM_SOURCE String Рекламная система  
UTM_TERM String Ключевое слова/условия поиска  

Таблица 2: STATUS_ID – Статусы для лидов

ЗНАЧЕНИЕ НАЗВАНИЕ
NEW Не обработан
ASSIGNED Назначен ответственный
DETAILS Уточнение информации
CANNOT_CONTACT Не удалось связаться
IN_PROCESS В обработке
ON_HOLD Обработка приостановлена
RESTORED Сконвертирован
CONVERTED Восстановлен
JUNK Некачественный лид

Таблица 3: SOURCE_ID – Источники

ЗНАЧЕНИЕ НАЗВАНИЕ
SELF Свой контакт
PARTNER Существующий клиент
CALL Звонок
WEB Веб-сайт
EMAIL Электронная почта
CONFERENCE Конференция
TRADE_SHOW Выставка
EMPLOYEE Сотрудник
COMPANY Кампания
HR HR — департамент
MAIL Письмо
OTHER Другое

Таблица 4: PRODUCT_ID – Продукты

ЗНАЧЕНИЕ НАЗВАНИЕ
PRODUCT_1 1С-Битрикс: Управление сайтом
PRODUCT_2 1С-Битрикс: Корпоративный портал
OTHER Другое

Таблица 5: CURRENCY_ID – Валюты

ЗНАЧЕНИЕ НАЗВАНИЕ
RUB Рубль
USD Доллар США
EUR Евро



1124