# 小程序说明
# 小程序内容获取,及发送流程
如果出现小程序无法打开,或者在某个系统上无法正常显示的情况,需要通过微信搜索小程序的方式来获取小程序标准版本,再进行转发
- 监听接收客户私聊消息 - 40023
- 给机器人转发小程序消息
- 获取回调消息内容的msg_content字段(小程序消息数据base64字符串)
- base64解码后得到小程序json数据
- json字段可替换,小程序解析是企微官方的逻辑,接口无法保证字段替换之后可以正常展示,需使用者自行测试
- 将json数据进行base64编码后填写在
msg_content
字段,然后进行消息发送(发送群聊消息,发送私聊消息) - 以下为小程序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" // 小程序头像图标地址
}