不到一年前，我們推出了與免費 PBX 集成的免費 CRM 系統。 在此期間，已有 14 家公司和 000 名員工使用過它。
現在我們提供了一個開放的API接口，ZCRM的大部分功能都可以在這個接口上使用。 API 允許您將 CRM 用於任何銷售渠道。
下面我們簡要描述了 API 的工作和可用的功能。 還提供了一個簡單但有用且有效的示例：用於從站點上的表單創建銷售線索的腳本。
簡要介紹免費 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 用戶（顯示用戶列表、他們的權限、設置、聯繫人和工作時間）
- 通話（返回通話列表）
由於使用了現有的 Zadarma API 結構，因此在 Github 上已經可以使用 PHP、C#、Python 中的庫。
API 使用範例
最簡單但最有用的示例是從表單創建銷售線索。 為了將代碼保持在最低限度，此示例僅包含基本的潛在客戶數據。 一個類似的例子，但有來自客戶的評論（通常以各種形式出現）是可用的 在線的。 腳本示例寫在 PHP 沒有框架，因此很容易嵌入。
用於創建銷售線索的 html 表單示例：
<form method="POST" action="/zh-TW/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 非常簡單，另外還有一些工作示例 , , . 因此，沒有任何問題，您可以將簡單的免費 CRM 安裝到任何工作流程中，只需很少的血液即可實現自動化。
ZCRM 不斷發展，幾乎所有新功能都將通過 API 提供。
我們還邀請您將現有系統與免費的 CRM 和 PBX Zadarma 集成。
來源： www.habr.com