实现环境:
白码低代码平台(该平台提供企业微信API,可直接调用,减少前期配置调试工作)
平台语言:
使用node.js开发
准备工作:
准备一个企业微信管理员账号
- 企业微信官方API:https://work.weixin.qq.com/api/doc/90000/90135/90237
- 白码使用的API库:https://github.com/liwenyue/co-wxwork-api
实现步骤:
1、选择企业微信回调接口模板创建webhook,并将webhook路径复制。
2、打开企业微信后台,在自建应用详情页,点击“接收消息”的“设置API接收”按钮,进入配置页面。将复制的webhook路径复粘贴到url中,按要求填写Token(可由企业任意填写,用于生成签名。)及EncodingAESKey(用于消息体的加密,是AES密钥的Base64编码。),加密说明:https://work.weixin.qq.com/api/doc/90000/90135/90238
3、在客户联系的“客户>api>接收事件服务器”中设置相同内容(三个参数保持一致)。
4、在白码平台配置webhook的参数:corpid(我的企业->企业id)、corpsecret(自建应用secret)、token、aesKey(即EncodingAESKey)
5、回调代码
async function hook($req, $resp, $modules = modules) {
//get 请求用于验证有效性
if ($req.method == "GET") {
/**
* 企业收到消息后,需要作如下处理:
* 1、对msg_signature进行校验
* 2、解密Encrypt,得到明文的消息结构体(消息结构体后面章节会详说)
* 3、如果需要被动回复消息,构造被动响应包
* 4、正确响应本次请求
* 以上1~2步骤可以直接使用解密函数一步到位。
* 3步骤其实包含加密被动回复消息、生成新签名、构造被动响应包三个步骤,可以直接使用加密函数一步到位。
*/
$resp.body = await modules.wxworkApi.getVerifyMsg($req);//处理已封装,可直接调用
} else if ($req.method == "POST") {
//无法保证在五秒内处理完成,先回复(企业微信服务器在五秒内收不到响应会断掉连接)
$resp.body = "success";
//处理
let handle = async () => {
//将数据转换成json
let data = await modules.wxworkApi.getMsgData($req);
if (data.Event == "change_contact" && data.ChangeType == "create_party") { /**添加部门 */
//TODO 处理添加部门事件
} else if (data.Event == "change_contact" && data.ChangeType == "update_party") {/**修改部门 */
//TODO 处理修改部门事件
} else if (data.Event == "change_contact" && data.ChangeType == "delete_party") { /**删除部门 */
//TODO 处理删除部门事件
} else if (data.Event == "change_contact" && data.ChangeType == "create_user") { /**添加成员 */
//TODO 处理添加成员事件
} else if (data.Event == "change_contact" && data.ChangeType == "update_user") {/**修改成员 */
//TODO 处理修改成员事件
} else if (data.Event == "change_contact" && data.ChangeType == "delete_user") { /**删除成员 */
//TODO 处理删除成员事件
} else if (data.Event == "change_external_contact" && data.ChangeType == "add_external_contact") {/**添加客户事件*/
//TODO 处理添加外部联系人事件
} else if (data.Event == "change_external_contact" && data.ChangeType == "edit_external_contact") {/**编辑客户事件(标签等信息) */
//TODO 处理编辑外部联系人备注标签信息事件
} else if (data.Event == "change_external_contact" && data.ChangeType == "del_external_contact") { /**删除客户事件*/
//TODO 处理删除外部联系人事件
}
handle()
}
}
来源:oschina
链接:https://my.oschina.net/u/4287236/blog/4546877