Bitrix24 создание лида через API

Алексей Будагов,

Данные из любых форм на сайте можно отправлять в Битрикс24, для примера добавим лид в crm с сайта.

Необходимо отправить запрос на создание лида в вашу crm, примерно так:

$crmUrl = 'Адрес CRM'; // https://mycrm.bitrix24.ru/
$login = 'Ваш логин от CRM';
$password = 'Ваш пароль от CRM';

$arParams = array(
	'LOGIN' => $login, // обязательно, логин для доступа к crm
	'PASSWORD' => $password, // обязательно, пароль для доступа к crm
	'TITLE' => 'test' // обязательно, название лида
);
$obHttp = new \Bitrix\Main\Web\HttpClient;
$result = $obHttp->Post($crmUrl.'crm/configs/import/lead.php', $arParams);
$result = json_decode(str_replace('\'', '"', $result), true);
echo '['.$result['error'].'] '.$result['error_message'];

У пользователя ($login) должны быть права на создание лида с CRM.

Все поля которые можно заполнить при добавлении:

Параметр
Тип
Описание
LOGIN*
String
Логин
PASSWORD*
String
Пароль
TITLE*
String
Название
COMPANY_TITLE
String
Название компании
NAME
String
Имя
LAST_NAME
String
Фамилия
SECOND_NAME
String
Отчество
POST
String
Должность
ADDRESS
String
Адрес
COMMENTS
String
Комментарий
SOURCE_DESCRIPTION
String
Дополнительно об источнике
STATUS_DESCRIPTION
String
Дополнительно о статусе
OPPORTINUTY
Double
Возможная сумма сделки
CURRENCY_ID
String
Валюта
PRODUCT_ID
String
Продукт
SOURCE_ID
String
Источник
STATUS_ID
String
Статус
ASSIGNED_BY_ID
Int
Ответственный
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
IM_SKYPE
String
Контакт Skype
IM_ICQ
String
Контакт ICQ
IM_MSN
String
Контакт MSN/Live!
IM_JABBER
String
Контакт Jabber
IM_OTHER
String
Другой контакт

STATUS_ID – Статусы:

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

SOURCE_ID – Источники:

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

CURRENCY_ID – Валюты:

Значение
Название
RUB
Рубль
USD
Доллар США
EUR
Евро

PRODUCT_ID – Продукты:

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

Помимо основных полей, у лида могу присутствовать дополнительные пользовательские поля, созданные администратором сайта. Их вы тоже можете передать из формы.

Опубликовано 6 Декабря 2016 | Обновлено 21 Ноября 2018
Битрикс24, API, разработчику

Возврат к списку

Комментарии
UliyaSog
Суббота 01:06
Комментарий скрыт
Андрей Николаевич
21 Ноя 2018
Перепутали описания SOURCE_DESCRIPTION и STATUS_DESCRIPTION
Алексей Будагов
Алексей Будагов
21 Ноя 2018
Андрей Николаевич, поправил, спасибо
Авпал
7 Ноя 2018
Добрый день. Нужно получить данные по задаче. В частности, по чек листу. Нашел в api метод, там есть даже пример, но как его использовать не пойму. Как организовать авторизацию и запрос на сервер.
Алексей Будагов
Алексей Будагов
7 Ноя 2018
Авпал, добрый день. Не подскажу, я не спец по Б24.
Sergo
14 Июн 2018
забыли указать: к коробочной версии
Алексей Будагов
Алексей Будагов
15 Июн 2018
Sergo, у меня есть только облачная версия, поэтому пример для неё.
Максим
18 Мар 2018
Интересно лид вроде добавляется, а оповещения в виде пуш или сообщения на почту нету
Алексей Будагов
Алексей Будагов
18 Мар 2018
Максим, напишите в тех. поддержку Битрикс24, там подскажут по уведомлениям.
Maks
17 Мар 2018
Можете дать пример как использовать PRODUCT_ID в поле формы и как передать. Возможно дадите ссылку с примером. По остальным полям все получилось, а это поле не могу одолеть.
Я пробовал вот так:
<input type="radio" name="DATA[LEAD_PRODUCT]" value="5" class="f1-first-product form-control" id="f1-first-product">

И потом в цикле пихал номер товара, но не получилось, хотя с другими полями все ок.
Алексей Будагов
Алексей Будагов
18 Мар 2018
Maks, примера, к сожалению, нет. Обратите внимание что поле называется PRODUCT_ID, а не LEAD_PRODUCT (как в вашей форме). Значение данного поля должно быть ID продукта внутри CRM Битрикс24.
Александр
22 Фев 2018
У меня форма работает через ajax и обрабатывается в файле /actions/form.php
Если я вставляю туда этот код не чего не работает. Пробовал через функцию запускать , тоже самое не работает . Работает только если с кнопки формы убрать preventDefault(). И после проверяю isset($_POST['submit']) запуск функции.
Как можно реализовать это? всю голову поломал. Или я не то делаю?! Недавно только начал дело с bitrix! Заранее Спасибо
Алексей Будагов
Алексей Будагов
22 Фев 2018
Александр, в файле /actions/form.php должно быть подключено ядро битрикс (пролог и эпилог, для работы методов класса CHTTP). В коде файла, после валидации всех POST данных, уже делайте запрос к api Битрикс24. Нового ничего Вам сказать не могу, напишите хоть, что за ошибка возникает.
Александр
22 Фев 2018
Алексей Будагов, Благадарю
Дима
7 Фев 2018
Class 'CHTTP' not found это что такое ?
Алексей Будагов
Алексей Будагов
6 Мар 2018
Дима, еще можно использовать новый метод $obHttp = new \Bitrix\Main\Web\HttpClient;
Алексей Будагов
Алексей Будагов
7 Фев 2018
Дима, похоже что не подключено ядро 1С-Битрикс на странице.
Игорь
6 Мар 2018
Алексей Будагов, а как подключить ядро?
Алексей Будагов
Алексей Будагов
6 Мар 2018
Игорь,
require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php");
#код
require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/epilog_after.php");
Сергей
25 Янв 2018
А можно как-то файлы mp3 прикреплять из внешней системы вместе с лидом?
Алексей Будагов
Алексей Будагов
22 Фев 2018
Сергей, еще можно создать пользовательское свойство в CRM и по коду этого свойства заполнять его из формы на сайте.
Алексей Будагов
Алексей Будагов
25 Янв 2018
Сергей, в комментарий "COMMENTS" ссылку если только закинуть)
Тимоха
28 Дек 2017
А как создать лид с товарами?
Алексей Будагов
Алексей Будагов
28 Дек 2017
Тимоха, возможно вам нужно поле "PRODUCT_ID"?
Денис
23 Мар 2018
Алексей Будагов, Скиньте пожалуйста пример, как должен выглядеть код данной переменной. У меня созданы товары, передаю значение в лид, но товар не появляется.
Алексей Будагов
Алексей Будагов
23 Мар 2018
Денис, какое значение передаете? ID товара? Примера у меня нет, я не пробовал передавать товар. Напишите в тех. поддержку 1С-Битрикс, они подскажут, если не работает.
Сергей
20 Апр 2017
Только пытаюсь разобраться с АПИ битрикс. Голова пухнет все больше и больше. Вижу что ваш пример самый внятный. Но пока он у меня не сработал. И вопрос, а ключ приложения не нужен?
Алексей Будагов
Алексей Будагов
20 Апр 2017
Сергей, нет, этот код работает напрямую, без приложения. На сайте под управлением 1С-Битрикс добавляете код из статьи, заполняя первые 3 переменные своими данными, и после выполнения скрипта в Вашей CRM Битрикс24 будет создан новый лид с названием "test".

Что именно не получилось?