නොමිලේ CRM API

වසරකට අඩු කාලයකට පෙර, අපි නොමිලේ PBX සමඟ ඒකාබද්ධ වූ නොමිලේ CRM පද්ධතියක් හඳුන්වා දුන්නෙමු. මෙම කාලය තුළ සමාගම් 14 ක් සහ සේවකයින් 000 ක් එය භාවිතා කර ඇත.
දැන් අපි විවෘත API අතුරුමුහුණතක් පිරිනමන්නෙමු, එහි ZCRM හි බොහෝ කාර්යයන් තිබේ. ඕනෑම විකුණුම් නාලිකා සඳහා CRM භාවිතා කිරීමට API ඔබට ඉඩ සලසයි.
පහතින් අපි API සමඟ වැඩ කිරීම සහ පවතින ක්‍රියාකාරීත්වය කෙටියෙන් විස්තර කරමු. සරල නමුත් ප්‍රයෝජනවත් සහ ක්‍රියාකාරී උදාහරණයක් ද ලබා දී ඇත: වෙබ් අඩවියේ පෝරමයකින් ඊයම් සෑදීම සඳහා ස්ක්‍රිප්ට් එකක්.

නොමිලේ CRM ගැන කෙටියෙන්

CRM යනු කුමක්දැයි පැහැදිලි කිරීමෙන් වළකිමු. නොමිලේ CRM Zadarma සියළුම සම්මත පාරිභෝගික දත්ත ගබඩා කිරීමේ කාර්යයන් සඳහා සහය දක්වයි. තොරතුරු සේවාදායකයාගේ සංග්‍රහයේ ගබඩා කර ඇත. එසේම, ගනුදෙනුකරුවන් පිළිබඳ තොරතුරු වලට අමතරව, සෑම රසයක් සඳහාම (කැලැන්ඩරය, කන්බන්, ලැයිස්තුව) සංදර්ශකය සමඟ පහසු කාර්ය කළමනාකරු ලබා ගත හැකිය. මේ සියල්ල 50+ සේවකයින් සඳහා ලබා ගත හැකි අතර දුරකථන සමඟ සම්පුර්ණයෙන්ම ඒකාබද්ධ වේ (WebRTC තාක්ෂණය භාවිතා කරන බ්‍රවුසරයකින් ලැබෙන ඇමතුම් ඇතුළුව).

නිදහස් යන්නෙන් අදහස් කරන්නේ කුමක්ද? ඔබට ගෙවිය යුතු ZCRM ගාස්තු හෝ සේවාවන් නොමැත. ඔබට ගෙවිය යුතු එකම දෙය දුරකථන ඇමතුම් සහ අංක (විශේෂ ගාස්තු අනුව, උදාහරණයක් ලෙස, මොස්කව්හි අංකයක් සඳහා මාසික ගාස්තුව රුබල් 95 ක් හෝ ලන්ඩන් යුරෝ 1 කි). සහ පාහේ ඇමතුම් නොමැති නම්? ඔබ පාහේ ගෙවිය යුතු නැත.
නොමිලේ CRM සක්‍රීය වන අතර නොමිලේ PBX Zadarma සක්‍රිය වේ. ලියාපදිංචි වීමෙන් පසුව, PBX සති 2 ක් සඳහා ක්රියාකාරී වේ, අනාගතයේදී එය මාස 1 කින් 3 වරක් ඕනෑම මුදලක් සඳහා ගිණුම නැවත පිරවීම අවශ්ය වේ. CRM සහ PBX අවශ්‍ය කාර්යාලයක් ගැන සිතීම අපහසුය, නමුත් කිසිදු අංකයක් හෝ ඇමතුමක් අවශ්‍ය නොවේ.

ඔබට නොමිලේ CRM සඳහා API අවශ්‍ය වන්නේ ඇයි?

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="/si/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