API dla darmowego CRM

Mniej niż rok temu wprowadziliśmy darmowy system CRM zintegrowany z darmową centrala telefoniczną. W tym czasie skorzystało z niego 14 000 firm i 64 000 pracowników.
Obecnie oferujemy otwarty interfejs API, w którym dostępne są większość funkcji ZCRM. API umożliwia wykorzystanie CRM w różnych kanałach sprzedaży.
Poniżej krótko opiszemy pracę z API i dostępne funkcje. Podamy również prosty, ale przydatny i działający przykład: skrypt do tworzenia leada z formularza na stronie.

Krótko o darmowym CRM

Powstrzymamy się od wyjaśniania, czym jest CRM. Darmowy CRM Zadarma wspiera wszystkie standardowe funkcje przechowywania danych o kliencie. Informacje są zapisywane w historii klienta. Oprócz danych o klientach dostępny jest także wygodny menedżer zadań, który można dostosować do własnych potrzeb (kalendarz, kanban, lista). Wszystko to dostępne jest dla ponad 50 pracowników i w pełni zintegrowane z systemem telefonicznym (w tym połączenia z przeglądarki za pomocą technologii WebRTC).

Co znaczy darmowy? Nie ma żadnych taryf ani usług ZCRM, za które trzeba płacić. Jedyna rzecz, za którą trzeba płacić, to połączenia telefoniczne i numery (według specjalnych stawek, na przykład abonament za numer w Moskwie wynosi 95 rubli lub w Londynie 1 euro). A jeśli prawie nie ma połączeń? Wtedy nie trzeba płacić prawie nic.
Darmowy CRM jest aktywny, dopóki aktywna jest darmowa centrala telefoniczna Zadarma. Po rejestracji centralka jest aktywna przez 2 tygodnie, następnie należy doładować konto na dowolną kwotę raz na 3 miesiące. Trudno sobie wyobrazić biuro, które potrzebuje CRM i centrali telefonicznej, ale w ogóle nie potrzebuje ani numeru ani połączeń.

Dlaczego API jest potrzebne dla darmowego CRM

Rozwój ZCRM nie ustaje ani na chwilę, pojawiło się wiele większych i mniejszych funkcji. Ale rozumiemy, że aby stworzyć naprawdę funkcjonalny system, a nie tylko mądrą notatnik, wystarczy nie tylko integracja z telefonem.
Im więcej kontaktów z klientem, tym lepiej, a kontakty mogą być różnorodne. Dzięki API można bez problemu automatycznie wprowadzać (lub odwrotnie, uzyskiwać) informacje o kliencie/leadzie i zadaniach. Dzięki temu możliwe jest podłączenie wszelkich kanałów komunikacji z klientami i innych systemów automatyzacji.
Dzięki API darmowe ZCRM można wykorzystać na różne sposoby, zarówno w całości, jak i częściowo. Na przykład, jako wygodny interfejs do pracy z korporacyjną bazą klientów, lub prosty, wygodny planer.
Poniżej przedstawiamy przykład takiego kanału – połączenie z CRM przez formularz leadowy na stronie. Wkrótce na stronie zamieścimy inne przykłady, na przykład stworzenie zadania do oddzwonienia do klienta (odłożone połączenie).

Główne metody API ZCRM

Ponieważ w API ZCRM dostępnych jest 37 metod, powstrzymamy się od opisywania wszystkich, a jedynie opiszemy główne ich grupy z przykładami.
Pełna lista z przykładami dostępna jest na stronie w opisie API CRM.

Możliwa jest praca z następującymi grupami metod:

• Klienci (ogólny wykaz, pojedyncze zestawienia, edytowanie, usuwanie)
• Tagi i dodatkowe właściwości klientów
• Kanał klienta (przeglądanie, edytowanie, usuwanie zapisów w kanałach klientów)
• Pracownicy klienta (ponieważ klient jest zazwyczaj osobą prawną, może mieć wielu pracowników)
• Zadania (wszystkie funkcje dotyczące pracy z zadaniami)
• Lead'y (analogicznie wszystkie funkcje)
• Użytkownicy CRM (wyświetlanie listy użytkowników, ich uprawnienia, ustawienia, kontakty i godziny pracy)
• Połączenia (zwraca listę połączeń)

Ponieważ używana jest istniejąca struktura API Zadarma, na Githubie dostępne są już biblioteki w PHP, C#, Pythonie.

Przykład użycia API

Najprostszy i jednocześnie przydatny przykład – tworzenie leada z formularza. Aby zminimalizować kod, ten przykład zawiera tylko podstawowe dane leada. Podobny przykład, ale już z komentarzami od klienta (zazwyczaj obecnymi w każdym formularzu) dostępny jest w blogu na stronie. Przykłady skryptu napisane są na PHP bez frameworków, dlatego łatwo je zintegrować.
Przykład formularza HTML do tworzenia leada:

<form method="POST" action="/pl/zcrm_leads/" data-trp-original-action="/zcrm_leads">
   <label for="name">Nazwa:</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="Wyślij">
<input type="hidden" name="trp-form-language" value="pl"/></form>

Ten formularz jest bardzo prosty, aby nie przeciążać artykułu. Nie zawiera ani designu, ani captcha, ani pola z komentarzem. W naszym blogu dostępna jest wersja z polem komentarzy (komentarz dodawany jest do kanału klienta po utworzeniu leada).

I oto przykład PHP do tworzenia leada z danymi z formularza:

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

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

function makePostRequest($method, $params)
{
   \/\/ zastąp userKey i secret swoimi danymi z panelu użytkownika
   $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 widać, praca z API jest dość prosta, a ponadto są dostępne przykłady użycia na PHP, C#, Python. W ten sposób bez większych problemów można wprowadzić prostą bezpłatną CRM do każdego procesu roboczego, uzyskując automatyzację 'niewielkim kosztem'.
ZCRM nieustannie się rozwija i prawie wszystkie nowe funkcje będą dostępne również poprzez API.
Zapraszamy także do integracji istniejących systemów z bezpłatnymi CRM i ATE Zadarma.

Źródło: habr.com