API за безплатна CRM

Преди по-малко от година представихме безплатна CRM система, интегрирана с безплатна АТС. През това време, 14 000 компании и 64 000 служители я използваха.
Сега предлагаме отворен API интерфейс, в който е достъпен по-голямата част от функционалността на ZCRM. API позволява използването на CRM за всякакви канали на продажба.
По-долу накратко ще опишем работата с API и наличната функционалност. Също така ще представим прост, но полезен и работещ пример: скрипт за създаване на лид от форма на сайта.

Накратко за безплатната CRM

Ще се въздържим от обяснението какво е CRM. Безплатна CRM Zadarma поддържа всички стандартни функции за съхраняване на данни за клиента. Информацията се запазва в лентата на клиента. Освен информацията за клиентите, е наличен удобен мениджър на задачи с представяне по всякакъв вкус (календар, канбан, списък). Всичко това е достъпно за 50+ служители и е напълно интегрирано с телефония (включително обаждания от браузъра с технологията WebRTC).

Какво означава безплатно? Няма нито един тарифен план или услуга на ZCRM, за които трябва да се плаща. Единственото, за което трябва да се плаща, са телефонните обаждания и номера (по специални тарифи, например, абонамент за номер в Москва от 95 рубли или Лондон от 1 евро). А ако обажданията почти липсват? Тогава и плащането почти не е нужно.
Безплатната CRM е активна, докато безплатната АТС на Zadarma е активна. След регистрацията АТС е активна 2 седмици, след което е необходимо да се попълва сметката с каквато и да е сума веднъж на 3 месеца. Трудно е да си представим офис, на който му трябва CRM и АТС, но изобщо не му трябва нито номер, нито обаждания.

Защо е нужен API за безплатна CRM

Развитието на ZCRM не спира нито за миг, появили са се множество големи и малки функции. Но разбираме, че за да представим наистина функционална система, а не просто умна записна книжка, недостатъчно е само интеграцията с телефонията.
Колкото повече контакти с клиента, толкова по-добре, а контактите могат да са най-разнообразни. Благодаря на API, без проблем може автоматично да се внася (или обратно да се получи) информация за клиента/лида и задачите. Благодарение на това се появява възможност за свързване на всякакви канали за комуникация с клиентите и всякакви други системи за автоматизация.
Благодаря API безплатната ZCRM може да се използва по всякакъв начин, както изцяло, така и частично. Например, като удобен интерфейс за работа с корпоративната база данни на клиенти или прост удобен планировчик.
По-долу ще представим пример на подобен канал — свързване на CRM лид форма на сайта. По-късно на сайта ще предоставим и други примери, например създаване на задача за обаждане на клиента (отложено обаждане).

Основни методи на API ZCRM

Тъй като в API ZCRM са налични 37 метода, ще се въздържим от описание на всички, а ще опишем само основните им групи с примери.
Пълен списък с примери е наличен на сайта в описанието на API CRM.

Възможна е работа със следните групи методи:

• Клиенти (общ списък, отделни извлечения, редактиране, изтриване)
• Тагове и допълнителни свойства на клиентите
• Лента на клиента (преглед, редактиране, изтриване на записи в лентите на клиентите)
• Служители на клиента (тъй като клиентът обикновено е юридическо лице, той може да има много служители)
• Задачи (цялата функционалност по работа с задачи)
• Лийдове (аналогично всички функции)
• Потребители на CRM (показване на списък с потребители, техните права, настройки, контакти и работни часове)
• Обаждания (възвръща списък с обаждания)

Тъй като се използва съществуващата структура на API Zadarma, за нея в Github вече са налични библиотеки на PHP, C#, Python.

Пример за използване на API

Най-простият и в същото време полезен пример — създаване на лийд от форма. За минимизиране на кода този пример съдържа само основните данни на лийда. Подобен пример, но вече с коментари от клиента (обикновено присъстват във всяка форма) е наличен в блога на сайта. Примерите на скрипта са написани на PHP без фреймворкове и затова лесно могат да се интегрират.
Пример на html форма за създаване на лийд:

<form method="POST" action="/bg/zcrm_leads/" data-trp-original-action="/zcrm_leads">
   <label for="name">Име:</label>
   <br>
   <input type="text" id="name" name="name" value="">
   <br>
   <label for="phone">Телефон:</label><br>
   <input type="text" id="phone" name="phones[0][phone]" value="">
   <br>
   <label for="phone">Имейл:</label><br>
   <input type="text" id="email" name="contacts[0][value]" value="">
   <br>
   <br>
   <input type="submit" value="Изпрати">
<input type="hidden" name="trp-form-language" value="bg"/></form>

Тази форма е изключително проста, за да не претоварва статията. Тя няма нито дизайн, нито капча, нито поле за коментар. В нашия блог е налична версия с поле за коментари (коментарът се добавя в лентата на клиента след създаването на лийда).

И собствено PHP пример за създаване на лийд с данни от формата:

$postData];
   $params['lead']['lead_source'] = 'form';

   $leadData = makePostRequest('/v1/zcrm/leads', $params);
   var_dump($leadData);
}
exit();

function makePostRequest($method, $params)
{
   // замените userKey и secret на ваши из личного кабинета
   $userKey = '';
   $secret = '';
   $apiUrl = 'https://api.zadarma.com';

   ksort($params);

   $paramsStr = makeParamsStr($params);
   $sign = makeSign($paramsStr, $method, $secret);

   $curl = curl_init();
   curl_setopt($curl, CURLOPT_URL, $apiUrl . $method);
   curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
   curl_setopt($curl, CURLOPT_POST, true);
   curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 10);
   curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
   curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
   curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
   curl_setopt($curl, CURLOPT_POSTFIELDS, $paramsStr);
   curl_setopt($curl, CURLOPT_HTTPHEADER, [
       'Authorization: ' . $userKey . ':' . $sign
   ]);

   $response = curl_exec($curl);
   $error = curl_error($curl);

   curl_close($curl);

   if ($error) {
       return null;
   } else {
       return json_decode($response, true);
   }
}

/**
* @param array $params
* @return string
*/
function makeParamsStr($params)
{
   return http_build_query($params, null, '&', PHP_QUERY_RFC1738);
}

/**
* @param string $paramsStr
* @param string $method
* @param string $secret
*
* @return string
*/
function makeSign($paramsStr, $method, $secret)
{
   return base64_encode(
       hash_hmac(
           'sha1',
           $method . $paramsStr . md5($paramsStr),
           $secret
       )
   );
}

Както виждате, работата с API е доста проста, а също така има примери за работа на PHP, C#, Python. По този начин можете лесно да включите проста безплатна CRM система в всеки работен процес, получавайки автоматизация "с минимални усилия".
ZCRM продължава да се развива и почти всички нови функции ще бъдат достъпни и чрез API.
Също така ви каним да интегрирате вашите съществуващи системи с безплатни CRM и AТС Zadarma.

Източник: habr.com