Tasuta CRM API

Alla vähem kui aasta tagasi esitlesime tasuta CRM-süsteemi, mis on integreeritud tasuta PBX-iga. Selle aja jooksul on seda kasutanud 14 000 ettevõtet ja 64 000 töötajat.
Praegu pakume avatud API liidest, kus on saadaval enamik ZCRM-i funktsioonidest. API võimaldab kasutada CRM-i kõikides müügikanalites.
Allpool anname lühikese ülevaate API kasutamisest ja saadaval olevast funktsionaalsusest. Samuti tuuakse välja lihtne, kuid kasulik ja töötav näide: skript, mis loob juhu veebisaidilt.

Lühidalt tasuta CRM-ist

Jätame kõrvale selgitamise, mis on CRM. Tasuta CRM Zadarma toetab kõiki standardseid funktsioone kliendiandmete salvestamiseks. Teave salvestatakse kliendi voogu. Lisaks kliendiinfotele on saadaval mugav ülesannete haldaja, mis kuvab vajaliku viisil (kalender, kanban, nimekiri). Kõik see on saadaval 50+ töötajale ja on täielikult integreeritud telefoniteenustega (sealhulgas kõned brauserist WebRTC tehnoloogia kaudu).

Mida tähendab tasuta? ZCRM-i tasuta teenuse või tasu tarbimist ei ole. Ainuke, mille eest tuleb maksta, on telefonikõned ja numbrid (erihinnad, näiteks Moskva numbri kuumakse 95 rubla või Londoni 1 euro). Ja kui kõnesid on peaaegu pole? Siis praktiliselt ei pea maksma.
Tasuta CRM on aktiivne seni, kuni tasuta Zadarma PBX on aktiivne. Pärast PBX-i registreerimist on see aktiivne 2 nädalat, edaspidi tuleb kontot täiendama igal 3 kuu jooksul mistahes summas. Raske on ette kujutada kontorit, millele on vajalik CRM ja PBX, aga ei ole armatuure ega kõnesid.

Miks on API vajalik tasuta CRM-ile

ZCRM-i areng ei peatu hetkekski, on ilmunud palju suuri ja väikseid funktsioone. Kuid mõistame, et tõeliselt funktsionaalse süsteemi, mitte lihtsalt nutika märkmete tegemise süsteemi esitlemiseks ei piisa ainult telefoniteenuste integreerimisest.
Mida rohkem kontakte kliendiga, seda parem ja kontaktid võivad olla igasugused. API abil saab mugavalt automaatselt lisada (või vastupidi saada) teavet kliendi/juhu ja ülesannete kohta. Tänu sellele on võimalik ühendada igasuguseid suhtlemiskanaleid klientidega ja muid automatiseerimissüsteeme.
API kaudu on tasuta ZCRM-i võimalik kasutada igasuguste viisidega, olgu need siis täielikud või osalised. Näiteks saab seda kasutada mugava liidesena ettevõtte kliendibaasi haldamiseks või lihtsa kasutusmugavusega ajakava koostajaks.
Allpool toome välja näite sellisest kanalist — CRM-i liidivormi ühendamine veebisaidiga. Hiljem toome välja ka teisi näiteid, näiteks, kuidas luua ülesanne kliendile tagasi helistamiseks (edasilükatud kõne).

ZCRM API põhimeetodid

Kuna ZCRM API-s on saadaval 37 meetodit, jätame nende kõigi kirjeldamise vahele ja käsitleme ainult mõningaid põhigruppe koos näidetega.
Täielik nimekiri koos näidetega on saadaval veebisaidil API CRM-i kirjelduses.

Saadaval on järgmised meetodigrupid:

• Kliendid (üldine nimekiri, eraldi valikud, redigeerimine, kustutamine)
• Kliendi sildid ja täiendavad omadused
• Kliendi ajajoon (kliendi ajaloos olevate kirjeid saab vaadata, redigeerida ja kustutada)
• Kliendi töötajad (kuna klient on enamasti juriidiline isik, võivad tal olla mitmed töötajad)
• Ülesanded (kogu ülesannete haldamise funktsionaalsus)
• Liidid (samuti kõik funktsioonid)
• CRM-i kasutajad (kasutajate nimekirja, õiguste, seadete, kontaktide ja tööaegade kuvamine)
• Kõned (tagastab kõnede nimekirja)

Kuna kasutatakse olemasolevat Zadarma API struktuuri, on selle jaoks GitHubis juba saadaval PHP, C#, Python raamatukogud.

API kasutamise näide

Kõige lihtsam ja samas kasulik näide on liidi loomine vormist. Koodi minimiseerimiseks sisaldab see näide ainult peamisi liidi andmeid. Sarnane näide, kuid juba koos kliendi kommentaaridega (need esinevad tavaliselt igas vormis) on saadaval blogist veebisaidil. Skripti näited on kirjutatud PHP ilma raamistiketa, mistõttu on need kergesti integreeritavad.
Liidi loomise HTML vormi näide:

<form method="POST" action="/et/zcrm_leads/" data-trp-original-action="/zcrm_leads">
   <label for="name">Nimi:</label>
   <br>
   <input type="text" id="name" name="name" value="">
   <br>
   <label for="phone">Telefon:</label><br>
   <input type="text" id="phone" name="phones[0][phone]" value="">
   <br>
   <label for="phone">E-post:</label><br>
   <input type="text" id="email" name="contacts[0][value]" value="">
   <br>
   <br>
   <input type="submit" value="Esita">
<input type="hidden" name="trp-form-language" value="et"/></form>

See vorm on ülimalt lihtne, et mitte koormata artiklit. Sellel ei ole ei kujundust, ega captcha't, ega kommentaarivälja. Meie blogis on saadaval versioon, kus on kommentaariväli (kommentaar lisatakse kliendi ajaloos pärast liidi loomist).

Ja siinkohal on PHP näide liidi loomise kohta vormist saadud andmetega:

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

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

function makePostRequest($method, $params)
{
   \/\/ asendage userKey ja secret oma konto andmetega
   $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
*\n* @return string
*\/function makeSign($paramsStr, $method, $secret)
{
   return base64_encode(
       hash_hmac(
           'sha1',
           $method . $paramsStr . md5($paramsStr),
           $secret
       )
   );
}

Nagu näete, on API kasutamine piisavalt lihtne, lisaks on olemas näited. PHP, C#, Python. Seega on lihtne tasuta CRM-i integreerimine igasse tööprotsessi, saavutades automatiseerimise minimaalse vaevaga.
ZCRM areneb pidevalt ja peaaegu kõik uued funktsioonid saavad olema saadaval ka API kaudu.
Samuti kutsume teid üles integreerima oma olemasolevaid süsteeme saadud tasuta CRM-ide ja Zadarma PBX-idega.

Allikas: habr.com