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.
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
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).
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
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