Практически любой владелец сайта, у которого имеется Битрикс24 задается вопросом: "Как автоматически добавлять лиды в CRM с моего сайта?" или
"Как интегрировать Битрикс с Битрикс 24?".
У Битрикс 24 существует как минимум три автоматизированных основных способа:
В этой статье мы решили рассмотреть метод создания лидов Методами Rest API, в которых будем использовать так называемые "Вебхуки".
Лид – это потенциальный контакт, тем или иным образом отреагировавший на маркетинговую коммуникацию.
Человек, заполняющий форму обратной связи у вас на сайте, после отправки становится лидом, то есть вашим потенциальным клиентом. Чем быстрее будет встречная реакция на новый лид, тем больше шанс, что он превратится в вашего клиента!
Любой из вышеуказанных способов автоматизирует процесс создания лида в CRM. Если вам нужно создавать лид из любого стороннего сайта/сервиса, вы можете воспользоваться вебхуками. Наш пример рассматривает отправку нового лида из формы обратной связи.
Тут возникает вопрос: "Мы ведь можем воспользоваться стандартными веб-формами Битрикс24?". Можем! Но если у вас свои формы обратной связи, которые уже работают или сильно отличаются от стандартных веб-форм, то тут нужно использовать Вебхуки. Именно они помогут сделать интеграцию с сайтом.
WebHooks - упрощенный вариант rest-событий и rest-команд, без написания приложения.
А если русским языком: механизм оповещения системы о событиях.
Ниже пример отправки лида в Битрикс 24 после отправки формы обратной связи.
Предполагается, что после заполнения формы, создается элемент инфоблока "Обратная связь". Тут именно код обработчика, который будет подключен в /local/php_interface/init.php:
AddEventHandler("iblock", "OnAfterIBlockElementAdd", Array("CRestApi", "generateLead")); /** * Класс, включающий в себя методы Rest API */ class CRestApi { function generateLead(&$arFields) { if($arFields[IBLOCK_ID] == IBLOCK_FEEDBACK_ID) { CModule::IncludeModule("iblock"); $webhook = 'https://yoururl.bitrix24.ru/rest/7/YOUR_WEBHOOK_CODE/'; /* Webhook*/ $queryUrl = $webhook.'crm.lead.add.json'; // Строка обращения к вебхуку if(isset($arFields["PROPERTY_VALUES"]["SOURCE"])) { $sourсe = '['.strtolower($arFields["PROPERTY_VALUES"]["SOURCE"]).']'; } else { $sourсe = ''; } // REST Api $queryData = http_build_query(array( // Передаем данные 'fields' => array( 'TITLE' => $arFields["NAME"].' (www.redsgroup.ru) '.$sourсe, 'NAME' => $arFields["PROPERTY_VALUES"]["FIO"], 'PHONE' => array(array("VALUE" => preg_replace("/[^,.0-9]/", '', $arFields["PROPERTY_VALUES"]["PHONE"]), "VALUE_TYPE" => "WORK" )), 'PHONE_WORK' => preg_replace("/[^,.0-9]/", '', $arFields["PROPERTY_VALUES"]["PHONE"]), 'EMAIL' => array(array("VALUE" => $arFields["PROPERTY_VALUES"]["EMAIL"], "VALUE_TYPE" => "WORK" )), 'EMAIL_WORK' => $arFields["PROPERTY_VALUES"]["EMAIL"], 'COMMENTS' => $arFields["PROPERTY_VALUES"]["PHONE"].' '.$arFields["PROPERTY_VALUES"]["EMAIL"].'
Лид сгенерирован автоматически. Источник: redsgroup.ru.
'.$arFields["PROPERTY_VALUES"]["COMMENT"], 'SOURCE_ID' => 'WEB', //'ASSIGNED_BY_ID ' => 7, ) )); $curl = curl_init(); // метод cURL curl_setopt_array($curl, array( CURLOPT_SSL_VERIFYPEER => 0, CURLOPT_POST => 1, CURLOPT_HEADER => 0, CURLOPT_RETURNTRANSFER => 1, CURLOPT_URL => $queryUrl, CURLOPT_POSTFIELDS => $queryData, )); $result = curl_exec($curl); curl_close($curl); /* Webhook*/ } } }
В классе CRestApi мы написали функцию generateLead(), которая вызывается при событии OnAfterIBlockElementAdd (после создания элемента инфоблока). Она получает все поля заполненной формы обратной связи и отправляет данные методом RestAPI - crm.lead.add.json. Подобным способом мы можем создать контакт или компанию, но нужно использовать другую функцию Rest API. Все методы описаны в документации.
В меню Битрикс24 переходим: Приложения → Вебхуки → Добавить вебхук (входящий вебхук)
При создании даём права только на CRM!
После создания получаем код вебхука, который можно применять в наших Rest-запросах:
Полезные ссылки по материалу:
Мы дарим всем своим посетителям один промокод на выбор для вашего Битрикс 24:
REDS_5GB – Дополнительные 5Гб в облаке на один годREDS24 – 12 дополнительных пользователей
Подробнее: Битрикс 24 Промокод