ProHoster > Blog > Ma'muriyat > Bepul CRM API

Bepul CRM API

Bepul CRM API

Bir yildan kamroq vaqt oldin biz bepul PBX bilan integratsiyalangan bepul CRM tizimini joriy qildik. Shu vaqt ichida undan 14 ming kompaniya va 000 ming xodim foydalangan.
Endi biz ochiq API interfeysini taklif qilamiz, unda ZCRM-ning aksariyat funktsiyalari mavjud. API har qanday savdo kanallari uchun CRM dan foydalanish imkonini beradi.
Quyida biz API va mavjud funksiyalar bilan ishlashni qisqacha tasvirlab beramiz. Oddiy, ammo foydali va ishlaydigan misol ham keltirilgan: saytdagi formadan etakchi yaratish uchun skript.

Bepul CRM haqida qisqacha

Keling, CRM nima ekanligini tushuntirishdan tiyilaylik. Bepul CRM Zadarma barcha standart mijozlar ma'lumotlarini saqlash funktsiyalarini qo'llab-quvvatlaydi. Ma'lumotlar mijozning tasmasida saqlanadi. Bundan tashqari, mijozlar haqidagi ma'lumotlarga qo'shimcha ravishda, har qanday did uchun displeyga ega (taqvim, kanban, ro'yxat) qulay vazifa menejeri mavjud. Bularning barchasi 50 dan ortiq xodimlar uchun mavjud va telefoniya bilan to'liq birlashtirilgan (shu jumladan WebRTC texnologiyasidan foydalangan holda brauzerdan qo'ng'iroqlar).
Bepul CRM API
Bepul nimani anglatadi? Siz to'lashingiz kerak bo'lgan ZCRM tariflari yoki xizmatlari yo'q. Siz to'lashingiz kerak bo'lgan yagona narsa - telefon qo'ng'iroqlari va raqamlar (maxsus tariflarga ko'ra, masalan, Moskvadagi raqam uchun oylik to'lov 95 rubl yoki Londonda 1 evro). Va agar qo'ng'iroqlar deyarli bo'lmasa? Siz deyarli to'lashingiz shart emas.
Bepul CRM faol, bepul PBX Zadarma faol. Ro'yxatdan o'tgandan so'ng, ATS 2 hafta davomida ishlaydi, kelajakda hisobni 1 oy ichida 3 marta istalgan miqdorga to'ldirish kerak. CRM va PBX kerak bo'lgan ofisni tasavvur qilish qiyin, lekin hech qanday raqam yoki qo'ng'iroqlar kerak emas.

Nega sizga bepul CRM uchun API kerak

ZCRM ning rivojlanishi bir daqiqaga to'xtamaydi, ko'plab katta va kichik funktsiyalar paydo bo'ldi. Ammo biz tushunamizki, shunchaki aqlli daftarni emas, balki haqiqiy funktsional tizimni taqdim etish uchun telefoniya integratsiyasi etarli emas.
Mijoz bilan qanchalik ko'p aloqalar bo'lsa, shuncha yaxshi bo'ladi va aloqalar juda boshqacha bo'lishi mumkin. API tufayli siz hech qanday muammosiz mijoz/etakchi va vazifalar haqida ma'lumotlarni avtomatik ravishda kiritishingiz (yoki aksincha, olishingiz) mumkin. Buning yordamida mijozlar bilan har qanday aloqa kanallarini va boshqa har qanday avtomatlashtirish tizimlarini ulash mumkin bo'ladi.
API tufayli bepul ZCRM-dan to'liq yoki qisman har qanday usulda foydalanish mumkin. Masalan, korporativ mijozlar bazasi bilan ishlash uchun qulay interfeys yoki oddiy qulay rejalashtiruvchi sifatida.
Quyida bunday kanalning namunasi keltirilgan - saytdagi CRM etakchi shakllariga ulanish. Keyinchalik saytda biz boshqa misollarni keltiramiz, masalan, mijozni qaytarib qo'ng'iroq qilish uchun vazifa yaratish (kechiktirilgan qo'ng'iroq).

Asosiy ZCRM API usullari

ZCRM API-da 37 ta usul mavjud bo'lganligi sababli, biz ularning barchasini tavsiflashdan bosh tortamiz, biz faqat ularning asosiy guruhlarini misollar bilan tasvirlaymiz.
Misollar bilan to'liq ro'yxat veb-saytda mavjud CRM API tavsifi.

Quyidagi usullar guruhlari bilan ishlash mumkin:

  • Mijozlar (umumiy ro'yxat, alohida tanlovlar, tahrirlash, o'chirish)
  • Teglar va mijozlarning qo'shimcha xususiyatlari
  • Mijoz tasmasi (mijozlar tasmasidagi yozuvlarni ko'rish, tahrirlash, o'chirish)
  • Mijozning xodimlari (mijoz odatda yuridik shaxs bo'lganligi sababli uning bir nechta xodimlari bo'lishi mumkin)
  • Vazifalar (topshiriqlar bilan ishlash uchun barcha funksiyalar)
  • Etakchilar (xuddi shunday, barcha funktsiyalar)
  • CRM foydalanuvchilari (foydalanuvchilar ro'yxatini, ularning huquqlarini, sozlamalarini, kontaktlarini va ish vaqtini ko'rsatish)
  • Qo'ng'iroqlar (qo'ng'iroqlar ro'yxatini qaytaradi)

Mavjud Zadarma API tuzilmasi ishlatilganligi sababli, PHP, C#, Python kutubxonalari Githubda allaqachon mavjud.

API foydalanish misoli

Eng oddiy, ammo eng foydali misol - bu shakldan etakchi yaratish. Kodni minimal darajada ushlab turish uchun ushbu misolda faqat asosiy yetakchi ma'lumotlar mavjud. Shunga o'xshash misol, lekin mijozning sharhlari bilan (odatda har bir shaklda mavjud) mavjud blogda saytda. Skript misollari yozilgan PHP ramkalarsiz va shuning uchun osongina ko'milgan.
Etakchi yaratish uchun html formasiga misol:

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

Ushbu shakl maqolani ortiqcha yuklamaslik uchun juda oddiy. Unda dizayn yo'q, captcha yo'q, sharhlar maydoni yo'q. Sharh maydoniga ega versiya bizning blogimizda mavjud (sharh mijozning tasmasiga yetakchi yaratilgandan keyin qoβ€˜shiladi).

Va aslida formadagi ma'lumotlar bilan etakchi yaratish uchun PHP misoli:

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

Ko'rib turganingizdek, API bilan ishlash juda oddiy, bundan tashqari, ishlashga misollar mavjud PHP, C#, Python. Shunday qilib, siz hech qanday muammosiz oddiy bepul CRM-ni har qanday ish jarayoniga moslashtira olasiz, bunda ozgina qon bilan avtomatlashtirish olinadi.
ZCRM doimiy ravishda rivojlanmoqda va deyarli barcha yangi xususiyatlar API orqali mavjud bo'ladi.
Shuningdek, biz sizni mavjud tizim tizimlaringizni bepul CRM va PBX Zadarma bilan integratsiyalashga taklif qilamiz.

Manba: www.habr.com

a Izoh qo'shish