企业微信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()????????????}????????}????}}

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

相关文章