وړیا CRM API

وړیا CRM API

له یو کال څخه لږ دمخه، موږ د وړیا PBX سره مدغم یو وړیا CRM سیسټم معرفي کړ. په دې موده کې، 14 شرکتونو او 000 کارمندانو دا کارولې ده.
اوس موږ د خلاص API انٹرفیس وړاندیز کوو، په کوم کې چې د ZCRM ډیری دندې شتون لري. API تاسو ته اجازه درکوي چې د هر پلور چینلونو لپاره CRM وکاروئ.
لاندې موږ په لنډ ډول د API سره کار او موجود فعالیت تشریح کوو. یو ساده مګر ګټور او کاري مثال هم ورکړل شوی: په سایټ کې د فارم څخه د لیډ جوړولو لپاره سکریپټ.

په لنډه توګه د وړیا CRM په اړه

راځئ چې د تشریح کولو څخه ډډه وکړو چې CRM څه دی. وړیا CRM Zadarma د پیرودونکو ډیټا ذخیره کولو ټولو معیاري کارونو ملاتړ کوي. معلومات د پیرودونکي په فیډ کې زیرمه شوي. همچنان ، د پیرودونکو په اړه معلوماتو سربیره ، یو مناسب کاري مدیر د هر خوند لپاره د نندارې سره شتون لري (کلنډر ، کانبان ، لیست). دا ټول د 50+ کارمندانو لپاره شتون لري او په بشپړ ډول د تلیفوني سره مدغم شوي (د WebRTC ټیکنالوژۍ په کارولو سره د براوزر څخه تلیفونونو په شمول).
وړیا CRM API
ازاد څه ته وايي؟ د 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 کې کتابتونونه دمخه د دې لپاره په ګیتوب کې شتون لري.

د API کارولو مثال

ترټولو ساده مګر خورا ګټور مثال د فارم څخه لیډ رامینځته کول دي. د کوډ لږ تر لږه ساتلو لپاره، دا مثال یوازې د اصلي مخکښ ډاټا لري. یو ورته مثال، مګر د مراجعینو څخه د تبصرو سره (معمولا په هر شکل کې شتون لري) شتون لري په بلاګ کې آنلاین. د سکریپټ مثالونه په کې لیکل شوي پی ایچ پی پرته له چوکاټ څخه او له همدې امله په اسانۍ سره ځای پرځای شوي.
د لیډ جوړولو لپاره د html فارم یوه بیلګه:

<form method="POST" action="/ps/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 سره کار کول خورا ساده دي، سربیره پردې د کار کولو مثالونه شتون لري پی ایچ پی, C#, Python. پدې توګه ، پرته له کومې ستونزې ، تاسو کولی شئ په هر کاري فلو کې ساده وړیا CRM فټ کړئ ، د لږ وینې سره اتومات ترلاسه کولو سره.
ZCRM په دوامداره توګه وده کوي او نږدې ټولې نوې ب featuresې به د API له لارې شتون ولري.
موږ تاسو ته بلنه درکوو چې خپل موجوده سیسټم سیسټمونه د وړیا CRM او PBX Zadarma سره یوځای کړئ.

سرچینه: www.habr.com

Add a comment