Интеграция Zoho CRM на сайте через API

Помню в 2014 году передо мной стояла задача интеграции Zoho CRM на сайте через API. Дело вроде обычное, но хуже реализации API я еще не видел. У меня за 2 года работы возникло много претензий в отношении этой системы. Но бизнес-процессы были уже построены и сменить их не так просто.

Пожалуй начну с минусов API на Zoho CRM:

нет динамических полей телефона и Email’а клиента;
Так, чтобы в поиске участвовали сразу все номера и электронные ящики, а не каждый по отдельности. Надо бы им пример брать с Мегаплана и RetailCRM.

неудобный формат json-ответа;
Вот пример ответа:

{"response":{"result":{"Invoices":{"row":{"no":"1","FL":[{"content":"1010338000001234567","val":"INVOICEID"},{"content":"Согласовать с клиентом","val":"Status"},{"content":"1010338000007896541","val":"CONTACTID"},{"content":"--- -","val":"Contact Name"}]}}},"uri":"/crm/private/json/Invoices/searchRecords"}}

{"response":{"result":{"Invoices":{"row":{"no":"1","FL":[{"content":"1010338000001234567","val":"INVOICEID"},{"content":"Согласовать с клиентом","val":"Status"},{"content":"1010338000007896541","val":"CONTACTID"},{"content":"--- -","val":"Contact Name"}]}}},"uri":"/crm/private/json/Invoices/searchRecords"}}

Было бы гораздо приятнее работать в таком формате:

{"response":{"result":{"Invoices":{"row":{"no":"1","FL":[{"INVOICEID":"1010338000001234567"},{"Status":"Согласовать с клиентом"},{"CONTACTID":"1010338000007896541"},{"Contact Name":"--- -"}]}}},"uri":"/crm/private/json/Invoices/searchRecords"}}

1	{"response":{"result":{"Invoices":{"row":{"no":"1","FL":[{"INVOICEID":"1010338000001234567"},{"Status":"Согласовать с клиентом"},{"CONTACTID":"1010338000007896541"},{"Contact Name":"--- -"}]}}},"uri":"/crm/private/json/Invoices/searchRecords"}}

возвращает данные «рандомно»;
К примеру, вы написали скрипт, который возвращает поля «имя», «телефон», «email». А позже решили добавить еще одно поле «ответственный менеджер». В этом случае порядок выдачи может измениться и придется в скрипте вручную их поправлять. Это происходит по причине некорректного вывода информации (см. предыдущий пункт), т.е. отсутствует возможность прямого обращения к необходимой информации.
не умеет работать с некоторыми спецсимволами;
Например, если при добавлении информации в строке встретится символ & или <, то ничего в систему не добавится. Исходя из этого придется в скрипт добавлять дополнительные условия проверки входных данных.
параметр «criteria» ограничен 5 параметрами;
Сложные запросы уже нет возможности создать.
неверно обрабатывает информацию при ее добавлении в короткий промежуток времени;
Допустим клиент отправил форму (скрипт -> CRM). И решил написать еще один вопрос с тем же телефоном и Email. Первая информация добавится в CRM, но API ее может не увидеть при повторной заявке и, соответственно, скрипт не найдет контакт. Таким образом добавит новый контакт с тем же телефоном и Email. В этом случае придется их объединить вручную средствами CRM.
нет API для телефонии.

Это все что вспомнил по части API. Работа в самой CRM тоже вызывает претензии:

периодически CRM медленно работает, либо вообще недоступен;
Такое ощущение, что их часто ddos’ят (как-то их саппорт в этом признавался).
разные часовые пояса;
Разница во времени иногда отражается на скорости обработки заявок в техподдержку. Задаешь вопрос в свой рабочий день, отвечают ночью. Видишь ответ только на следующее утро, когда садишься за работу.
отсутствует IMAP.
Правда сейчас они сделали beta-версию, но она невероятно сырая. Отправленное письмо из карточки клиента не подцепилось в папке «Отправленные».

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

На одном из наших проектов, где была интеграция Zoho CRM на сайте через API, скрипт содержал более 500 строк кода. Это разного рода проверки, антиспам, работа со счетами, выставление задач, примечания, обработка нескольких телефонных номеров и Email и т.д. Такой пример здесь не выложишь, поэтому я его сократил до минимума. Главное понять сам принцип, а дальше дело техники…

<?php
	/*Функции*/
	function curlZAPIReq($typereq, $cphone, $cemail, $xmldata) {		
		$postData = array();
		$postData['authtoken'] = 'ВАШ_API_КЛЮЧ';
		$postData['scope'] = 'crmapi';
		$postData['newFormat'] = '2';
		
		if ($typereq == "Insert Contact"){
			$url = 'https://crm.zoho.com/crm/private/json/Contacts/insertRecords';
			$postData['xmlData'] = $xmldata;
		}
		elseif ($typereq == 'Search Contact'){
			$url = 'https://crm.zoho.com/crm/private/json/Contacts/searchRecords';
			$postData['selectColumns'] = 'Contacts(Id,Mobile,Email,First Name)';
			$postData['criteria'] = '(Mobile:'.$cphone.')OR(Email:'.$cemail.')';
		}	
		elseif ($typereq == 'Update Contact'){
			$url = 'https://crm.zoho.com/crm/private/json/Contacts/updateRecords';
			global $CID;
			$postData['id'] = $CID;
			$postData['xmlData'] = $xmldata;	
		}

		$ch = curl_init();
		curl_setopt($ch, CURLOPT_URL, $url);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
		curl_setopt($ch, CURLOPT_POST, 1);
		curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);	
		$result = curl_exec($ch);
		curl_close($ch);
		return $result;
	}	
	
	/*Получение переменных*/
	$phone = preg_replace("/[^0-9]/", '', $_POST['phone']); //Запишем только цифры
	$xmlphone = '';
	if (trim($phone)) {	$xmlphone = '<FL val="Mobile">'.$phone.'</FL>'; }		

	$email = $_POST['email'];
	$xmlemail = '';
	if (trim($email)) {	$xmlemail = '<FL val="Email">'.$email.'</FL>'; }

	if (!trim($email) && !trim($phone)) { 
		header('Content-Type: text/html; charset=utf-8');
		echo 'Ошибка! Заполните обязательные поля "Телефон" и/или "Email". <a href="javascript:history.go(-1);">Назад</a>'; 
		exit(); 
	}
	
	$firstname = $_POST['firstname'];
	$xmlfirstname = '<FL val="First Name">_</FL>';
	if (trim($firstname)) {	$xmlfirstname = '<FL val="First Name">'.$firstname.'</FL>';	}
	
	/*Поиск контакта*/
	$response = curlZAPIReq('Search Contact', $phone, $email, '');
	$Contact = json_decode($response, TRUE);
	$Contact = $Contact["response"]["result"]["Contacts"]["row"]; //Сократим массив срезав лишнее

	//ID клиента в CRM
	if ($Contact["0"]["FL"]["0"]["val"] == "CONTACTID") { $CID = $Contact["0"]["FL"]["0"]["content"]; }
	else if ($Contact["FL"]["0"]["val"] == "CONTACTID") { $CID = $Contact["FL"]["0"]["content"]; }
	else if ($Contact["FL"]["val"] == "CONTACTID") { $CID = $Contact["FL"]["content"]; }
	else $CID = '';	
	
	if (trim($CID))	{
		//Найден контакт. Обновляем данные Контакта...
		curlZAPIReq('Update Contact', '', '', '<Contacts><row no="1">'.$xmlfirstname.$xmlphone.$xmlemail.'</row></Contacts>');		
	}
	else {
		//Контакт не найден. Создаем новый контакт...
		$response = curlZAPIReq('Insert Contact', '', '', '<Contacts><row no="1">'.$xmlfirstname.$xmlphone.$xmlemail.'</row></Contacts>');
		$Contact = json_decode($response, TRUE);
		$CID = $Contact["response"]["result"]["recorddetail"]["FL"]["0"]["content"];//Запоминаем Id нового контакта
	}
	
	//Переадресация на страницу благодарности
	header('Location: http://site.ru/thanks');
?>

<?php

/*Функции*/

function curlZAPIReq($typereq, $cphone, $cemail, $xmldata) {

$postData = array();

$postData['authtoken'] = 'ВАШ_API_КЛЮЧ';

$postData['scope'] = 'crmapi';

$postData['newFormat'] = '2';

if ($typereq == "Insert Contact"){

$url = 'https://crm.zoho.com/crm/private/json/Contacts/insertRecords';

$postData['xmlData'] = $xmldata;

}

elseif ($typereq == 'Search Contact'){

$url = 'https://crm.zoho.com/crm/private/json/Contacts/searchRecords';

$postData['selectColumns'] = 'Contacts(Id,Mobile,Email,First Name)';

$postData['criteria'] = '(Mobile:'.$cphone.')OR(Email:'.$cemail.')';

}

elseif ($typereq == 'Update Contact'){

$url = 'https://crm.zoho.com/crm/private/json/Contacts/updateRecords';

global $CID;

$postData['id'] = $CID;

$postData['xmlData'] = $xmldata;

}

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);

curl_setopt($ch, CURLOPT_POST, 1);

curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);

$result = curl_exec($ch);

curl_close($ch);

return $result;

}

/*Получение переменных*/

$phone = preg_replace("/[^0-9]/", '', $_POST['phone']); //Запишем только цифры

$xmlphone = '';

if (trim($phone)) { $xmlphone = '<FL val="Mobile">'.$phone.'</FL>'; }

$email = $_POST['email'];

$xmlemail = '';

if (trim($email)) { $xmlemail = '<FL val="Email">'.$email.'</FL>'; }

if (!trim($email) && !trim($phone)) {

header('Content-Type: text/html; charset=utf-8');

echo 'Ошибка! Заполните обязательные поля "Телефон" и/или "Email". <a href="javascript:history.go(-1);">Назад</a>';

exit();

}

$firstname = $_POST['firstname'];

$xmlfirstname = '<FL val="First Name">_</FL>';

if (trim($firstname)) { $xmlfirstname = '<FL val="First Name">'.$firstname.'</FL>'; }

/*Поиск контакта*/

$response = curlZAPIReq('Search Contact', $phone, $email, '');

$Contact = json_decode($response, TRUE);

$Contact = $Contact["response"]["result"]["Contacts"]["row"]; //Сократим массив срезав лишнее

//ID клиента в CRM

if ($Contact["0"]["FL"]["0"]["val"] == "CONTACTID") { $CID = $Contact["0"]["FL"]["0"]["content"]; }

else if ($Contact["FL"]["0"]["val"] == "CONTACTID") { $CID = $Contact["FL"]["0"]["content"]; }

else if ($Contact["FL"]["val"] == "CONTACTID") { $CID = $Contact["FL"]["content"]; }

else $CID = '';

if (trim($CID)) {

//Найден контакт. Обновляем данные Контакта...

curlZAPIReq('Update Contact', '', '', '<Contacts><row no="1">'.$xmlfirstname.$xmlphone.$xmlemail.'</row></Contacts>');

}

else {

//Контакт не найден. Создаем новый контакт...

$response = curlZAPIReq('Insert Contact', '', '', '<Contacts><row no="1">'.$xmlfirstname.$xmlphone.$xmlemail.'</row></Contacts>');

$Contact = json_decode($response, TRUE);

$CID = $Contact["response"]["result"]["recorddetail"]["FL"]["0"]["content"];//Запоминаем Id нового контакта

}

//Переадресация на страницу благодарности

header('Location: http://site.ru/thanks');

Функция curlZAPIReq() отвечает за добавление, обновление и поиск Контакта из CRM.

Здесь все довольно просто: сначала получаем переменные отправленные нашей формой с сайта (Имя, Телефон, Email).
Ищем контакт в CRM по совпадению телефона и/или Email: ‘(Mobile:’.$cphone.’)OR(Email:’.$cemail.’)’. Замечу, что номера 84950000000 и +74950000000 будут считаться разными. Это я отметил потому, что в некоторых CRM они считаются равными.

Далее смотрим ID найденного контакта. Если он есть, значит нашли — обновляем данные контакта, в противном случае создадим новый.
Здесь обратите внимание на строки:

if ($Contact["0"]["FL"]["0"]["val"] == "CONTACTID") { $CID = $Contact["0"]["FL"]["0"]["content"]; }
else if ($Contact["FL"]["0"]["val"] == "CONTACTID") { $CID = $Contact["FL"]["0"]["content"]; }
else if ($Contact["FL"]["val"] == "CONTACTID") { $CID = $Contact["FL"]["content"]; }
else $CID = '';

if ($Contact["0"]["FL"]["0"]["val"] == "CONTACTID") { $CID = $Contact["0"]["FL"]["0"]["content"]; }

else if ($Contact["FL"]["0"]["val"] == "CONTACTID") { $CID = $Contact["FL"]["0"]["content"]; }

else if ($Contact["FL"]["val"] == "CONTACTID") { $CID = $Contact["FL"]["content"]; }

else $CID = '';

В зависимости от того клиент не найден, или найден 1 контакт, или может их 2 и более, формат ответа будет различаться. Поэтому и проверки сделаны на все случаи.

Это был простой пример PHP-скрипта по интеграции Zoho CRM на сайт через API.

Мы перепробовали все популярные CRM. С некоторыми из них работаем параллельно в разных проектах. Могу точно сказать, что ни одна CRM на сегодняшний день не идеальна. В каждом из них есть свои клевые качества, так и минусы. Zoho хороший и мощный продукт. Узнать решает ваши задачи или нет, можно только проработав некоторое время. У каждого из нас свои потребности и покрыть их сделав универсальную систему просто невозможно.

Если все таки решили интегрировать свой сайт с Zoho CRM через API достаточно Оставить заявку