ממשק API של CRM בחינם

לפני פחות משנה, הצגנו מערכת CRM חינמית משולבת במרכזיה חינמית. במהלך תקופה זו, 14 חברות ו-000 עובדים השתמשו בו.
כעת אנו מציעים ממשק API פתוח, בו זמינות רוב הפונקציות של ZCRM. ה-API מאפשר לך להשתמש ב-CRM עבור כל ערוצי מכירה.
להלן אנו מתארים בקצרה את העבודה עם ה-API ואת הפונקציונליות הזמינה. ניתנת גם דוגמה פשוטה אך שימושית ועובדת: סקריפט ליצירת ליד מטופס באתר.

בקצרה על CRM בחינם

בואו נמנע מלסביר מה זה CRM. CRM חינם Zadarma תומך בכל פונקציות אחסון נתוני לקוחות סטנדרטיות. המידע נשמר בפיד של הלקוח. כמו כן, בנוסף למידע על לקוחות, זמין מנהל משימות נוח עם תצוגה לכל טעם (לוח שנה, קנבן, רשימה). כל זה זמין עבור 50+ עובדים ומשולב במלואו עם טלפוניה (כולל שיחות מדפדפן בטכנולוגיית WebRTC).

מה זאת אומרת חינם? אין תעריפי ZCRM או שירותים שאתה צריך לשלם עבורם. הדבר היחיד שאתה צריך לשלם עליו הוא שיחות טלפון ומספרים (לפי תעריפים מיוחדים, למשל, תשלום חודשי עבור מספר במוסקבה הוא 95 רובל או לונדון הוא 1 אירו). ואם אין כמעט שיחות? אתה כמעט לא צריך לשלם.
CRM בחינם פעיל בעוד שהמרכזייה החינמית Zadarma פעילה. לאחר ההרשמה, המרכזיה פעילה למשך שבועיים, בעתיד יש צורך לחדש את החשבון עבור כל סכום פעם אחת ב-2 חודשים. קשה לדמיין משרד שזקוק ל-CRM ומרכזיה, אבל אין צורך במספר או שיחות כלל.

למה אתה צריך API עבור CRM בחינם

הפיתוח של ZCRM לא עוצר לדקה, הרבה פונקציות גדולות וקטנות הופיעו. אבל אנחנו מבינים שכדי להציג מערכת פונקציונלית באמת, ולא רק מחברת חכמה, אינטגרציה של טלפוניה אינה מספיקה.
ככל שיותר קשרים עם הלקוח, כך ייטב, ואנשי הקשר יכולים להיות שונים מאוד. הודות ל-API תוכלו להזין באופן אוטומטי (או להיפך, לקבל) מידע על הלקוח / ליד ומשימות ללא בעיות. הודות לכך, ניתן לחבר כל ערוצי תקשורת עם הלקוחות וכל מערכות אוטומציה אחרות.
הודות ל-API, ניתן להשתמש ב-ZCRM החינמי בכל דרך, כולה או חלקית. למשל, כממשק נוח לעבודה מול קהל לקוחות ארגוני, או כמתזמן פשוט ונוח.
להלן דוגמה לערוץ כזה - התחברות לטפסי לידים CRM באתר. בהמשך האתר נביא דוגמאות נוספות, למשל יצירת משימה להתקשרות חזרה ללקוח (שיחה דחויה).

שיטות ZCRM API בסיסיות

מכיוון שקיימות 37 שיטות זמינות ב-ZCRM API, נמנע מלתאר את כולן, נתאר רק את הקבוצות העיקריות שלהן עם דוגמאות.
רשימה מלאה עם דוגמאות זמינה באתר בכתובת תיאור ה-CRM API.

ניתן לעבוד עם קבוצות השיטות הבאות:

• לקוחות (רשימה כללית, בחירות נפרדות, עריכה, מחיקה)
• תגים ומאפיינים נוספים של לקוחות
• עדכון לקוחות (צפייה, עריכה, מחיקת ערכים בעדכוני לקוחות)
• עובדים של הלקוח (מאחר שהלקוח הוא בדרך כלל ישות משפטית, ייתכן שיהיו לו לא מעט עובדים)
• משימות (כל הפונקציונליות לעבודה עם משימות)
• לידים (באופן דומה, כל הפונקציות)
• משתמשי CRM (הצגת רשימה של משתמשים, זכויותיהם, הגדרות, אנשי קשר ושעות העבודה שלהם)
• שיחות (מחזיר רשימה של שיחות)

מכיוון שמשתמשים במבנה ה-API הקיים של Zadarma, ספריות ב-PHP, C#, Python כבר זמינות עבורו ב-Github.

דוגמה לשימוש ב-API

הדוגמה הפשוטה אך השימושית ביותר היא יצירת ליד מטופס. כדי לצמצם את הקוד למינימום, דוגמה זו מכילה רק את נתוני הפניות הבסיסיים. דוגמה דומה, אך עם הערות מהלקוח (בדרך כלל נוכחות בכל צורה) זמינה בבלוג באינטרנט. דוגמאות לתסריט כתובות ב PHP ללא מסגרות ולכן מוטמע בקלות.
דוגמה לטופס HTML ליצירת ליד:

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

טופס זה פשוט ביותר כדי לא להעמיס על המאמר. אין לו עיצוב, אין captcha, אין שדה הערות. גרסה עם שדה הערה זמינה בבלוג שלנו (התגובה מתווספת לפיד של הלקוח לאחר יצירת הליד).

ולמעשה דוגמה 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#, פיתון. כך, ללא כל בעיה, אתה יכול להתאים CRM פשוט בחינם לכל זרימת עבודה, לאחר שקיבלת אוטומציה עם מעט דם.
ZCRM מתפתח כל הזמן וכמעט כל התכונות החדשות יהיו זמינות דרך ה-API.
אנו מזמינים אותך גם לשלב את מערכות המערכת הקיימות שלך עם CRM ומרכזייה חינמית Zadarma.

מקור: www.habr.com