企业微信API:成员个性化新客户欢迎语的nodejs实现

目标:

在企业微信上只能设置统一的新客户欢迎语,因此我们通过API来实现为对每个成员设置个性化欢迎语。

实现环境:

白码低代码平台(该平台是低代码代发平台,提供企业微信API,可直接调用,减少前期配置调试工作)

平台语言:

使用node.js开发

准备工作:

  1. 准备一个企业微信管理员账号
  2. 获取成员信息(主要是userid,可参考:Node.JS调用企业微信API:成员的增删查改

请结合以下内容阅读:

  1. 企业微信上传临时素材API:https://work.weixin.qq.com/api/doc/90000/90135/90253
  2. 企业微信发送新客户欢迎语API:https://work.weixin.qq.com/api/doc/90000/90135/92137
  3. 企业微信添加客户回调事件:https://work.weixin.qq.com/api/doc/90000/90135/92130
  4. 白码使用的企业微信API库:https://github.com/liwenyue/co-wxwork-api

实现步骤:

1、创建“新客户欢迎语”数据表以存储成员的欢迎语数据。
企业微信API:成员个性化新客户欢迎语的nodejs实现
2、创建上传临时素材的云函数。
配置API参数:
企业微信API:成员个性化新客户欢迎语的nodejs实现
代码:

async function run($input, $output, $modules = modules) {

    let image_url = $input.image_url;
let mediaName = new Date().getTime() + ".png";

    //上传临时素材
let media = await modules.wxworkApi.uploadMediaByUrl(image_url, "image", mediaName);

    //输出
    $output.media_id = media.media_id;
$output.created_at = media.created_at;

}

3、创建新建欢迎语功能(根据需求自行构建),并调用“上传临时素材”云函数:
企业微信API:成员个性化新客户欢迎语的nodejs实现
企业微信API:成员个性化新客户欢迎语的nodejs实现
企业微信API:成员个性化新客户欢迎语的nodejs实现
4、创建发送新客户欢迎语云函数,并创建一个功能调用它。
配置:
企业微信API:成员个性化新客户欢迎语的nodejs实现
代码:

async function run($input, $output, $modules = modules) {

    let commonWelcomeQuery = await modules.data.queryData("5f4647d829fa640a919d57ff", { "5f464815e233c00a9094345e": "通用" });
    if (commonWelcomeQuery.length > 0) {
        //初始化为通用欢迎语
        let welcome = commonWelcomeQuery[0];
        //根据userid查询成员的欢迎语
        let welcomeQuery = await modules.data.queryData("5f4647d829fa640a919d57ff", { "5f46482d29fa640a919d5801": $input.userid });
        welcome = welcomeQuery.length > 0 ? welcomeQuery[0] : welcome;

        let nowTime = new Date().getTime();
        //欢迎语初始化为发送文本内容
        let msgData = {
            welcome_code: $input.welcomeCode,
            text: {
                content: welcome["5f46483929fa640a919d5802"]
            }
        };
        let create_at = "";
        let isExpired = false;
        let media_id = "";
        switch (welcome["5f464af329fa640a919d5809"]) {//欢迎语类型
            case "图片":
                create_at = new Number(welcome["5f464de7e233c00a9094346e"] + "000");
                isExpired = (nowTime - create_at) > 3 * 24 * 60 * 60 * 1000;//素材超过3天失效
                media_id = welcome["5f464dc0e233c00a9094346d"];
                if (isExpired) {
                    //重新上传图片
                    let mediaName = new Date().getTime() + ".png";
                    let getMediaId = await modules.wxworkApi.uploadMediaByUrl(welcome["5f464dc0e233c00a9094346d"], "image", mediaName);
                    media_id = getMediaId.media_id;
                    //更新图片素材
                    let form = {
                        "5f464dc0e233c00a9094346d": getMediaId.media_id,
                        "5f464de7e233c00a9094346e": getMediaId.created_at
                    }
                    modules.data.updateData("5f4647d829fa640a919d57ff", welcome._id, form);
                }
                //文本+图片
                msgData = {
                    welcome_code: $input.welcomeCode,
                    text: {
                        content: welcome["5f46483929fa640a919d5802"]
                    },
                    image: {
                        media_id: media_id
                    }
                };
                break;
            case "图文":
                //文本+图文
                msgData = {
                    welcome_code: $input.welcomeCode,
                    text: {
                        content: welcome["5f46483929fa640a919d5802"]
                    },
                    link: {
                        title: welcome["5f46486329fa640a919d5804"],
                        picurl: welcome["5f46487029fa640a919d5805"],
                        desc: welcome["5f464878e233c00a90943460"],
                        url: welcome["5f464881e233c00a90943461"]
                    }
                };
                break;
            case "小程序":
                create_at = new Number(welcome["5f464e10e233c00a90943472"] + "000");
                isExpired = (nowTime - create_at) > 3 * 24 * 60 * 60 * 1000;//临时素材超过3天失效
                media_id = welcome["5f464e06e233c00a90943471"];
                if (isExpired) {
                    //重新上传封面
                    let mediaName = new Date().getTime() + ".png";
                    let getMediaId = await modules.wxworkApi.uploadMediaByUrl(welcome["5f4722b4e233c00a90943587"], "image", mediaName);
                    media_id = getMediaId.media_id;
                    //更新小程序封面素材
                    let form = {
                        "5f464e06e233c00a90943471": getMediaId.media_id,
                        "5f464e10e233c00a90943472": getMediaId.created_at
                    }
                    modules.data.updateData("5f4647d829fa640a919d57ff", welcome._id, form)
                }
                //文本+小程序
                msgData = {
                    welcome_code: $input.welcomeCode,
                    text: {
                        content: welcome["5f46483929fa640a919d5802"]
                    },
                    miniprogram: {
                        title: welcome["5f464891e233c00a90943462"],
                        pic_media_id: media_id,
                        appid: welcome["5f4648a4e233c00a90943463"],
                        page: welcome["5f4648afe233c00a90943464"]
                    }
                };
                break;
        }
        //发送欢迎语
        modules.wxworkApi.request(
            {
                method: 'post',
                url: 'externalcontact/send_welcome_msg',
                data: msgData
            }
        )
    }
}

功能:
企业微信API:成员个性化新客户欢迎语的nodejs实现
企业微信API:成员个性化新客户欢迎语的nodejs实现
5、设置回调事件,在成员添加外部联系人时发送欢迎语(回调事件的具体实现过程可参考:Node.JS调用企业微信API:自建应用的回调事件)
代码:

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_external_contact" && data.ChangeType == "add_external_contact") {/**添加客户事件*/
                //调用功能,发送欢迎语
                modules.program.exec(
                    "5f4735ef00d5f969b43ef012",//功能follow
                    {
                        "5f47360000d5f969b43ef014": {//输入参数步骤
                            "field_1598502473677": data.Userid,//userid
                            "field_1598502477417": data.WelcomeCode//welcome_code
                        }
                    }
                );
                handle()
            }
        }
    }
}

至此已实现成员个性化欢迎语的功能。

猜你喜欢

转载自blog.51cto.com/11283856/2528643