# 小程序说明

# 小程序内容获取,及发送流程

如果出现小程序无法打开,或者在某个系统上无法正常显示的情况,需要通过微信搜索小程序的方式来获取小程序标准版本,再进行转发

  1. 监听接收客户私聊消息 - 40023
  2. 给机器人转发小程序消息
  3. 获取回调消息内容的msg_content字段(小程序消息数据base64字符串)
  4. base64解码后得到小程序json数据
  5. json字段可替换,小程序解析是企微官方的逻辑,接口无法保证字段替换之后可以正常展示,需使用者自行测试
  6. 将json数据进行base64编码后填写在 msg_content 字段,然后进行消息发送(发送群聊消息发送私聊消息
  7. 以下为小程序json数据部分参数说明:① appName:小程序名称 ② appid:小程序的appid ③ pagepath:页面路径 ④ username:小程序原始id ⑤ weappIconUrl:小程序头像图标地址

# 关于小程序内容替换

小程序解析是企微官方的逻辑,接口无法保证字段替换之后可以正常展示,需使用者自行测试

  • 不同企微版本(企微,微信,移动端,pc端)发出的小程序格式不同,替换字段可能出现部分版本无法展示的问题
  • 小程序封面内容通过"file":{...}结构解析,可以使用其他小程序的封面整个进行替换;结构的内容是微信官方的加密信息,无法支持自定义图片作为小程序封面
  • 以下字段理论上替换之后小程序可正常显示(不排除替换后无法显示的情况)

注意,不同版本支持替换的字段有所不同,未列出字段不支持替换 因实现机制的原因,后台存在多个版本 版本1,版本支持下述字段(当前企业使用的版本,请与运营沟通获取)

字段 类型 说明 备注
appid string 小程序appid
desc string 小程序顶部小图标旁边的描述
file object 封面图相关 需要整个file替换
pagepath string 小程序跳转链接 链接可拼接路径参数
title string 小程序标题
weappiconurl string 小程序顶部小图标

版本2,版本3,支持下述字段(当前企业使用的版本,请与运营沟通获取)

字段 类型 说明 备注
appid string 小程序appid
appName string 小程序顶部小图标旁边的描述
pagepath string 小程序跳转链接 链接可拼接路径参数
title string 小程序标题
weappiconurl string 小程序顶部小图标
href string 小程序封面图片URL 取值字段为上层msg_list里面消息的href,并非msg_content里面的

# 参考示例

该示例结构不可直接使用,仅供参考

{
  "appid": "wx114b353c92670eeb",
  "des": "广州地铁乘车码", 
  "file": {
    "height": 336,
    "id": "306b020102046430620201000204adced1e302030f4df9020424e660710204608625750436323931363031323531355f313433373735363035335f3762656135376233393737303532623335626465626236653964306338613836020100020300fd6004000201010201000400",
    "key": "727A6B766A6266666A716C6765637966",
    "md5": "",
    "size": 59073,
    "type": 2,
    "width": 420
  },
  "pagepath": "pages/qrcode/index.html?arg1=123&arg2=456",
  "title": "刷码乘车,便捷出行",
  "type": 2,
  "username": "gh_60add25bcb6c@app", // 小程序原始id
  "version": 31,
  "weappiconurl": "http://mmbiz.qpic.cn/mmbiz_png/xdfiaK4icia2u1GvUPH0QwHrcoyYTMVbsGbvA8fBQib853DCqQUS2Y7l3u3NS2WR48GF87gb0cl5trnZogRrTxtRmA/640?wx_fmt=png&wxfrom=200" // 小程序头像图标地址
}
最后更新时间: 2025/2/26 11:03:18