Ingyenes CRM API

Kevesebb mint egy évvel ezelőtt bemutattuk a díjmentes CRM rendszert, amely ingyenes telefonszolgáltatással van integrálva. Ez idő alatt 14 000 cég és 64 000 munkavállaló használta azt.
Jelenleg egy nyílt API felületet kínálunk, amely a ZCRM legtöbb funkcióját elérhetővé teszi. Az API lehetővé teszi a CRM használatát bármilyen értékesítési csatornán.
Az alábbiakban röviden ismertetjük az API használatát és elérhető funkcióit. Ezenkívül bemutatunk egy egyszerű, de hasznos és működő példát: egy scriptet, amely leadot hoz létre egy weboldal űrlapjából.

Röviden a díjmentes CRM-ről

Megkíméljük magunkat annak magyarázatától, hogy mi a CRM. Díjmentes CRM A Zadarma minden standard ügyfélinformációs funkciót támogat. Az információk az ügyfél idővonalán tárolódnak. Ezen kívül egy kényelmes feladatkezelő is elérhető, amely különböző megjelenítési lehetőségeket kínál (naptár, kanban, lista). Mindez 50+ munkavállalónak elérhető, és teljesen integrálva van a telefonszolgáltatással (beleértve a böngészőből történő hívásokat is WebRTC technológiával).

Mit jelent a díjmentesség? Nincs egyetlen olyan tarifánk vagy szolgáltatásunk sem a ZCRM-ben, amelyért fizetni kellene. Az egyetlen dolog, amiért fizetni szükséges — az a telefonhívások és a számok (speciális tarifákkal, például a moszkvai szám havi díja 95 rubel vagy a londoni 1 euró). De ha alig van hívás? Akkor szinte nem is kell fizetni.
A díjmentes CRM mindaddig aktív, amíg aktív a Zadarma ingyenes telefonszolgáltatása. A telefonszolgáltatás aktiválása után 2 hétig érhető el, ezt követően bármilyen összegű egyenlegfeltöltés szükséges 3 havonta. Nehéz elképzelni egy irodát, amelynek szüksége van CRM-re és telefonszolgáltatásra, de nem igényel számot vagy hívásokat.

Miért van szükség API-ra a díjmentes CRM-hez?

A ZCRM fejlesztése egy pillanatra sem áll le, számos nagy és apróbb funkció jelent meg. De tudjuk, hogy egy valóban funkcionális rendszert kell bemutatnunk, nem csupán egy okos jegyzetfüzetet, amelyhez nem elegendő a telefonszolgáltatással való integráció.
Minél több kapcsolatunk van az ügyféllel, annál jobb, és ezek a kapcsolatok a legkülönbözőbb formájúak lehetnek. Az API segítségével problémamentesen automatikusan bevihetjük (vagy éppen ellenkezőleg, lekérhetjük) az ügyfél/lead és feladatok információit. Ennek köszönhetően lehetőség nyílik bármilyen kommunikációs csatorna integrálására az ügyfelekkel és más automatizáló rendszerekre.
Az API-nak köszönhetően a ZCRM ingyenes verziója bármilyen módon használható, teljes mértékben vagy részben. Például kényelmes felületként szolgálhat a vállalati ügyfélbázis kezelésére, vagy egyszerű kényelmes időpontfoglalóként.
Az alábbiakban bemutatunk egy példát egy ilyen csatornára — csatlakozás a CRM lead-űrlaphoz a weboldalon. Később a weboldalon további példákat is bemutatunk, például egy feladat létrehozását az ügyfél visszahívására (elhalasztott hívás).

A ZCRM API főbb módszerei

Mivel a ZCRM API 37 módszert kínál, tartózkodunk az összes leírásától, csak a főbb csoportjaikat írjuk le példákkal.
A teljes lista példákkal elérhető a weboldalon a CRM API leírásában.

A következő módszercsoportokkal lehet dolgozni:

• Ügyfelek (általános lista, egyedi lekérdezések, szerkesztés, törlés)
• Címkék és ügyfél-további tulajdonságok
• Ügyfél hírcsatorna (bejegyzések megtekintése, szerkesztése, törlése az ügyfelek hírcsatornáiban)
• Ügyfél munkatársai (mivel az ügyfél általában jogi személy, több munkavállalóval is rendelkezhet)
• Feladatok (a feladatkezelés teljes funkcionalitása)
• Lead-ek (a hasonló összes funkció)
• CRM felhasználók (a felhasználók listájának megjelenítése, jogaik, beállításaik, kapcsolataik és munkarendjük)
• Hívások (visszaadja a hívások listáját)

Mivel a létező Zadarma API struktúráját használjuk, ehhez már elérhetők PHP, C# és Python könyvtárak a Github-on.

API használati példa

A legegyszerűbb és egyben hasznos példa — lead létrehozása egy űrlapból. A kód minimalizálása érdekében ez a példa csak az alapvető lead adatokat tartalmazza. Egy hasonló példa, de már az ügyfél megjegyzéseivel (amelyek általában minden űrlapon jelen vannak) elérhető a blogunkban a weboldalon. A példa script kézzelfoghatóan íródott PHP keretek nélkül, így könnyen beilleszthetők.
Példa HTML űrlap lead létrehozásához:

<form method="POST" action="/hu/zcrm_leads/" data-trp-original-action="/zcrm_leads">
   <label for="name">Név:</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-mail:</label><br>
   <input type="text" id="email" name="contacts[0][value]" value="">
   <br>
   <br>
   <input type="submit" value="Küldés">
<input type="hidden" name="trp-form-language" value="hu"/></form>

Ez az űrlap rendkívül egyszerű, hogy ne terhelje túl a cikket. Nincs designja, captcha vagy megjegyzésmezője. Blogunkban elérhető egy verzió megjegyzésmezővel (a megjegyzés az ügyfél hírcsatornájába kerül a lead létrehozása után).

És itt van a PHP példa a lead létrehozásához az űrlap adataiból:

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

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

function makePostRequest($method, $params)
{
   // cserélje a userKey és secret értékét a sajátjával
   $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
       )
   );
}

Ahogy látja, az API-val való munka meglehetősen egyszerű, és vannak példák is a használatra. PHP, C#, PythonÍgy különösebb nehézségek nélkül beilleszthetünk egy egyszerű, ingyenes CRM-et bármely munkafolyamatba, elérve az automatikát „kisebb erőfeszítéssel”.
A ZCRM folyamatosan fejlődik, és szinte minden új funkció elérhető lesz az API-n keresztül is.
Emellett arra is szeretnénk invitálni, hogy integrálja meglévő rendszereit a Zadarma ingyenes CRM-jével és telefonközpontjával.

Forrás: habr.com