Бесплатен CRM API

Пред помалку од една година, воведовме бесплатен CRM систем интегриран со бесплатен PBX. За ова време го користеле 14 компании и 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 (прикажување листа на корисници, нивните права, поставки, контакти и работно време)
• Повици (враќа листа на повици)

Бидејќи се користи постоечката Zadarma API структура, библиотеките во PHP, C#, Python се веќе достапни за него на Github.

Пример за употреба на API

Наједноставниот, но најкорисен пример е создавање на олово од формулар. За да го сведете кодот на минимум, овој пример ги содржи само основните податоци за водењето. Сличен пример, но со коментари од клиентот (обично присутни во секоја форма) е достапен во блогот Онлајн. Примерите за скрипти се напишани во PHP без рамки и затоа лесно се вградуваат.
Пример за html форма за создавање на олово:

<form method="POST" action="/mk/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