Документация для разработчиков
Темная тема

crm.duplicate.findbycomm

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

crm.duplicate.findbycomm()

Возвращает идентификаторы лидов, контактов и компаний содержащих телефоны или email-адреса из заданного списка.

Параметры

Параметр Описание
type Тип коммуникации:
  • EMAIL - email-адрес;
  • PHONE - телефон.

Обязательный параметр.

values Массив email или телефонов (до 20 значений Ограничено с целью снижения нагрузки. ). Обязательный параметр. Метод возвращает не более 20 дублей по сущности, причем не 20 новых, а 20 старых.

Если в сущности 20 или более дублей, результаты по остальным сущностям возвращены не будут. Например, мы не указали entity_type и ожидаем дубли по всем трем сущностям, но у нас в лидах 20 или более дублей, сущности контакт и компания возвращены не будут. Если в сущности контакт будет 20 или более дублей, мы получим дубли по лидам и контактам, а компания будет отсутствовать в выборке.

entity_type Необязательный параметр. Может быть опущен, в этом случае вернутся все три типа сущности. Если параметр используется, то можно оперировать только с одним из них. Если же задать массив или несуществующий параметр, то вернутся все типы. Типы сущности:
  • LEAD - лид;
  • CONTACT - контакт;
  • COMPANY - компания.

Результат возвращается в виде объекта, содержащего массивы идентификаторов лидов, контактов и компаний.

Доступ к массиву идентификаторов производится по имени типа. Пример:

{'LEAD': [1, 2, 3], 'CONTACT': [4, 5, 6], 'COMPANY': [7, 8, 9]}

Пример поиска контакта по телефону:

//Поиск контакта по телефону
BX24.callMethod(
	"crm.duplicate.findbycomm", 
	{
		entity_type: "CONTACT",
		type: "PHONE",
		values: [ "8976543", "11223355" ],
	},
	function(result) 
	{
		if(result.error())
			console.error(result.error());
		else
			{
				console.dir(result.data());
			}
	}
);


© «Битрикс», 2001-2024, «1С-Битрикс», 2024