低代码开发平台通过钉钉API实现流程管理数据对接

实例背景：

CRM项目虽然实现了报价转订单的功能，但是客户还是遇到使用不方便的问题，客户的业务流程中，审核报价的时候是需要提供销售人员与客户的聊天记录截图，这都是在手机上的，电脑操作不方便，而且每次提交了报价还要在微信上跟主管说一声，于是他们就在钉钉上使用报价审批功能，希望可以将钉钉的数据对接到系统内。

流程步骤：

销售人员使用钉钉进行报价的审批，审批通过的报价会对接到系统并生成一个销售单和对应的应收。要实现这个功能，需使用了白码平台提供的API功能，白码提供了对接各大平台封装好的api，包括有钉钉、微信服务号、企业微信、微信支付。

开发步骤：

1、使用白码低代码平台

地址：https://www.bnocode.com

如何通过<a class= 钉钉API实现流程管理数据对接" height="937" src="https://img-blog.csdnimg.cn/img_convert/1bfa0bfd93d5c213583a4f481633060a.png" width="1200" />

对接流程：

1. 因为是由钉钉的流程触发系统的接口，所以需要设置一个回调接口（webhook），根据钉钉官方的开发文档，需要先注册回调，注册回调就需要用平台的云函数和webhook了。根据平台提供的扩展库，写出如下注册回调的云函数和webhook，直接在平台上测试就能注册回调了。

如何通过<a class= 钉钉API实现流程管理数据对接" height="937" src="https://img-blog.csdnimg.cn/img_convert/ee3baf531e41241fe3b6a9a4a1ad43ba.png" width="1200" />

async function run($input,$output,$modules = modules){let dingTalkApi = $modules.dingTalkApi;let registerCallBack = await dingTalkApi.registerCallBack({call_back_tag:["bpms_instance_change"],//审批状态变更回调token:"",aes_key:"",url:""});$output.res = registerCallBack;}

如何通过<a class= 钉钉API实现流程管理数据对接" height="937" src="https://img-blog.csdnimg.cn/img_convert/1d6b9fa8ed9216f694903201ff41d89e.png" width="1200" />

async function hook($req,$resp,$modules = modules){let dingTalkApi = $modules.dingTalkApi;let helper = $modules.helper;let data = null;//收到的数据//用于验证钉钉回调let token = await helper.getConfig("token")let aesKey = await helper.getConfig("aesKey")let corpid = await helper.getConfig("corpid");let {timestamp,nonce} = $req.query;let result = dingTalkApi.instanceCrypto({token,encodingAESKey:aesKey,CorpId:corpid,timestamp,nonce});$resp.body = result;//加密信息let encrypt = $req.body.encrypt;if(encrypt){let msg = await dingTalkApi.msgCrypt.decrypt(encrypt);if(msg.message){data = JSON.parse(msg.message);}}}

如何通过<a class= 钉钉API实现流程管理数据对接" height="937" src="https://img-blog.csdnimg.cn/img_convert/b1f45ebea33c80e317b8b9bbf15367e0.png" width="1200" />

2. 注册好回调后，就需要调整webhook的代码逻辑了，因为之后钉钉的审批实例状态有变更时都会执行webhook的代码。

如何通过<a class= 钉钉API实现流程管理数据对接" height="937" src="https://img-blog.csdnimg.cn/img_convert/e69b988bfc25afa0085f9e796d1919d7.png" width="1200" />

async function hook($req,$resp,$modules = modules){let dingTalkApi = $modules.dingTalkApi;let helper = $modules.helper;let data = null;//收到的数据//用于验证钉钉回调let token = await helper.getConfig("token")let aesKey = await helper.getConfig("aesKey")let corpid = await helper.getConfig("corpid");let {timestamp,nonce} = $req.query;let result = dingTalkApi.instanceCrypto({token,encodingAESKey:aesKey,CorpId:corpid,timestamp,nonce});$resp.body = result;//加密信息let encrypt = $req.body.encrypt;if(encrypt){let msg = await dingTalkApi.msgCrypt.decrypt(encrypt);if(msg.message){data = JSON.parse(msg.message);}}let processCode = data.processCode;if(processCode == "PROC-C0640453-0814-4D29-9A11-B6DF548C57ED"){let processInstanceId = data.processInstanceId;//审批实例idlet result = data.result;let type = data.type;if(result == "agree" && type == "finish"){//调用功能，生成订单和应收await $modules.program.exec("5f471de7d67c5c69ae4f5b6c",{"5eb9416bb75b4176eca49a17":{"5f471caa00d5f969b43eefb1":processInstanceId}});}}}

3. 当客户在钉钉上审批皮通过了一个报价后，就会触发这个webhook，webhook再调用功能来生成一个订单和应收，这个功能里也包含了调用API的步骤，根据审批实例id获取审批实例的详情，里面就包含了报价的信息，获取到报价信息就可以录入到系统中了。

如何通过<a class= 钉钉API实现流程管理数据对接" height="937" src="https://img-blog.csdnimg.cn/img_convert/b4b5d72c9a6c74260f1faa0c884c7d8b.png" width="1200" />

测试结果：

如何通过<a class= 钉钉API实现流程管理数据对接" height="1200" src="https://img-blog.csdnimg.cn/img_convert/8e46f8c90cbc8190f43f9d4faf366757.png" width="1077" />

如何通过<a class= 钉钉API实现流程管理数据对接" height="937" src="https://img-blog.csdnimg.cn/img_convert/ea70f3c6d9530a2324114addaa390c6d.png" width="1200" />

整个流程下来，结合了钉钉的流程管理和白码的数据处理功能，提高了整个销售团队的销售效率。