# 微信小程序短链在企微全流程测试中的应用

版本 日期 更改人 描述
1.0.0 2021-06-18 初始版本

[TOC]

# 背景

在企业微信应用中,有些场景只能使用线上版本的小程序。比如:

如果小程序还在开发测试阶段,是必须提交审核,发布到线上之后,才能结合企业微信做全流程测试的。这样会隐藏一定的风险。那么在以上场景,能否发送开发版小程序给客户呢?

# 解决方案

注意:这个逻辑应该只存在于开发环境或测试环境,生成环境应走正常的小程序消息发送流程

# 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

请求响应

字段说明

注:只说明data部分

字段 类型 含义 备注
link String 小程序短链

样例

{
  "code": 0,
  "msg": "success",
  "data": {
    "link": "#小程序://问卷助手Lite/问卷调查/S33MnqkHVeE8agk"
  }
}
1
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版本,再点击短链进入待测页面。开发测试互不打扰

lastUpdate: 6/29/2021, 4:15:49 PM