# 微信小程序短链在企微全流程测试中的应用
版本 | 日期 | 更改人 | 描述 |
---|---|---|---|
1.0.0 | 2021-06-18 | 初始版本 |
[TOC]
# 背景
在企业微信应用中,有些场景只能使用线上版本的小程序。比如:
- 企微成员添加客户之后,自动给客户发送小程序欢迎语。发送新客户欢迎语 (opens new window)
- 在H5页面中给客户发送小程序消息。群发消息给客户 (opens new window)
如果小程序还在开发测试阶段,是必须提交审核,发布到线上之后,才能结合企业微信做全流程测试的。这样会隐藏一定的风险。那么在以上场景,能否发送开发版小程序给客户呢?
# 解决方案
注意:这个逻辑应该只存在于开发环境或测试环境,生成环境应走正常的小程序消息发送流程
# 1、小程序给微信号aslintest
添加“开发者”权限
# 2、企微在发送小程序消息前,调用接口获取小程序页面短链
接口协议说明:
请求地址:https://service-4v9rm9d8-1253233020.gz.apigw.tencentcs.com/release/api/getLink
请求参数:
字段 | 类型 | 必选 | 含义 | 备注 |
---|---|---|---|---|
appId | String | 1 | 小程序appId | |
page | String | 1 | 待发送小程序页面路径 | 注意页面地址需要携带.html |
title | String | 1 | 页面地址 |
样例
{
"appId": "wx35ff066c36faba8b",
"page": "pages/index/index.html?qusId=30&sendNumber=2021616212240&sendUserid=WangMengJie-200&toUserid=wmtw8EEQAA9vjZXA2d5_w19sq3SuW2eQ",
"title": "问卷调查"
}
1
2
3
4
5
2
3
4
5
请求响应:
字段说明
注:只说明data
部分
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
link | String | 小程序短链 |
样例
{
"code": 0,
"msg": "success",
"data": {
"link": "#小程序://问卷助手Lite/问卷调查/S33MnqkHVeE8agk"
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
注: 如果接口返回的link
字段为空,需要联系@王梦杰刷新小程序开发者账号token
# 3、以纯文本消息的类型发送给客户
# 4、客户在点击短链之前,先在小程序助手
中打开某个开发版本
如果不点击,有可能出现“开发版小程序已过期,请在开发者工具重新扫码”的提示。
# 5、客户点击短链,打开目标小程序页面
# 最佳实践
在整个流程中,需要注意的是,客户在点击短链之前,需要先到“小程序助手”中打开一下对应的开发版,然后才能点击短链。那么在开发测试过程中,我们就可以自由选择特定的小程序版本。举例来说:
1、我们提测的版本包含特性feature1,同时在开发feature2
2、我们可以将feature1合并到git的qa分支
3、参考用 Jenkins +miniprogram-ci 自动构建微信小程序 (opens new window),在qa分支执行小程序预览命令,生成测试版
4、测试人员在测试过程中,先点击对应的qa版本,再点击短链进入待测页面。开发测试互不打扰