नि: शुल्क CRM API

एक वर्ष भन्दा कम समय अघि, हामीले नि:शुल्क PBX सँग एकीकृत CRM प्रणाली प्रस्तुत गर्यौं। यस अवधिमा, 14 कम्पनी र 000 कर्मचारीहरूले प्रयोग गरेका छन्।
अब हामी खुला एपीआई इन्टरफेस प्रस्ताव गर्दछौं, जसमा ZCRM को धेरै कार्यहरू उपलब्ध छन्। API ले तपाईंलाई कुनै पनि बिक्री च्यानलहरूको लागि CRM प्रयोग गर्न अनुमति दिन्छ।
तल हामी API सँगको काम र उपलब्ध कार्यक्षमताको संक्षिप्त वर्णन गर्छौं। एउटा सरल तर उपयोगी र काम गर्ने उदाहरण पनि दिइएको छ: साइटमा भएको फारमबाट नेतृत्व सिर्जना गर्ने स्क्रिप्ट।

नि: शुल्क CRM को बारे मा छोटकरीमा

CRM भनेको के हो भनेर व्याख्या गर्नबाट टाढा रहौं। नि: शुल्क CRM Zadarma सबै मानक ग्राहक डाटा भण्डारण कार्यहरू समर्थन गर्दछ। जानकारी ग्राहकको फिडमा भण्डार गरिएको छ। साथै, ग्राहकहरु को बारे मा जानकारी को अतिरिक्त, एक सुविधाजनक कार्य प्रबन्धक हरेक स्वाद को लागी एक प्रदर्शन संग उपलब्ध छ (क्यालेन्डर, kanban, सूची)। यो सबै ५०+ कर्मचारीहरूको लागि उपलब्ध छ र टेलिफोनीसँग पूर्ण रूपमा एकीकृत छ (WebRTC प्रविधि प्रयोग गरेर ब्राउजरबाट कलहरू सहित)।

स्वतन्त्र भनेको के हो? त्यहाँ कुनै ZCRM शुल्क वा सेवाहरू छैनन् जसको लागि तपाईंले तिर्नुपर्छ। तपाईंले तिर्नु पर्ने एक मात्र चीज फोन कल र नम्बरहरू हो (विशेष ट्यारिफहरू अनुसार, उदाहरणका लागि, मस्कोमा नम्बरको लागि मासिक शुल्क 95 रूबल वा लन्डन 1 यूरो हो)। र यदि त्यहाँ लगभग कुनै कलहरू छैनन्? तपाईंले लगभग तिर्नु पर्दैन।
नि: शुल्क CRM सक्रिय छ जबकि नि: शुल्क PBX Zadarma सक्रिय छ। दर्ता पछि, PBX 2 हप्ताको लागि सक्रिय छ, भविष्यमा खातालाई 1 महिनामा 3 पटक पुन: भर्न आवश्यक छ। CRM र PBX चाहिने कार्यालयको कल्पना गर्न गाह्रो छ, तर कुनै नम्बर वा कलहरू आवश्यक पर्दैन।

तपाईलाई किन नि:शुल्क 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="/ne/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
       )
   );
}

तपाईले देख्न सक्नुहुन्छ, एपीआईसँग काम गर्नु एकदम सरल छ, साथै त्यहाँ काम गर्ने उदाहरणहरू छन् PHP, C#, अजगर। तसर्थ, कुनै पनि समस्या बिना, तपाईं कुनै पनि कार्यप्रवाहमा एक साधारण नि: शुल्क CRM फिट गर्न सक्नुहुन्छ, थोरै रगतको साथ स्वचालन प्राप्त गरेर।
ZCRM निरन्तर विकसित हुँदैछ र लगभग सबै नयाँ सुविधाहरू API मार्फत उपलब्ध हुनेछन्।
हामी तपाईंलाई नि:शुल्क CRM र PBX Zadarma सँग आफ्नो विद्यमान प्रणाली प्रणालीहरू एकीकृत गर्न निमन्त्रणा गर्दछौं।

स्रोत: www.habr.com