Zdarma CRM API

Zdarma CRM API

Před necelým rokem jsme představili bezplatný CRM systém integrovaný s bezplatnou PBX. Za tuto dobu jej využilo 14 000 firem a 64 000 zaměstnanců.
Nyní nabízíme otevřené API rozhraní, ve kterém je dostupná většina funkcí ZCRM. API vám umožňuje používat CRM pro jakékoli prodejní kanály.
Níže stručně popíšeme práci s API a dostupnou funkcionalitu. Je také uveden jednoduchý, ale užitečný a fungující příklad: skript pro vytvoření potenciálního zákazníka z formuláře na webu.

Stručně o bezplatném CRM

Zdržíme se vysvětlování, co je CRM. Zdarma CRM Zadarma podporuje všechny standardní funkce ukládání dat zákazníků. Informace jsou uloženy ve feedu klienta. Kromě informací o zákaznících je také k dispozici pohodlný správce úloh s displejem pro každý vkus (kalendář, kanban, seznam). To vše je k dispozici pro 50+ zaměstnanců a je plně integrováno s telefonováním (včetně volání z prohlížeče využívajícího technologii WebRTC).
Zdarma CRM API
Co znamená zdarma? Neexistují žádné tarify nebo služby ZCRM, za které byste museli platit. Jediné, za co musíte platit, jsou telefonní hovory a čísla (podle speciálních tarifů je například měsíční poplatek za číslo v Moskvě 95 rublů nebo v Londýně 1 euro). A pokud nejsou téměř žádné hovory? Skoro nemusíte platit.
Free CRM je aktivní, když je aktivní bezplatná PBX Zadarma. Po registraci je ústředna aktivní 2 týdny, v budoucnu je nutné 1x za 3 měsíce doplnit účet o libovolnou částku. Je těžké si představit kancelář, která potřebuje CRM a PBX, ale není potřeba žádné číslo ani hovory.

Proč potřebujete API pro bezplatné CRM

Vývoj ZCRM se nezastaví ani na minutu, objevilo se mnoho velkých i malých funkcí. Chápeme ale, že k představení skutečně funkčního systému, a nejen chytrého notebooku, nestačí integrace telefonování.
Čím více kontaktů s klientem, tím lépe a kontakty mohou být velmi odlišné. Díky API můžete bez problémů automaticky zadávat (nebo naopak přijímat) informace o klientovi / leadu a úkolech. Díky tomu je možné propojit jakékoli komunikační kanály se zákazníky a dalšími automatizačními systémy.
Díky API lze bezplatné ZCRM využít jakýmkoliv způsobem, ať už zcela nebo částečně. Například jako pohodlné rozhraní pro práci s firemní zákaznickou základnou nebo jako jednoduchý pohodlný plánovač.
Níže je uveden příklad takového kanálu – připojení k formulářům pro zájemce CRM na webu. Později na webu uvedeme další příklady, například vytvoření úkolu zavolat klientovi zpět (odložený hovor).

Základní metody ZCRM API

Vzhledem k tomu, že v ZCRM API je dostupných 37 metod, zdržíme se popisu všech, na příkladech popíšeme pouze jejich hlavní skupiny.
Kompletní seznam s příklady je k dispozici na webových stránkách na adrese Popis CRM API.

Je možné pracovat s následujícími skupinami metod:

  • Klienti (obecný seznam, jednotlivé výběry, editace, mazání)
  • Tagy a další vlastnosti klientů
  • Zákaznický kanál (prohlížení, úpravy, mazání záznamů v zákaznických kanálech)
  • Zaměstnanci klienta (protože klientem je obvykle právnická osoba, může mít i poměrně dost zaměstnanců)
  • Úkoly (všechny funkce pro práci s úkoly)
  • Vedení (podobně všechny funkce)
  • Uživatelé CRM (zobrazení seznamu uživatelů, jejich práv, nastavení, kontaktů a pracovní doby)
  • Hovory (vrací seznam hovorů)

Vzhledem k tomu, že je použita stávající struktura API Zadarma, jsou pro ni na Githubu již dostupné knihovny v PHP, C#, Pythonu.

Příklad použití API

Nejjednodušším, ale nejužitečnějším příkladem je vytvoření potenciálního zákazníka z formuláře. Aby byl kód co nejmenší, obsahuje tento příklad pouze základní údaje o potenciálním zákazníkovi. K dispozici je podobný příklad, ale s komentáři od klienta (obvykle přítomnými v každém formuláři). na blogu Online. Příklady skriptů jsou napsány PHP bez rámců, a proto se snadno vkládají.
Příklad html formuláře pro vytvoření potenciálního zákazníka:

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

Tento formulář je extrémně jednoduchý, aby nepřetěžoval článek. Nemá žádný design, žádné captcha, žádné pole pro komentáře. Na našem blogu je k dispozici verze s polem komentáře (komentář je přidán do feedu klienta po vytvoření leadu).

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

<?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
       )
   );
}

Jak můžete vidět, práce s API je docela jednoduchá, navíc existují příklady práce PHP, C#, PYTHON. Bez problémů tak můžete jednoduchý bezplatný CRM začlenit do jakéhokoli pracovního postupu, když jste automatizovali s trochou krve.
ZCRM se neustále vyvíjí a téměř všechny nové funkce budou dostupné prostřednictvím API.
Zveme vás také k integraci vašich stávajících systémových systémů s bezplatným CRM a PBX Zadarma.

Zdroj: www.habr.com

Přidat komentář