🥇API pro bezplatné CRM

Před méně než rokem jsme představili zdarma CRM systém, který je integrován s bezplatnou ústřednou. Během této doby jej využilo 14 000 společností a 64 000 zaměstnanců.
Nyní nabízíme otevřené API rozhraní, ve kterém je k dispozici většina funkcí ZCRM. API umožňuje používat CRM pro jakékoli prodejní kanály.
Níže stručně popíšeme práci s API a dostupné funkce. Také je uveden jednoduchý, ale užitečný a funkční příklad: skript pro vytváření leadu z formuláře na webu.

Stručně o bezplatném CRM

Vyhneme se vysvětlení, co je to CRM. Bezplatná CRM Zadarma podporuje všechny standardní funkce ukládání údajů o zákazníkovi. Informace jsou uloženy v chronologii zákazníka. Kromě informací o zákaznících je k dispozici také pohodlný správce úkolů s různými možnostmi zobrazení (kalendář, kanban, seznam). To vše je dostupné pro více než 50 zaměstnanců a je plně integrováno s telefonním systémem (včetně hovorů z prohlížeče pomocí technologie WebRTC).

Co znamená bezplatně? Neexistuje žádný tarif ani služba ZCRM, za kterou by se mělo platit. Jediná část, za kterou se platí, jsou telefonní hovory a čísla (podle speciálních tarifů, například měsíční poplatek za číslo v Moskvě 95 rublů nebo v Londýně 1 euro). A pokud je hovorů skoro žádné? Tak ani platit skoro nemusíte.
Bezplatná CRM je aktivní, dokud je aktivní bezplatná ústředna Zadarma. Po registraci je ústředna aktivní po dobu 2 týdnů, poté je třeba dobíjet účet na jakoukoli částku jednou za 3 měsíce. Těžko si představit kancelář, které potřebuje CRM a ústřednu, ale vůbec nepotřebuje ani číslo, ani hovory.

Proč je API pro bezplatné CRM důležité

Rozvoj ZCRM neustává ani na minutu, objevilo se množství větších a menších funkcí. Ale chápeme, že abychom představili skutečně funkční systém, a ne jen chytrou poznámkovou knihu, nestačí pouze integrace s telefonním systémem.
Čím více kontaktů se zákazníkem, tím lépe, a kontakty mohou být nejrůznější. Díky API lze bez problémů automaticky vkládat (nebo naopak získávat) informace o zákazníkovi/leadovi a úkolech. Díky tomu vzniká možnost připojit jakékoli komunikační kanály se zákazníky a jakékoli další automatizační systémy.
Díky API je možné zdarma ZCRM používat jak v celku, tak i částečně. Například jako pohodlné rozhraní pro práci s podnikový databází zákazníků nebo jako jednoduchý plánovač.
Následuje příklad takového kanálu — připojení k CRM lead formě na webu. Později na webu poskytneme i další příklady, například tvorbu úkolu na zpětné zavolání klienta (odložený hovor).

Hlavní metody API ZCRM

Jelikož API ZCRM nabízí 37 metod, zdržíme se popisu všech a představíme pouze hlavní skupiny s příklady.
Úplný seznam s příklady je dostupný na webu v popisu API CRM.

Možnost práce se následujícími skupinami metod:

Zákazníci (celkový seznam, jednotlivé výběry, úpravy, mazání)
Tagy a další vlastnosti zákazníků
Zákaznický feed (prohlížení, úpravy, mazání záznamů ve feedech zákazníků)
Zaměstnanci zákazníka (protože zákazník je obvykle právnická osoba, může mít několik zaměstnanců)
Úkoly (veškerá funkcionalita týkající se úkolů)
Lead (podobně veškeré funkce)
Uživatelé CRM (zobrazení seznamu uživatelů, jejich oprávnění, nastavení, kontakty a pracovní hodiny)
Hovory (vrací seznam hovorů)

Jelikož se používá stávající struktura API Zadarma, jsou pro ni již na GitHubu dostupné knihovny v PHP, C#, Python.

Příklad použití API

Nejjednodušší a přitom užitečný příklad — vytvoření leadu z formuláře. Pro minimalizaci kódu má tento příklad pouze základní údaje leadu. Podobný příklad, ale již s komentáři od klienta (obvykle jsou přítomny v každém formuláři), je dostupný v blogu na webu. Příklady skriptu jsou napsány na PHP bez frameworků, a proto se snadno integrují.
Příklad html formuláře pro vytvoření leadu:

<form method="POST" action="/cs/zcrm_leads/" data-trp-original-action="/zcrm_leads">
   <label for="name">Name:</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="Odeslat">
<input type="hidden" name="trp-form-language" value="cs"/></form>

Tento formulář je extrémně jednoduchý, aby nezatěžoval článek. Nemá žádný design, captcha, ani pole na komentář. V našem blogu je dostupná verze s polem pro komentáře (komentář se přidává do feedu zákazníka po vytvoření leadu).

A vlastně PHP příklad pro vytvoření leadu s údaji z formuláře:

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

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

function makePostRequest($method, $params)
{
   \/\/ nahraďte userKey a secret vašimi z osobního účtu
   $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
       )
   );
}

Jak vidíte, práce s API je poměrně jednoduchá a navíc jsou k dispozici vzory použití na PHP, C#, CouchDB. Tímto způsobem můžete bez větších problémů začlenit jednoduchý bezplatný CRM do jakéhokoli pracovního procesu a dosáhnout automatizace s minimálními náklady.
ZCRM se neustále vyvíjí a prakticky všechny nové funkce budou k dispozici také prostřednictvím API.
Také vás zveme k integraci vašich stávajících systémů s bezplatnými CRM a APT Zadarma.

Zdroj: habr.com

API pro bezplatnou CRM

Stručně o bezplatném CRM

Proč je API pro bezplatné CRM důležité

Hlavní metody API ZCRM

Příklad použití API