🥇API dlya besplatnoy CRM

Manj kot leto nazaj smo predstavili brezplačni CRM sistem, ki je integriran z brezplačno telefonsko centralo. V tem času ga je uporabljalo 14.000 podjetij in 64.000 zaposlenih.
Sedaj ponujamo odprt API vmesnik, v katerem je na voljo večina funkcij ZCRM. API omogoča uporabo CRM za katerikoli prodajni kanal.
Spodaj bomo na kratko opisali delo z API-jem in dostopno funkcionalnost. Prav tako je priložen preprost, a koristen in delujoč primer: skripta za ustvarjanje leadov iz obrazca na spletni strani.

Na kratko o brezplačnem CRM-u

Pustimo ob strani razlago, kaj je CRM. Brezplačni CRM Zadarma podpira vse standardne funkcije shranjevanja podatkov o strankah. Informacije se shranjujejo v časovni premici stranke. Poleg informacij o strankah je na voljo tudi priročen upravljalnik nalog s prikazovanjem po meri (koledar, kanban, seznam). Vse to je na voljo za več kot 50 zaposlenih in je popolnoma integrirano s telefonskimi storitvami (vključno z klici iz brskalnika s tehnologijo WebRTC).

Kaj pomeni brezplačno? Ni nobene tarife ali storitve ZCRM, za katero bi bilo treba plačati. Edina stvar, za katero je treba plačati, so telefonski klici in številke (po posebnih tarifah, na primer, naročnina za številko v Moskvi je 95 rubljev ali za London 1 evro). In če skoraj ni klicev? Potem niti ne treba veliko plačevati.
Brezplačni CRM je aktiven, dokler je aktivna brezplačna telefonska centrala Zadarma. Po registraciji je telefonska central aktivna 2 tedna, nato pa je treba napolniti račun za poljuben znesek enkrat na 3 mesece. Težko si je predstavljati pisarno, ki potrebuje CRM in telefonsko centralo, a ne potrebuje niti številke niti klicev.

Zakaj je API potreben za brezplačni CRM

Razvoj ZCRM se nezadržno nadaljuje, pojavilo se je številne velike in majhne funkcije. A razumemo, da za predstavitev resnično funkcionalnega sistema, ne pa le pametnega beležnika, ni dovolj le integracija s telefonskimi storitvami.
Več stikov s stranko je boljše, stiki pa so lahko zelo različni. Zahvaljujoč API-ju lahko brez težav avtomatsko vnašate (ali obratno pridobivate) informacije o stranki/leadu in nalogah. Tako se pojavi možnost povezave različnih komunikacijskih kanalov s strankami in vseh drugih sistemov avtomatizacije.
Zahvaljujući API-ju, besplatni ZCRM se može koristiti na bilo koji način, bilo u celini ili delimično. Na primer, kao zgodno sučelje za rad s korporativnom bazom klijenata, ili kao jednostavan planifikator.
U nastavku ćemo navesti primer takvog kanala — povezivanje s CRM lead-formom na web stranici. Kasnije ćemo na webu pružiti i druge primere, na primer, kreiranje zadatka za povratni poziv klijentu (odloženi poziv).

Osnovne metode API-ja ZCRM

Budući da je u API-ju ZCRM dostupno 37 metoda, suzdržat ćemo se od opisivanja svih i opisati samo glavne grupe s primerima.
Potpuni spisak s primerima dostupan je na webu u opisu API-ja CRM.

Moguće je raditi s sledećim grupama metoda:

Klijenti (opšti spisak, pojedinačni izbori, uređivanje, brisanje)
Tagovi i dodatna svojstva klijenata
Klijentova vremenska linija (pregled, uređivanje, brisanje zapisa u vremenskim linijama klijenata)
Zaposleni klijenta (budući da je klijent obično pravno lice, može imati značajan broj zaposlenih)
Zadaci (sva funkcionalnost za rad s zadacima)
Leadi (analogno, sve funkcije)
Korisnici CRM-a (prikaz spiska korisnika, njihova prava, postavke, kontakti i radno vreme)
Pozivi (vraća spisak poziva)

Budući da se koristi postojeća struktura API-ja Zadarma, biblioteke za nju su već dostupne na Github-u za PHP, C#, Python.

Primer korišćenja API-ja

Najjednostavniji i najkorisniji primer — kreiranje leada iz forme. Da bismo minimizirali kod, ovaj primer sadrži samo osnovne podatke o leadu. Sličan primer, ali s komentarima klijenta (koji obično prisustvuju u svakoj formi) dostupan je v blogu na webu. Primeri skripti napisani su na PHP bez okvirâ i stoga se lako ugrađuju.
Primer html forme za kreiranje leada:

<form method="POST" action="/sl/zcrm_leads/" data-trp-original-action="/zcrm_leads">
   <label for="name">Ime:</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">Email:</label><br>
   <input type="text" id="email" name="contacts[0][value]" value="">
   <br>
   <br>
   <input type="submit" value="Pošalji">
<input type="hidden" name="trp-form-language" value="sl"/></form>

Ova forma je izuzetno jednostavna kako ne bi preopterećivala članak. Nemá ni dizajn, ni CAPTCHA, ni polje za komentar. U našem blogu dostupna je verzija s poljem za komentare (komentar se dodaje u vremensku liniju klijenta nakon kreiranja leada).

I, naravno, PHP primer za kreiranje leada s podacima iz forme:

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

Kot vidite, rabota s API dostatochno prosta, plyus prisutstvuyut primery raboty na PHP, C#, Python. Takim obrazom, bez osobykh problem, mozhno vpisat' prostuyu besplatnuyu CRM v lyuboy rabochiy protsess, poluchiv avtomatizatsiyu «maloy krov'yu».
ZCRM nepreryvno razvivaetsya i prakticheski vse novye funktsii budut dostupny v tom chisle cherez API.
Takzhe my priglashayem integrirovat' vashi sushchestvuyushchie sistemy s besplatnymi CRM i ATS Zadarma.

Izvor: habr.com

API za brezplačno CRM

Na kratko o brezplačnem CRM-u

Zakaj je API potreben za brezplačni CRM

Osnovne metode API-ja ZCRM

Primer korišćenja API-ja