不到一年前，我们推出了与免费 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-CN/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 集成。
来源： habr.com