crm.lead.add

Scope: crm Права на выполнение: для всех

crm.lead.add(fields, params)

Создаёт новый лид.

Параметры

Параметр Описание

fields

Параметр	Описание
fields	Набор полей - массив вида array("поле"=>"значение"[, ...]), содержащий значения полей лида. Примечание: чтобы узнать требуемый формат полей, выполните метод crm.lead.fields и посмотрите формат пришедших значений этих полей. Для создания повторного лида установите значения полей `COMPANY_ID` или `CONTACT_ID`. После установки этих полей флаг IS_RETURN_CUSTOMER будет установлен автоматически.
params	Набор параметров. REGISTER_SONET_EVENT - произвести регистрацию события добавления лида в живой ленте. Дополнительно будет отправлено уведомление ответственному за лид.

Набор полей - массив вида array("поле"=>"значение"[, ...]), содержащий значения полей лида.

Примечание: чтобы узнать требуемый формат полей, выполните метод crm.lead.fields и посмотрите формат пришедших значений этих полей.

Для создания повторного лида установите значения полей COMPANY_ID или CONTACT_ID. После установки этих полей флаг IS_RETURN_CUSTOMER будет установлен автоматически.

params Набор параметров. REGISTER_SONET_EVENT - произвести регистрацию события добавления лида в живой ленте. Дополнительно будет отправлено уведомление ответственному за лид.

Пример

Пример на JS

BX24.callMethod(
	"crm.lead.add",
	{
		fields:
		{
			"TITLE": "ИП Титов", 
			"NAME": "Глеб", 
			"SECOND_NAME": "Егорович", 
			"LAST_NAME": "Титов", 
			"STATUS_ID": "NEW", 
			"OPENED": "Y", 
			"ASSIGNED_BY_ID": 1, 
			"CURRENCY_ID": "USD", 
			"OPPORTUNITY": 12500,
			"PHONE": [ { "VALUE": "555888", "VALUE_TYPE": "WORK" } ] ,
			"WEB": [ { "VALUE": "www.mysite.com", "VALUE_TYPE": "WORK" } ]
		},
		params: { "REGISTER_SONET_EVENT": "Y" }
	},
	function(result) 
	{
		if(result.error())
			console.error(result.error());
		else
			console.info("Создан лид с ID " + result.data());
	}
);

Пример на HTTPS :

https://adress.ru/rest/1/5***/crm.lead.add.json?fields[NAME]=Василий&fields[SECOND_NAME]=Петрович&fields[LAST_NAME]=Космонавт&fields[PHONE][0][VALUE]=89994445556&fields[PHONE][0][VALUE_TYPE]=WORK&fields[EMAIL][0][VALUE]=test@ya.ru&fields[EMAIL][0][VALUE_TYPE]=WORK

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

0 Мария Звонкова 06.03.2024 19:20:59 Сообщение не промодерировано, возможны ошибки и неточности.
подскажите как в http запросе указать массив для телефона?

Илья Щербаков 05.05.2021 11:09:04

Сообщение не промодерировано, возможны ошибки и неточности.

Для сохранения множественного свойства, надо передавать массив значений ID

Код

   $queryData = [
      'fields' => [
        'TITLE' => название лида,
        'NAME' => имя,
      'UF_CRM_1619760711' => 'строка',
      'UF_CRM_1619761066' => [ 45, 47, 50 ], // массив id множественного свойства
        'ASSIGNED_BY_ID' => 1, // пользователь на кого назначен лид
        'PHONE' => [['VALUE' => $_POST['Phone'], 'VALUE_TYPE' => 'WORK']],
        'EMAIL' => [['VALUE' => $_POST['Email'], 'VALUE_TYPE' => 'WORK']],
      ],
      'params' => ['REGISTER_SONET_EVENT' => 'Y'], // уведомить о лиде
   ];

Антон Долганин 22.10.2014 09:17:56

На множественные значения (мейл, телефон) стоит обратить внимание, ибо легко словить таракана - даже если одно значение передаем, надо передавать как многомерный массив:

Код

'EMAIL' => isset($arProps['EMAIL']) ? array(array('VALUE' => $arProps['EMAIL']['VALUE'], 'VALUE_TYPE' => 'HOME')) : array(),
'PHONE' => isset($arProps['PHONE']) ? array(array('VALUE' => $arProps['PHONE']['VALUE'], 'VALUE_TYPE' => 'HOME')) : array(),

Выглядит это примерно так http://my.jetscreenshot.com/18603/20141022-jsbh-11kb