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

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