Как найти контакт по пользовательскому полю в AMO CRM, используя api?

Question

[SpectreZ]

Приветствую.

Пытаюсь получить из AMO CRM посредством api запроса контакт по значению указанного поля. Запрос такого вида:

https://domain.amocrm.ru/api/v4/contacts?filter[name]=test

срабатывает, возвращает контакт с именем test.

Как сформировать запрос, который будет получать контакт по значению пользовательского поля?

Пробовал формировать запросы такого вида:

.../api/v4/contacts?filter[custom_fileds_values][field_id]=266363&filter[custom_fileds_values][values][0][value]=[e-mail]

- не срабатывает.

Answer 1

[Валерий Чмых]

В настоящий момент этот функционал доступен только партерам AmoCRM.
Чтобы фильтровать по пользовательскому полю можно использовать Api v3

GET https://<subdomain>.amocrm.ru/api/v3/contacts
Параметры:

• filter[#CODE#] - где #CODE# это либо код поля (name, created_at и тп.), либо id пользовательского поля
  
• fields - поля которые надо возвращать (company_uid,status_id,closed_at,responsible_user_id, либо id пользовательского поля)
  
• with - добавит к выдаче сделки контакты и компании - доступные значения contacts,leads,companies,customers
  

В вашем случае запрос будет выглядеть как то так
/api/v3/contacts?filter[266363]=[e-mail]

Comments

[SpectreZ]

Спасибо за помощь.
При таком запросе почему-то возвращается пустой результат. Возможно для API v3 нужны какие-то другие заголовки запроса?
Статус запроса 405, судя по документации, метод передачи запроса неверный.

На данный момент использую такие заголовки:

$headers = [
	'Content-Type:application/json',
	'X-Requested-With: XMLHttpRequest',
	'Authorization: Bearer ' . $this->access_token
];

[Валерий Чмых]

SpectreZ, пустой результат возвращается если по вашему запросу сущностей не найдено - возвращает код 204 - No Content

[SpectreZ]

Да, возвращается код 204. Возможно это связано с тем, что поле email имеет несколько вложенных элементов (enums)? Указанный в контакте email помечен в CRM как рабочий.

[enums] => Array (
	[0] => Array
		(
			[id] => 381327
			[value] => WORK
			[sort] => 2
		)

	[1] => Array
		(
			[id] => 381329
			[value] => PRIV
			[sort] => 4
		)

	[2] => Array
		(
			[id] => 381331
			[value] => OTHER
			[sort] => 6
		)
)

[Валерий Чмых]

SpectreZ, а ну так поле email является системным - по нему этим методом не отфильтровать.
Используй вот такой:

GET https://<subdomain>.amocrm.ru/ajax/contacts/list/?json=1&page=1&filter[cf][266363][]=[e-mail]&useFilter=y&element_type=1

[SpectreZ]

Валерий Чмых, такой запрос возвращает необходимые данные. Спасибо за помощь.

Странно, что в официальной документации API про это либо не сказано, либо это сложно найти, вроде как одни из наиболее востребованных методов - поиск уже имеющихся записей.

[Сергей Золотарёв]

Валерий Чмых , до сих пор не могу разобраться в том, как получить из AmoCRM список всех контактов без сделки. Какой запрос нужно сформировать, чтобы решить данную задачу? Заранее спасибо!

Answer 2

[Николай Казаков]

Можно еще использовать просто query для поиска, например так

/api/v4/contacts?query=[e-mail]

а уже в результате проверять, что найдено по нужному полю