Clever Geek Handbook

免费CRM的API





不到一年前，我们推出了与免费PBX集成的免费CRM系统。在此期间，有14,000家公司和64,000名员工使用了它。

当前，我们提供了一个开放的API，其中大多数ZCRM功能都可用。该API允许您将CRM用于任何销售渠道。

下面我们将简要描述API的工作和可用功能。还有一个简单但有用且有效的示例：一个脚本，用于从网站上的表单创建销售线索。



简要介绍免费CRM



让我们不要解释什么是CRM。免费的CRM Zadarma支持存储客户数据的所有标准功能。该信息保存在客户的提要中。另外，除了有关客户的信息外，还提供了一个方便的任务管理器，其中显示了每种口味（日历，看板，清单）。所有这些功能都可供50多名员工使用，并且已与电话（包括使用WebRTC技术的浏览器发出的电话）完全集成。



免费是什么意思？无需支付任何关税或ZCRM服务。您唯一需要付费的就是电话和电话号码（例如特惠价格，莫斯科号码的月租费是95卢布，伦敦的月租费是1欧元）。如果几乎没有电话？您几乎不需要付款。

免费的CRM处于活动状态，而免费的PBX Zadarma处于活动状态。注册后，PBX有效期为2周，将来有必要在3个月内向帐户充值1次。很难想象需要CRM和PBX的办公室，但根本不需要电话号码或电话。



为什么需要免费CRM的API



ZCRM的发展不会一minute而就，有很多大大小小的功能。但是我们知道，要提供一个真正的功能系统，而不仅仅是一个智能通讯录，还不足以与电话集成。

与客户的联系越多，联系就越好。借助API，您可以自动输入（或相反，接收）有关客户/潜在客户和任务的信息，而不会出现任何问题。因此，可以与客户和任何其他自动化系统连接任何通讯渠道。

借助API，免费的ZCRM可以全部或部分使用。例如，作为与公司客户群合作的便捷界面，或作为简单便捷的计划者。

以下是这种渠道的示例-连接到网站上潜在客户表单的CRM。在该站点的后面，我们将提供其他示例，例如，创建一个回调客户端的任务（延迟调用）。



ZCRM API基本方法



由于ZCRM API中提供了37种方法，因此我们将避免描述所有方法，而仅通过示例描述它们的主要组。

有关示例的完整列表，可在网站上的CRM API说明中找到。



您可以使用以下方法组：

  • 客户端（常规列表，单独选择，编辑，删除）
  • 客户端标签和其他属性
  • 客户提要（查看，编辑，删除客户提要中的记录）
  • 客户的员工（由于客户通常是法人实体，因此他可能有很多员工）
  • 任务（用于处理任务的所有功能）
  • 导线（类似于所有功能）
  • RM用户（显示用户列表，他们的权限，设置，联系方式和工作时间）
  • 通话（返回通话清单）




由于使用了现有的Zadarma API结构，因此在Github上已经可以使用PHP，C＃和Python使用该库了。



API用法示例



最简单但最有用的示例是从表单创建销售线索。为了尽量减少代码，此示例仅包含基本线索数据。一个类似的示例，但是已经带有来自客户端的注释（通常以每种形式出现），可以在该站点的博客上找到。脚本示例是使用PHP编写的，没有框架，因此易于嵌入。

用于创建销售线索的html表单示例： 



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




这种形式非常简单，以免使文章超载。它没有设计，没有验证码，没有评论字段。我们的博客上提供了带有注释字段的版本（创建潜在客户后，注释会添加到客户的Feed中）。



以及使用表单数据创建销售线索的实际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＃和Python的示例。因此，您可以毫无问题地将简单的免费CRM安装到任何工作流程中，并且“几乎没有血腥”地获得了自动化。

ZCRM不断发展，几乎所有新功能都将可用，包括通过API。

我们还邀请您将现有的系统系统与免费的CRM和PBX Zadarma集成。


More articles:


All Articles