Безплатен CRM API

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

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

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

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

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

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

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

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

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

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

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

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

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

<form method="POST" action="/bg/zcrm_leads">
   <label for="name">Name:</label>
   <br>
   <input type="text" id="name" name="name" value="">
   <br>
   <label for="phone">Phone:</label><br>
   <input type="text" id="phone" name="phones[0][phone]" value="">
   <br>
   <label for="phone">Email:</label><br>
   <input type="text" id="email" name="contacts[0][value]" value="">
   <br>
   <br>
   <input type="submit" value="Submit">
</form>

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

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

<?php
$postData = $_POST;
if ($postData) {
   if (isset($postData['phones'], $postData['phones'][0], $postData['phones'][0]['phone'])) {
       $postData['phones'][0]['type'] = 'work';
   }
   if (isset($postData['contacts'], $postData['contacts'][0], $postData['contacts'][0]['value'])) {
       $postData['contacts'][0]['type'] = 'email_work';
   }
   $params = ['lead' => $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#, Питон. По този начин, без никакви проблеми, можете да поставите прост безплатен CRM във всеки работен процес, като сте получили автоматизация с малко кръв.
ZCRM непрекъснато се развива и почти всички нови функции ще бъдат достъпни чрез API.
Също така ви каним да интегрирате вашите съществуващи системни системи с безплатни CRM и PBX Zadarma.

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