# 小程序说明
# 小程序内容获取,及发送流程
如果出现小程序无法打开,或者在某个系统上无法正常显示的情况,需要通过微信搜索小程序的方式来获取小程序标准版本,再进行转发
- 监听接收客户私聊消息 - 40023
- 给机器人转发小程序消息
- 获取回调消息内容的msg_content字段(小程序消息数据base64字符串)
- base64解码后得到小程序json数据
- json字段可替换,小程序解析是企微官方的逻辑,接口无法保证字段替换之后可以正常展示,需使用者自行测试
- 将json数据进行base64编码后填写在
msg_content字段,然后进行消息发送(发送群聊消息,发送私聊消息) - 以下为小程序json数据部分参数说明:① appName:小程序名称 ② appid:小程序的appid ③ pagepath:页面路径 ④ username:小程序原始id ⑤ weappIconUrl:小程序头像图标地址
# 关于小程序内容替换
小程序解析是企微官方的逻辑,接口无法保证字段替换之后可以正常展示,需使用者自行测试
- 不同企微版本(企微,微信,移动端,pc端)发出的小程序格式不同,替换字段可能出现部分版本无法展示的问题
- 小程序封面内容通过
"file":{...}结构解析,字段中的内容保留即可无需替换,如需自定义封面可在发送消息的接口通过传参数href进行替换封面 - 以下字段理论上替换之后小程序可正常显示(不排除替换后无法显示的情况)
注意,不同版本支持替换的字段有所不同,未列出字段不支持替换 因实现机制的原因,后台存在多个版本 版本1,版本支持下述字段(当前企业使用的版本,请与运营沟通获取)
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| appid | string | 小程序appid | |
| desc | string | 小程序顶部小图标旁边的描述 | |
| file | object | 封面图相关 | 保留原始内容即可 |
| pagepath | string | 小程序跳转链接 | 链接可拼接路径参数 |
| title | string | 小程序标题 | |
| weappIconUrl | string | 小程序顶部小图标 |
版本2,版本3,支持下述字段(当前企业使用的版本,请与运营沟通获取)
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| username | string | 小程序原始id | 必填,否则无法正常打开小程序 |
| appid | string | 小程序appid | |
| appName | string | 小程序顶部小图标旁边的描述 | |
| pagepath | string | 小程序跳转链接 | 链接可拼接路径参数 |
| title | string | 小程序分享标题 | |
| desc | string | 小程序顶部名称 | |
| weappIconUrl | string | 小程序顶部小图标 | |
| href | string | 小程序封面图片URL | 取值字段为上层msg_list里面消息的href,并非msg_content里面的 |
# 参考示例
该示例仅供参考

{
"username": "gh_f9d9fca26a50@app",
"appid": "",
"pagepath": "pages/tabBar/index/index.html?sampshare=%7B%22i%22%3A%2210A64ACBD53245E4BEDBDE766EF430AD%22%2C%22p%22%3A%22pages%2FtabBar%2Findex%2Findex%22%2C%22d%22%3A0%2C%22m%22%3A%22%E8%BD%AC%E5%8F%91%E6%B6%88%E6%81%AF%E5%8D%A1%E7%89%87%22%7D",
"weappIconUrl": "http://mmbiz.qpic.cn/mmbiz_png/CZGnVGInyCTf8yJuKOlHqKvqtFzOKeibXCBUdibDmPXS0pnCGib8J5QXoU2RbCXXVjj8DRs15Z7AfRKHlEdF27Zuw/640?wx_fmt=png&wxfrom=200",
"title": "寄快递,用顺丰",
"desc": "顺丰速运+",
"appName": "顺丰速运+"
}