企业微信API:Node.js实现企业微信成员个性化欢迎语
Roy
• 发表于:2021-07-31 20:05:44 • 更新于:2021-07-31 20:05:44
491

目标:

在企业微信上只能设置统一的新客户欢迎语,因此我们通过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、创建“新客户欢迎语”数据表以存储成员的欢迎语数据。创建欢迎语

2、创建上传临时素材的云函数。

配置API参数:配置参数

代码:

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、创建新建欢迎语功能(根据需求自行构建),并调用“上传临时素材”云函数:构建上传素材

4、创建发送新客户欢迎语云函数,并创建一个功能调用它。

配置:创建云函数

代码:

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

            }

        )

    }

}

功能:配置功能

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()

            }

        }

    }

}


本文是否对您有帮助?
有帮助
没帮助
您是否遇到了以下问题?
内容过期或不准确
缺少场景、事例
链接有误
太简单,步骤待完善
其他
提交反馈
如需获取即时帮助,请联系
小助理
微信扫码添加小助理
让你的想法快速变成软件吧~
文章标签
API
联系我们
售前咨询电话
020-88520693
意见箱 · 建议反馈
您的宝贵建议,使白码更完美!
白码小助理
加入白码社区,学习更多开发小技巧!
微信扫码添加白码小助理