如何利用开放平台把金数据采集的表单数据生成纷享销客销售线索？

适用场景： 公司在微信公众号里发起了一个营销活动，用金数据做活动报名的表单，每一个报名的粉丝，可能都是一个潜在的客户。正常情况下，只有金数据的账号管理员能看到数据，要么导出Excel文件，这时候如果能把金数据采集到的数据实时同步到纷享销客，生成一条销售线索，由后续的销售人员继续跟进，就能大大提高效率，进而提高客户体验和转化率。

关于金数据

在零点工作的时候，线上调研的项目使用的是EnableQ系统，可以通过配置生成逻辑特别复杂的表单，以至于我在刚接触金数据的时候，觉得这是一个很鸡肋的产品，只有基础的字段类型。后来尝试过麦客、问卷星、调查派……但最后还是用回了金数据，因为它足够简单，已有的功能也保证了良好的用户体验，真正让我发生改观的是，我发现很多大公司都在金数据，甚至很多互联网大公司，纷享销客在用、知乎在用、印象笔记在用……我就想对这些互联网大厂的工程师来说，他们写个表单系统，应该不是什么大事，为什么要用金数据这样的平台呢，后来我想明白了，很可能是他们去做一个这样的产品，也最多就能做到这种程度，而金数据能满足大部分的要求，还能改成自己的域名，去掉平台logo，还有很强大的微信增强包，UI也很漂亮！对用户来说，很可能都感觉不出来是第三方平台，所以完全没必要自己重复造轮子，关键费用还足够低。

如何使用金数据开放平台？

金数据的开放平台非常简单，只有三个接口：1.数据推送Api 2.表单Api 3.数据Api
而最常用的就一个接口：数据推送Api， 开启数据推送API的表单收到新数据时，金数据会将该数据通过HTTP POST推送到指定的URL。就因为这一个接口，金数据就超越了大多数平台，而且这个接口是事件推送机制的，不用主动调用，比用定时任务请求数据节省资源，美中不足是只有专业版以上用户可以用，免费用户无法使用，对企业来说，这点费用还是完全能接受的。
API访问规则：
所有的数据格式为JSON
所有的数据传输编码为UTF-8
目前，API访问的地址来源为
个人版： 金数据 - 找不到页面
企业版： https://YOUR_DOMAIN.jinshuju.com/api/v1/
除了数据推送API外，所有的API都需要恰当的API访问权限。目前我们仅支持HTTP Basic Auth验证的方式。
开启数据推送：
您可以在表单的设置 ——数据推送 页面找到将数据以JSON格式发送给第三方，勾选开启后点击「字段对照表与JSON样例」展开，您将看到当前表单的字段对照表。
重连机制：
在金数据尝试向填写的地址发送 post 请求时，金属要求用户的服务器于2秒内返回2XX（如200）作为应答。如果没有得到正确的回应 ，我们会尝试重新推送消息。如果连续重试6次均失败，该表单的数据推送过程将停止。 表单创建者将获得邮件通知。开发者需要在表单设置 ——数据推送 页面找到将数据以JSON格式发送给第三方 重新手动保存设置，只有成功，数据推送才会继续。

推送示例：

```php
POST http://url.com/jinshuju/callback 
Content-Type: application/json 
X-Requested-By: jinshuju 

{ 
    "form": "xJfeTv", 
    "entry": { 
        "field1": 123, 
        "field2": "Hello, World", 
        "field3": "It's very good." 
    } 
} 

服务器接受数据源代码：

// 接受金数据POST数据 
Public function getjinshuju() { 
    $fields=array( 
        array("education","field_9"), 
        array("soldier","field_10"), 
        array("marit`在这里插入代码片`alstatus","field_11"), 
        array("politicsstatus","field_12"), 
        array("forcompany","field_13"), 
        array("forcompanytel","field_14"), 
        array("industry","field_15"), 
        array("precinct","field_16"), 
        array("comecompany","field_17"), 
        array("comecompanytel","field_18"), 
        array("emergencycontact","field_19"), 
        array("emergencycontacttel","field_20") 
    ); 
    $request = $this->request; 
    $data=$request->param(); 
    $entry=$data["entry"]; 
    $newdata=array(); 
    for($i=0;$i<count($fields);$i++){ 
        if(!empty($entry[$fields[$i][1]])){ 
            $newdata[$fields[$i][0]]=$entry[$fields[$i][1]]; 
        } 
    } 
    $newdata["city"]=$entry["field_21"]["city"]; 
    $newdata["address"]=$entry["field_21"]["province"].$entry["field_21"]["city"].$entry["field_21"]["district"].$entry["field_21"]["street"]; 
    $openid = $entry["x_field_weixin_openid"]; 
    $result=Db::name('member')->where('openid', $openid)->update($newdata); 
    return 200; 
} 

$fields是把数据库字段和表单字段建立里的映射数组，当然也可以写入到数据库里，要想把数据直接同步到纷享销客，就需要把字段映射成纷享销客对象对应的字段，主要用到纷享销客开放平台的CRM对象接口-预设对象-新增对象数据，详见：https://open.fxiaoke.com/wiki.html#artiId=15

关于纷享销客开放平台的具体使用步骤，详见我发布的另一篇文章：
纸枫林：基于纷享销客开放平台，实现纷享CRM与金蝶云星空系统数据同步
​

Email：wangzhifeng@tongdog.com.cn