უფასო CRM API

ერთ წელზე ნაკლები ხნის წინ, ჩვენ დავნერგეთ უფასო CRM სისტემა, რომელიც ინტეგრირებულია უფასო PBX-თან. ამ ხნის განმავლობაში 14-მა კომპანიამ და 000-მა თანამშრომელმა ისარგებლა.
ახლა ჩვენ გთავაზობთ ღია API ინტერფეისს, რომელშიც ZCRM-ის ფუნქციების უმეტესობა ხელმისაწვდომია. API საშუალებას გაძლევთ გამოიყენოთ CRM გაყიდვების ნებისმიერი არხისთვის.
ქვემოთ მოკლედ აღვწერთ API-სთან მუშაობას და მის ხელმისაწვდომ ფუნქციონირებას. ასევე მოცემულია მარტივი, მაგრამ სასარგებლო და სამუშაო მაგალითი: საიტზე არსებული ფორმიდან ტყვიის შექმნის სკრიპტი.

მოკლედ უფასო CRM-ის შესახებ

თავი შევიკავოთ ახსნისგან რა არის CRM. უფასო CRM Zadarma მხარს უჭერს მომხმარებლის მონაცემთა შენახვის ყველა სტანდარტულ ფუნქციას. ინფორმაცია ინახება კლიენტის არხში. ასევე, მომხმარებელთა შესახებ ინფორმაციის გარდა, ხელმისაწვდომია მოსახერხებელი დავალების მენეჯერი დისპლეით ყველა გემოვნებისთვის (კალენდარი, კანბანი, სია). ეს ყველაფერი ხელმისაწვდომია 50+ თანამშრომლისთვის და სრულად არის ინტეგრირებული ტელეფონთან (მათ შორის ზარები ბრაუზერიდან WebRTC ტექნოლოგიის გამოყენებით).

რას ნიშნავს უფასო? არ არსებობს ZCRM ტარიფები ან სერვისები, რომლებშიც უნდა გადაიხადოთ. ერთადერთი, რისი გადახდაც მოგიწევთ არის სატელეფონო ზარები და ნომრები (სპეციალური ტარიფების მიხედვით, მაგალითად, ნომრის ყოველთვიური გადასახადი მოსკოვში არის 95 რუბლი ან ლონდონში 1 ევრო). და თუ ზარები თითქმის არ არის? თქვენ თითქმის არ უნდა გადაიხადოთ.
უფასო CRM აქტიურია, ხოლო უფასო PBX Zadarma აქტიურია. რეგისტრაციის შემდეგ PBX მოქმედებს 2 კვირის განმავლობაში, სამომავლოდ საჭიროა ნებისმიერი თანხით ანგარიშის შევსება 1 თვეში 3-ჯერ. ძნელი წარმოსადგენია ოფისი, რომელსაც სჭირდება CRM და PBX, მაგრამ საერთოდ არ არის საჭირო ნომერი და ზარები.

რატომ გჭირდებათ API უფასო CRM-ისთვის

ZCRM-ის განვითარება ერთი წუთით არ ჩერდება, ბევრი დიდი და პატარა ფუნქცია გამოჩნდა. მაგრამ ჩვენ გვესმის, რომ ჭეშმარიტად ფუნქციონალური სისტემის წარმოსაჩენად და არა მხოლოდ ჭკვიანი ნოუთბუქის, სატელეფონო ინტეგრაცია საკმარისი არ არის.
რაც უფრო მეტი კონტაქტია კლიენტთან, მით უკეთესი და კონტაქტები შეიძლება ძალიან განსხვავებული იყოს. API-ს წყალობით, თქვენ შეგიძლიათ ავტომატურად შეიყვანოთ (ან, პირიქით, მიიღოთ) ინფორმაცია კლიენტის / წამყვანის და ამოცანების შესახებ უპრობლემოდ. ამის წყალობით შესაძლებელი ხდება კომუნიკაციის ნებისმიერი არხის დაკავშირება მომხმარებლებთან და სხვა ავტომატიზაციის სისტემებთან.
API-ს წყალობით, უფასო ZCRM შეიძლება გამოყენებულ იქნას ნებისმიერი გზით, მთლიანად ან ნაწილობრივ. მაგალითად, როგორც მოსახერხებელი ინტერფეისი კორპორატიულ მომხმარებელთა ბაზასთან მუშაობისთვის, ან როგორც მარტივი მოსახერხებელი გრაფიკი.
ქვემოთ მოცემულია ასეთი არხის მაგალითი - საიტზე CRM წამყვან ფორმებთან დაკავშირება. მოგვიანებით საიტზე მივცემთ სხვა მაგალითებს, მაგალითად, დავალების შექმნა კლიენტის უკან დარეკვისთვის (გადადებული ზარი).

ძირითადი ZCRM API მეთოდები

ვინაიდან ZCRM API-ში ხელმისაწვდომია 37 მეთოდი, ჩვენ თავს შევიკავებთ ყველა მათგანის აღწერისგან, აღვწერთ მხოლოდ მათ ძირითად ჯგუფებს მაგალითებით.
სრული სია მაგალითებით ხელმისაწვდომია ვებსაიტზე მისამართზე CRM API-ს აღწერა.

შესაძლებელია შემდეგი ჯგუფების მეთოდებით მუშაობა:

• კლიენტები (ზოგადი სია, ცალკე არჩევანი, რედაქტირება, წაშლა)
• ტეგები და კლიენტების დამატებითი თვისებები
• მომხმარებელთა არხი (ნახვა, რედაქტირება, ჩანაწერების წაშლა მომხმარებელთა არხებში)
• კლიენტის თანამშრომლები (რადგან კლიენტი ჩვეულებრივ იურიდიული პირია, მას შეიძლება ჰყავდეს საკმაოდ ბევრი თანამშრომელი)
• ამოცანები (ყველა ფუნქცია ამოცანებთან მუშაობისთვის)
• ლიდერობს (მსგავსად, ყველა ფუნქცია)
• CRM მომხმარებლები (მომხმარებელთა სიის ჩვენება, მათი უფლებები, პარამეტრები, კონტაქტები და სამუშაო საათები)
• ზარები (აბრუნებს ზარების სიას)

მას შემდეგ, რაც გამოიყენება არსებული Zadarma API სტრუქტურა, ბიბლიოთეკები PHP, C#, Python-ში უკვე ხელმისაწვდომია Github-ზე.

API გამოყენების მაგალითი

უმარტივესი, მაგრამ ყველაზე სასარგებლო მაგალითია ტყვიის შექმნა ფორმიდან. კოდის მინიმუმამდე შესანარჩუნებლად, ეს მაგალითი შეიცავს მხოლოდ ძირითად მონაცემებს. მსგავსი მაგალითი, მაგრამ კლიენტის კომენტარებით (ჩვეულებრივ, ყველა ფორმით არის წარმოდგენილი). ბლოგზე ონლაინ. სკრიპტის მაგალითები იწერება PHP ჩარჩოების გარეშე და ამიტომ ადვილად ჩასმული.
html ფორმის მაგალითი ლიდერობის შესაქმნელად:

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

ეს ფორმა ძალიან მარტივია, რათა არ გადაიტვირთოს სტატია. მას არ აქვს დიზაინი, კაპჩა, კომენტარების ველი. ვერსია კომენტარის ველით ხელმისაწვდომია ჩვენს ბლოგზე (კომენტარი ემატება კლიენტის არხს მას შემდეგ, რაც ტყვიის შექმნის შემდეგ).

და რეალურად PHP მაგალითი ფორმიდან მონაცემებით ტყვიის შესაქმნელად:

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

როგორც ხედავთ, API-სთან მუშაობა საკმაოდ მარტივია, გარდა ამისა, არსებობს მუშაობის მაგალითები PHP, C#, Python. ამრიგად, უპრობლემოდ, თქვენ შეგიძლიათ მოათავსოთ მარტივი უფასო CRM ნებისმიერ სამუშაო პროცესზე, მცირე სისხლით ავტომატიზაციის მიღების შემდეგ.
ZCRM მუდმივად ვითარდება და თითქმის ყველა ახალი ფუნქცია ხელმისაწვდომი იქნება API-ს მეშვეობით.
ჩვენ ასევე გეპატიჟებით თქვენი არსებული სისტემის სისტემების ინტეგრირება უფასო CRM-თან და PBX Zadarma-თან.

წყარო: www.habr.com