白码低代码平台(该平台提供企业微信API,可直接调用,减少前期配置调试工作)
使用node.js开发
准备一个企业微信管理员账号
企业微信官方API:https://work.weixin.qq.com/api/doc/90000/90135/90237白码使用的API库:https://github.com/liwenyue/co-wxwork-api1、选择企业微信回调接口模板创建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() } }