Crm configs import deal php

Создание сделок по аналогии лидов /crm/configs/import/lead.php

Здравствуйте,
Есть коробочная версия,
Есть документация https://dev.1c-bitrix.ru/api_help/crm/index.php
Есть раздел Сделки, там все ссылки в этом разделе ведут на 404
Есть компонент crm.deal.edit, но это компонент а не API.

Вопрос, как мне сделать роутер, куда я буду обращаться со сторонних ресурсов, по аналогии как здесь /crm/configs/import/lead.php ?
Т.е. есть ли API по созданию сделок, куда я буду обращаться через POST или GET?

Для этого нужно писать полноценное приложение с 0Auth авторизацией, и через него создавать результат конкретной crm-формы в Битрикс 24?
Другого пути нет, чтобы создать результат конкретной crm-формы либо создание сделки?

Цитата
Максим Зелёнкин написал: Для этого нужно писать полноценное приложение с 0Auth авторизацией, и через него создавать результат конкретной crm-формы в Битрикс 24?

Продукты

Управление сайтом

Битрикс24

Интернет-магазин + CRM

Решения

Для интернет-магазинов

Каталог готовых решений

Внедрение

Выбрать партнера

Проверить партнера

Стать партнером

1С-Битрикс http://www.1c-bitrix.ru Общие вопросы info@1c-bitrix.ru Приобретение и лицензирование продуктов : sales@1c-bitrix.ru Маркетинг/мероприятия/PR marketing@1c-bitrix.ru Партнерская программа partners@1c-bitrix.ru Мы работаем с 10:00 до 19:00 по московскому времени. Офис в Москве 127287 Россия Московская область Москва 2-я Хуторская улица дом 38А строение 9 Офис в Калининграде +7 (4012) 51-05-64 Офис в Калининграде 236001 Россия Калининградская область Калининград Московский проспект 261 Офис в Киеве ukraine@1c-bitrix.ru Телефон в Киеве +3 (8044)221-55-33 Офис в Киеве 01033 Украина Калининградская область Киев улица Шота Руставели 39/41 офис 1507

© 2001-2023 «Битрикс», «1С-Битрикс». Работает на 1С-Битрикс: Управление сайтом. Политика конфиденциальности

Источник

Форум

Здравствуйте,
Есть коробочная версия,
Есть документация https://dev.1c-bitrix.ru/api_help/crm/index.php
Есть раздел Сделки, там все ссылки в этом разделе ведут на 404
Есть компонент crm.deal.edit, но это компонент а не API.

Вопрос, как мне сделать роутер, куда я буду обращаться со сторонних ресурсов, по аналогии как здесь /crm/configs/import/lead.php ?
Т.е. есть ли API по созданию сделок, куда я буду обращаться через POST или GET?

Для этого нужно писать полноценное приложение с 0Auth авторизацией, и через него создавать результат конкретной crm-формы в Битрикс 24?
Другого пути нет, чтобы создать результат конкретной crm-формы либо создание сделки?

Цитата
Максим Зелёнкин написал: Для этого нужно писать полноценное приложение с 0Auth авторизацией, и через него создавать результат конкретной crm-формы в Битрикс 24?

Центр поддержки

Продукты

Управление сайтом

Битрикс24

Интернет-магазин + CRM

Решения

Для интернет-магазинов

Каталог готовых решений

Внедрение

Выбрать партнера

Проверить партнера

Стать партнером

1С-Битрикс http://www.1c-bitrix.ru Общие вопросы info@1c-bitrix.ru Приобретение и лицензирование продуктов : sales@1c-bitrix.ru Маркетинг/мероприятия/PR marketing@1c-bitrix.ru Партнерская программа partners@1c-bitrix.ru Мы работаем с 10:00 до 19:00 по московскому времени. Офис в Москве 127287 Россия Московская область Москва 2-я Хуторская улица дом 38А строение 9 Офис в Калининграде +7 (4012) 51-05-64 Офис в Калининграде 236001 Россия Калининградская область Калининград Московский проспект 261 Офис в Киеве ukraine@1c-bitrix.ru Телефон в Киеве +3 (8044)221-55-33 Офис в Киеве 01033 Украина Калининградская область Киев улица Шота Руставели 39/41 офис 1507

© 2001-2023 «Битрикс», «1С-Битрикс». Работает на 1С-Битрикс: Управление сайтом. Политика конфиденциальности

Источник

Bitrix24 лиды с сайта — автоматическое создание лидов

Как добавлять в Bitrix24 лиды с сайта? Данным вопросом начинают задаваться многие, так как с каждым днем CRM Битрикс24 набирает популярность среди вебмастеров и владельцев сайтов. И у многих встает вопрос, как же организовать автоматическое создание лидов с сайта в CRM Битрикс24, если Вы не используете одноименную CMS.
Для этого давайте рассмотрим два способа:

1. Bitrix24 лиды с сайта через упрощенный Rest API
2. Вебхуки Bitrix24 — передача лидов с сайта — Рекомендую

См. также публикацию на тему:

Автоматическое создание лидов в Битрикс24 через упрощенный Rest API

Данный способ, команда Битрикс24, разработала специально для всех сторонних источников, не входящие в продукты Битрикс. Заключается он в том, что по адресу [ваше_название].bitrix24.ru/crm/configs/import/lead.php находится специальный компонент lead.rest , который позволяет обрабатывать и добавлять в Bitrix24 лиды с сайта из других источников.

Для того, чтобы организовать автоматическое создание лидов в Битрикс24 Вам необходимо:

Логин и пароль пользователя Вашей CRM

Логин и пароль пользователя Вашей CRM

Так как логин и пароль пользователя из-под которого будут создаваться лиды указываются в скрипте, то для безопасности рекомендуется использовать отдельного пользователя с правами только на добавление лида и без доступа куда-либо еще. Данная мера необходима для безопасности Ваших данных, на тот случай, если каким-то образом PHP скрипт для отправки данных в Битрикс 24 окажется у злоумышленников.

PHP скрипт для отправки данных

В Bitrix24 лиды с сайта можно передавать PHP скриптом, который приведен ниже. При этом для автоматического создания лидов, необходимо передать 3 обязательных параметра:

• LOGIN* — логин пользователя Вашей CRM по управлению лидами.
• PASSWORD* — пароль пользователя Вашей CRM по управлению лидами.
• TITLE* — заголовок для лида.

все остальные параметры являются не обязательными и не подлежат обязательной передаче. Однако советую Вам передавать как можно больше данных в лиде: email, телефон, комментарий, utm метки и многое другое (см. все параметры для формирования лидов).

define('CRM_HOST', '[ваше_название].bitrix24.ru'); // Ваш домен CRM системы define('CRM_PORT', '443'); // Порт сервера CRM. Установлен по умолчанию define('CRM_PATH', '/crm/configs/import/lead.php'); // Путь к компоненту lead.rest define('CRM_LOGIN', 'login'); // Логин пользователя Вашей CRM по управлению лидами define('CRM_PASSWORD', 'password'); // Пароль пользователя Вашей CRM по управлению лидами $postData = array( 'TITLE' => '' // Установить значение ); if (defined('CRM_AUTH')) < $postData['AUTH'] = CRM_AUTH; >else < $postData['LOGIN'] = CRM_LOGIN; $postData['PASSWORD'] = CRM_PASSWORD; >$fp = fsockopen("ssl://".CRM_HOST, CRM_PORT, $errno, $errstr, 30); if ($fp) < $strPostData = ''; foreach ($postData as $key =>$value) $strPostData .= ($strPostData == '' ? '' : '&').$key.'='.urlencode($value); $str = "POST ".CRM_PATH." HTTP/1.0\r\n"; $str .= "Host: ".CRM_HOST."\r\n"; $str .= "Content-Type: application/x-www-form-urlencoded\r\n"; $str .= "Content-Length: ".strlen($strPostData)."\r\n"; $str .= "Connection: close\r\n\r\n"; $str .= $strPostData; fwrite($fp, $str); $result = ''; while (!feof($fp)) < $result .= fgets($fp, 128); >fclose($fp); $response = explode("\r\n\r\n", $result); $output = '
'.print_r($response[1], 1).'
 
'; > else
 
И умение перехватывать данные из форм
 
В случаи успешной обработки формы, Вам необходимо перехватить и передать нужные Вам значения с помощью вышеприведенного php скрипт в $postData = array() .
 
По умолчанию, обязательным параметром для заполнения является Title, значение которого будет названием для лида в Битрикс24. Все остальные параметры Вы можете передавать на свое усмотрение (см.таблицы с параметрами).
 
Данные параметры из «Таблица 1: Параметры для лидов», отвечают за передачу данных в стандартные поля Битрикс24. Если у Вас есть поля, которые Вы самостоятельно создали в Битрикс24, и Вам необходимо передавать для них значение с сайта вместе с лидами, то предлагаю Вам ознакомится с данной статьей.
 
Автоматическое создание лидов в Битрикс24 при помощи входящего вебхука
 
Комманда Битрикс 24 внедрила очень простой и функциональный способ интеграции с CRM системой. Если ранее интеграция с Битрикс 24 была не простой задачей, требующей отличной квалификации и знаний от вебмастеров и владельцев сайта, то теперь, с внедрением вебхуков, произвести интеграцию своего сайта с CRM системой может практически каждый желающий.
 
Так что такое вебхуки в Битрикс24? WebHooks Bitrix24 — механизм, который позволяет вам использовать практически весь богатый функционал Rest API Битрикс24, но при минимальных знаниях и трудозатрат.
 
На мой взгляд, это более безопасный способ передачи информации в CRM систему, чем при помощи упрощенного Rest API.
 
И так, для организации автоматической передачи лидов при помощи вебхуков необходимо:
 
Создать входящий вубхук
 
Для того, чтобы передать данные с вашей формы обратной связи в лиды Битрикс 24 необходимо создать входящий вебхук. Для этого следуем по инструкции:
 
 
Приложения → Вебхуки → Добавить вебхук. 
 
При добавлении выбрать Входящий вебхук.
 
Ввести название для вебхука → При желании добавить его описание → При выборе права доступа указать CRM. 
 
После чего нажимаем на кнопку сохранить.
 
После сохранения появится код для авторизации вебхука и образец URL, который нужно использовать при отправке данных в Битрикс24. 

,где 
 
/rest/ — метод Rest API;
 
/1/ — идентификатор пользователя, пользуясь правами которого будет работать вебхук;
 
/2j2htb348j5y0hgi/ — код вебхука;
 
/profile/ — метод REST, который вы хотите выполнить, обращаясь к вебхуку. При добавлении лида в CRM систему необходимо использовать метод crm.lead.add.json .
 
 
 
 
Написать короткий код для перехвата и передачи данных
 
Для завершения организации передачи данных с формы сайта в лиды Битрикс24 при помощи вебхуков необходимо всего лишь написать коротенький код. При написание кода необходимо учесть всего 3 простых шага:
 
 
сформировать URL в переменной $queryUrl 
https://[ваш_домен].bitrix24.ru/rest/[идентификатор_пользователя]/[код_вебхука]/crm.lead.add.json ;
 
сформировать параметры для создания лида в переменной $queryData ;
 
обратиться к Битрикс24 при помощи функции curl_exec .
 
 
Пример кода для интеграции Битрикс24 и сайта при помощи вебхуков
 
// формируем URL в переменной $queryUrl $queryUrl = 'https://[ваше_название].bitrix24.ru/rest/[идентификатор_пользователя]/[код_вебхука]/crm.lead.add.json'; // формируем параметры для создания лида в переменной $queryData $queryData = http_build_query(array( 'fields' => array( 'TITLE' => 'Название лида', ), 'params' => array("REGISTER_SONET_EVENT" => "Y") )); // обращаемся к Битрикс24 при помощи функции curl_exec $curl = curl_init(); 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); $result = json_decode($result, 1); if (array_key_exists('error', $result)) echo "Ошибка при сохранении лида: ".$result['error_description']."
";
 
Учесть особенность для передачи номера телефона, email, мессенджера
 
Обратите внимание 
При выборе интеграции с помощью входящего вебхука (в отличии от упрощенного Rest API), такие параметры как телефон, электронный адрес и мессенджеры имеют множественные значения и другие поля по умолчанию: PHONE, EMAIL, IM. Поэтому для передачи данных значений необходимо передавать их в массиве.
 
'EMAIL' => Array( "n0" => Array( "VALUE" => "email-1@mail.ru", "VALUE_TYPE" => "WORK", ), "n1" => Array( "VALUE" => "email-2@mail.ru", "VALUE_TYPE" => "HOME", ), ), 'PHONE' => Array( "n0" => Array( "VALUE" => "+74957778899", "VALUE_TYPE" => "WORK", ), "n1" => Array( "VALUE" => "+79151112233", "VALUE_TYPE" => "MOBILE", ), ),
 
, где nX — это одно значение (телефона или электронной почты), которое всегда начинается с 0.
 
Даже если вы передаете всего лишь 1 номер телефона или адрес электронной почты, необходимо указывать его в массиве как n0 .
 
Таким образом, для передачи хотя бы одного телефона и адреса электронной почты, код будет иметь следующий вид:
 
// формируем URL в переменной $queryUrl $queryUrl = 'https://[ваше_название].bitrix24.ru/rest/[идентификатор_пользователя]/[код_вебхука]/crm.lead.add.json'; // формируем параметры для создания лида в переменной $queryData $queryData = http_build_query(array( 'fields' => array( 'TITLE' => 'Название лида', 'EMAIL' => Array( "n0" => Array( "VALUE" => "email-1@mail.ru", "VALUE_TYPE" => "WORK", ), ), 'PHONE' => Array( "n0" => Array( "VALUE" => "+74957778899", "VALUE_TYPE" => "WORK", ), ), ), 'params' => array("REGISTER_SONET_EVENT" => "Y") )); // обращаемся к Битрикс24 при помощи функции curl_exec $curl = curl_init(); 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); $result = json_decode($result, 1); if (array_key_exists('error', $result)) echo "Ошибка при сохранении лида: ".$result['error_description']."
";
 
Теперь проверьте свой Битрикс 24 и вы найдете там созданный лид =)
 
Источник