Inqas minn sena ilu, daħħalna sistema CRM b'xejn integrata ma 'PBX b'xejn. Matul dan iż-żmien, użawha 14 kumpanija u 000 impjegat.
Issa noffru interface API miftuħ, li fih ħafna mill-funzjonijiet ta 'ZCRM huma disponibbli. L-API jippermettilek tuża CRM għal kwalunkwe kanal tal-bejgħ.
Hawn taħt niddeskrivu fil-qosor ix-xogħol bl-API u l-funzjonalità disponibbli. Jingħata wkoll eżempju sempliċi iżda utli u ta 'ħidma: skript għall-ħolqien ta' ċomb minn formola fuq is-sit.
Fil-qosor dwar is-CRM b'xejn
Ejja noqogħdu lura milli nispjegaw x'inhu CRM.
Xi jfisser ħielsa? M'hemm l-ebda tariffi jew servizzi ZCRM li trid tħallas għalihom. L-unika ħaġa li trid tħallas għaliha hija telefonati u numri (skond tariffi speċjali, pereżempju, tariffa ta 'kull xahar għal numru f'Moska hija 95 rublu jew Londra hija euro 1). U jekk kważi ma jkunx hemm telefonati? Kważi m'għandekx għalfejn tħallas.
CRM b'xejn huwa attiv filwaqt li PBX bla ħlas Zadarma huwa attiv. Wara r-reġistrazzjoni, il-PBX huwa attiv għal ġimgħat 2, fil-futur huwa meħtieġ li jimtela l-kont għal kwalunkwe ammont darba 1 fi xhur 3. Huwa diffiċli li wieħed jimmaġina uffiċċju li jeħtieġ CRM u PBX, iżda l-ebda numru jew sejħiet ma huma meħtieġa għal kollox.
Għaliex għandek bżonn API għal CRM b'xejn
L-iżvilupp ta 'ZCRM ma jieqafx għal minuta, dehru ħafna funzjonijiet kbar u żgħar. Imma nifhmu li sabiex nippreżentaw sistema tassew funzjonali, u mhux biss notebook intelliġenti, l-integrazzjoni tat-telefonija mhix biżżejjed.
L-aktar kuntatti mal-klijent, l-aħjar, u l-kuntatti jistgħu jkunu differenti ħafna. Grazzi għall-API, tista 'tidħol awtomatikament (jew, għall-kuntrarju, tirċievi) informazzjoni dwar il-klijent / ċomb u l-kompiti mingħajr problemi. Grazzi għal dan, isir possibbli li tikkonnettja kwalunkwe kanal ta 'komunikazzjoni mal-klijenti u kwalunkwe sistema oħra ta' awtomazzjoni.
Grazzi għall-API, ZCRM b'xejn jista 'jintuża bi kwalunkwe mod, jew kollu jew parzjalment. Pereżempju, bħala interface konvenjenti biex taħdem ma 'bażi ta' klijenti korporattiva, jew bħala skedar sempliċi konvenjenti.
Hawn taħt hemm eżempju ta 'tali kanal - konnessjoni ma' forom taċ-ċomb CRM fuq is-sit. Aktar tard fuq is-sit se nagħtu eżempji oħra, pereżempju, noħolqu kompitu biex issejjaħ lura lill-klijent (sejħa differita).
Metodi Bażiċi ZCRM API
Peress li hemm 37 metodu disponibbli fl-API ZCRM, aħna se nżommu lura milli niddeskrivuhom kollha, se niddeskrivu biss il-gruppi ewlenin tagħhom b'eżempji.
Lista kompluta b'eżempji hija disponibbli fuq il-websajt fuq
Huwa possibbli li taħdem mal-gruppi ta 'metodi li ġejjin:
- Klijenti (lista ġenerali, selezzjonijiet separati, editjar, tħassir)
- Tikketti u proprjetajiet addizzjonali tal-klijenti
- Feed tal-klijenti (wiri, editjar, tħassir ta' entrati fil-feeds tal-klijenti)
- Impjegati tal-klijent (billi l-klijent huwa normalment entità legali, jista 'jkollu pjuttost ftit impjegati)
- Kompiti (il-funzjonalità kollha biex taħdem mal-kompiti)
- Iwassal (b'mod simili, il-funzjonijiet kollha)
- Utenti tas-CRM (li juru lista ta' utenti, id-drittijiet, is-settings, il-kuntatti u l-ħinijiet tax-xogħol tagħhom)
- Sejħiet (jirritorna lista ta' sejħiet)
Peress li tintuża l-istruttura eżistenti tal-API Zadarma, il-libreriji f'PHP, C#, Python huma diġà disponibbli għaliha fuq Github.
Eżempju ta' Użu tal-API
L-aktar eżempju sempliċi iżda l-aktar utli huwa l-ħolqien ta 'ċomb minn formola. Biex il-kodiċi jinżamm minimu, dan l-eżempju fih biss id-dejta bażika taċ-ċomb. Eżempju simili, iżda b'kummenti mill-klijent (normalment preżenti f'kull forma) huwa disponibbli
Eżempju ta' formola html għall-ħolqien ta' ċomb:
<form method="POST" action="/mt/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>
Din il-formola hija estremament sempliċi sabiex ma titgħabx żżejjed l-artikolu. M'għandha l-ebda disinn, l-ebda captcha, l-ebda qasam tal-kummenti. Verżjoni b'qasam tal-kumment hija disponibbli fuq il-blog tagħna (il-kumment huwa miżjud mal-għalf tal-klijent wara li jinħoloq iċ-ċomb).
U fil-fatt eżempju PHP għall-ħolqien ta 'ċomb b'dejta mill-formola:
<?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
)
);
}
Kif tistgħu taraw, ix-xogħol ma 'l-API huwa pjuttost sempliċi, flimkien ma' hemm eżempji ta 'ħidma fuq
ZCRM qed jevolvi kontinwament u kważi l-karatteristiċi ġodda kollha se jkunu disponibbli permezz tal-API.
Nistednuk ukoll biex tintegra s-sistemi tas-sistema eżistenti tiegħek b'CRM u PBX Zadarma b'xejn.
Sors: www.habr.com