文档 下载中心

小程序开发

小程序功能简介

本文档阐述了超赛自动生成小程序功能的使用说明和功能细节。

自动生成小程序功能是通过用户授权的方式,在超赛后台配置小程序所需的内容参数,自动生成小程序应用并提审发布到微信公众平台。

快速生成控制硬件产品的小程序端,使企业客户快速、低成本地将智能硬件产品推向市场。

扫码体验机智云公版小程序”机智云联”
applets-qr

创建小程序流程

applets1

微信平台操作

注册微信小程序

  • 已有微信公众号且已微信认证的,走【路径1】可以复用认证资质,无需重新提交主体材料、无需对公打款、无需支付300元认证费用。
  • 已有微信公众号但无微信认证,可走【路径2】先进行微信公众号认证,再走【路径1】创建小程序。
  • 未有微信公众号或不想关联公众号的,需要单独注册小程序加认证资质,走【路径3】

【路径1】以下步骤参考了腾讯官方文档:公众号快速注册并认证小程序

第一步:打开微信公众平台网址微信公众平台,登录并进入微信公众号页面。

第二步:页面下滑,找到【小程序管理】并点击进入页面。

applets2

第三步:点击【添加】按钮, 创建新的小程序。

applets3

第四步:选择快速注册并认证小程序。

applets4

第五步:阅读快速创建小程序说明,勾选我已明白,点击【快速创建】。

applets5

第六步:用微信公众号管理员的微信扫码进行验证。

applets6

第七步:选择并确认复用的主体资质,默认需要勾选主体资质和微信认证资质,运营商信息可以选择勾选,也可以不勾选,不勾选的话,后续激活小程序时需要绑定其他管理员。

applets7

第八步:填写小程序的登录邮箱及密码(邮箱必须是未注册过微信公众平台、未注册过微信开放平台和未被个人微信号绑定过的),勾选已阅读并同意协议,点击【提交】。

applets8

第九步:提交后,邮箱会收到一封激活小程序的邮件,点击邮件的链接按步骤进行激活。

applets9

第十步:点击激活链接,并登录刚刚设置的小程序账号密码。

applets10

第十一步:绑定小程序管理员,填写管理员信息。若刚刚勾选了运营者信息,则复用运营者为管理员,需要获取短信验证码和扫码验证微信身份信息。一个微信用户只能绑定为5个小程序的管理员。

applets11

第十二步:绑定成功后,进入微信小程序页面,配置小程序的名称和图标,获取小程序Appsecret并保存下来即可。

【路径2

请参考请参考以下腾讯官方文档进行公众号微信认证微信认证申请方法?,认证完成后再走【路径1】。

【路径3】

请参考请参考以下腾讯官方文档进行小程序注册:小程序注册流程

注册成功后,进入微信小程序页面,配置小程序的名称和图标,获取小程序Appsecret并保存下来即可。

小程序微信认证

请参考以下腾讯官方文档进行微信认证:

第一步:找到微信认证入口小程序微信认证方法

第二步:准备认证所需资料小程序微信认证所需资料

第三步:提交认证资料并打款(认证费用为300元)小程序微信认证申请流程指引

第四步:等待认证审核完成即可。小程序微信认证认证审核问题

获取小程序AppSecret

第一步:登录微信公众平台小程序账号,进入小程序的后台,点击左侧的开发管理。

applets12

第二步:在右侧切换到开发工具选项后,在下面就可以看到AppSecret,点击后面的重置即可看到。

applets13

第三方开放平台绑定小程序

第一步:登录微信开放平台https://open.weixin.qq.com,有开放平台账号的直接登录,无账号需要按文档步骤注册微信开发平台账号:open帐号注册操作步骤

⚠️注意:微信开发平台账号并不是微信公众平台账号,二者不相同,不互通。

第二步:打开【管理中心】,选择【小程序】一栏,点击【绑定小程序】按钮。

applets14

第二步:填写需要绑定的小程序的登录邮箱、登录密码;

applets15

第三步:使用小程序管理员微信号进行扫码验证;验证通过后,即绑定成功。

applets16


超赛平台操作

新建小程序应用

第一步:登录超赛官方网站https://developer.gizwits.com/login ,输入账号密码,点击登录。

applets17

第二步:选择个人项目或企业项目,选择右侧模块的移动应用,切换到小程序一栏,点击【创建】按钮。

applets18

第三步:输入小程序应用的名称和logo,填写完成后,点击【确认】即可。名称为必填项,图标可以不填,不填会使用默认图标。

  • 这里的名称和图标不会同步到微信公众平台,只会显示在小程序应用内,所以尽量手动输入时和微信平台的小程序信息保持一致。

applets19

applets20

⚠️注意:小程序的服务使用的是AEP业务后台的服务,所以创建小程序后,还需要确认是否已创建业务应用后台,并开通SaaS服务。否则构建后将无法使用小程序应用。

applets21

applets22

授权小程序

第一步:创建小程序后,进入小程序配置页面,点击【去授权】按钮,进入授权页面。

applets23

第二步:用小程序管理员的微信APP扫码页面上的授权二维码,微信APP上勾选协议并点击确定授权,等页面显示授权成功后,点击【已完成授权】。

applets24

applets25 applets26

applets27

第三步:填写小程序的Appsecret信息,填写完成后,点击【完成】按钮。

applets28

  • 如何获取AppSecret参考前文《如何获取小程序AppSecret》的步骤说明。
  • 填写完成后,还需确认已微信认证和第三方平台已绑定,参考前文《如何进行小程序微信认证》与《如何绑定第三方开放平台》的步骤说明,后两项在构建小程序之前完成即可。

解除授权小程序

第一步:解除授权需要登录微信公众平台的小程序账号微信公众平台,页面下滑到最底部,点击右侧【设置】,切换到第三方设置一栏。

applets29

第二步:再第三方设置页面,点击机智云IoT开发平台的右侧【解除授权】按钮。

applets30

第三步:用小程序管理员的微信APP扫码确定解除授权,在手机上点击【确定】后,在微信小程序后台点击【解除】后即可。若有关闭原因也可以反馈给机智云平台。

applets31

applets32

applets33

applets34

修改超赛小程序的AppSecret

若微信平台的小程序AppSecret有更改,需要在超赛后台小程序应用中进行修改更新。

进入小程序详情页,点击右侧的【详情】,在弹出的页面中,找到最下面的AppSecret一栏,将新的AppSecret填入输入框内,并点击【修改】即可。

applets35

applets36

配置小程序主题色

在超赛后台配置小程序主题色,构建小程序应用后,会生成对应主题色的小程序应用。

进入后台小程序页面,选中【个性化】-【主题】,选择推荐的主题色或设置自定义主题色,修改完成后点击【保存】即可。

applets37

配置小程序隐私政策和用户协议

进入后台小程序页面,选中【个性化】-【页面配置】,在输入框中配置隐私条款和用户协议,支持中英文,配置后会在右侧显示对应的手机端效果。

applets38

小程序端功能显示入口:

applets39 applets40 applets41

小程序关联产品

进入后台小程序页面,选中【个性化】-【关联产品】,点击添加按钮,选择已创建的产品进行关联。

applets42

applets43

产品关联小程序

第一步:返回首页,选中产品,打开产品详情页。

applets44

第二步:选中【应用页面】一栏,点击右侧【添加应用】按钮,选中需要关联的小程序,点击【确认】即可关联成功。

applets45

applets46

applets47

  • 小程序的产品配置目前支持控制页面、配网引导、使用帮助三部分的配置。

配置推送功能

进入后台小程序页面,选中【拓展功能】-【推送设置】,在需要开启的推送类型后点击开启按钮,开启后点击【保存】即可。

⚠️注意:这里的开启/关闭是对应小程序上功能的显示与否,具体的推送条件和配置需要到相应平台进行操作。

applets48

小程序端推送功能显示入口:

applets49 applets50
  • 微信订阅消息需要到微信公众平台申请设备消息模版能力
  • 电话推送需要到AEP业务后台配置相关参数
  • 短信推送也需要到AEP业务后台配置相关参数

开启微信订阅消息(申请微信设备消息模版能力)

微信设备订阅消息具体形式:

applets51 applets52 applets53

第一步:申请设备消息能力小程序设备消息 | 微信开放文档

    1. 要使用微信推送必须先开通设备消息能力。
    2. 申请条件:发布一个版本才能申请设备消息能力。
    3. 路径:在微信公众平台首页,进入【硬件设备】页面,点击【添加设备】,填写设备信息后提交审核。

applets54

需要填写的设备资料如下:

applets55

applets56

⚠️注意:申请设备是为了使用长期订阅的设备消息推送,若申请了设备后,发现还是没有长期订阅的消息,可能是申请的品类在微信公众平台那边还没有模版,需要联系微信公众平台的客服咨询。已知传感器类型的设备是有长期订阅模版的。

第二步:创建消息模板小程序设备消息 | 微信开放文档

  1. 开通设备消息能力后,在微信公众平台首页进入【订阅消息】页面,点击【选用】或选择【公共模板库】进入。

applets57

  1. 选用【一次性订阅】或【长期订阅】,设备报警推送请选择长期订阅,选择合适的模版,点击右侧【选用】。

applets58

  1. 填写模板内容后,选中关键词(关键词不可修改),填写场景说明(必填),点击提交即完成设置,完成后可获取模版ID。

applets59

  1. 复制模版ID,并在AEP后台填写微信模板ID,选择对应的微信模板配置,即可使用微信小程序推送。

applets60

AEP台配置微信小程序推送

第一步:登录AEP后台厂商账号,选择【消息配置管理】-【模版内容配置】,点击【添加】模版。

applets61

第二步:填写模版名称,选中推送类型为【微信小程序】,选中模版类型,填入在微信公众平台小程序账号下-订阅消息里的【微信模版ID】,点击【保存】即可。

applets62

第三步:配置微信小程序的设备触发条件,选中【消息配置管理】-【触发条件配置】,点击【添加】按钮,进入触发条件配置页面。

applets63

第四步:

  1. 填写模版名称,选择产品,选择推送类型为微信小程序,选中消息类型。
  2. 设置触发条件
  3. 选择模版内容后点击获取微信模版ID,选择触发条件的功能点并填写名称(只支持英文),将该名称以特定格式填入下方的模版内,选择其他参数后,设置完成后【保存】即可。

applets64

如何在AEP后台配置电话推送

第一步:在admin账号,找到厂商对应的企业,配置呼叫平台所需的参数(参数在对应的第三方呼叫平台获取)。(联系配置进行操作)

applets65

第二步:登录厂商账号,选择【呼叫事件管理】,点击【添加】按钮。

applets66

第三步:选择【业务事件】,添加语音指令,选择呼叫平台,填写模版ID和在第三方平台申请的语音模版内容。

applets67

第四步:在消息配置中配置语音模版内容,选择【消息配置管理】-【模版内容配置】,点击【添加】模版,填写模版名称,选中推送类型为【语音】,选择模版类型,点击【保存】即可。

applets68

第五步:配置触发条件,选择【消息配置管理】-【触发条件】,填写模版名称,选择产品,选择推送类型为【语音】,选择消息类型并设置触发条件,设置完成后点击【保存】即可。

applets69

在AEP后台配置短信推送

需要在云片里申请短信模版(联系罗文伟Oven进行操作)

第一步:登录AEP后台厂商账号,在短信推送配置添加推送配置,选择【消息配置管理】-【短信推送配置】,点击【添加】按钮。

applets70

第二步:输入配置名称,选中短信平台为【云片】,填入AppKey(云片平台获取的),勾选需要绑定推送的应用,点击【保存】即可。

applets71

第三步:在模版内容配置中添加短信模版,填写模版名称,选择推送类型为【短信】,选择模版类型和使用的短信配置,选中内容配置,点击【添加一项】添加英文的配置,中英文都需要配置,设置完成后点击【保存】即可。

applets72

第三步:配置触发条件,选择【消息配置管理】-【触发条件配置】,点击【添加】按钮,进入触发条件配置,输入模版名称,选择产品,推送类型选择【短信】,选择消息类型和配置触发的条件,设置完成后点击【保存】即可。

applets73

⚠️注意:如果模版类型和推送类型相同,模版名称不同,会随机拿一个模版去推送,所以同一个模版类型和推送类型的只需要配置一个即可

配置体验中心功能

进入后台小程序页面,选中【拓展功能】-【体验中心配置】,将状态开关开启后点击【保存】即可,配置后体验中心功能会显示在小程序中,并且关联的产品将会显示在体验中心中。

applets74

小程序端体验中心功能显示入口:

applets75 applets76

客服功能使用说明

使用客服功能的步骤是:

先在【企业微信平台】中获取企业ID和客服链接 ——>再到【微信公众平台】小程序账号中开通微信客服功能——>最后在【超赛后台】中开启客服功能并配置参数。

获取企业ID

(一)创建企业

获取企业ID的前提是,需要在企业微信上创建企业,已有企业微信的公司可忽略,未有的可以根据官方文档进行注册注册企业微信-帮助中心-企业微信,创建完成后就能生成企业ID。

(二)获取企业ID

(1)PC端:管理员登录企业微信管理后台企业微信,找到【我的企业】,在企业信息页面最底端便可查看企业ID。

applets77

(2)手机端【工作台->管理企业->企业信息->企业ID】

applets78

获取客服链接

获取客服链接前,需要已有接待的客服,未设置客服的需要先添加客服,已有客服的可以忽略此步骤。

(一)添加微信客服

第一步:企业微信的管理员扫码登录企业微信管理后台点击打开企业微信登录后台

applets79

第二步:找到【微信客服】应用,点击开通(若之前已开通过,可跳过开通的步骤,直接看下一步)

applets80

第三步:点击【开始使用】,默认企业下所有成员可见,有所有的管理权限。为了保障客服不被任意修改,建议配置好【可见范围】和【管理权限】,部分员工可见。

applets81

第四步:创建客服账号,并添加接待人员,否则用户的问答,无人对接。点击【创建账号】,添加【接待人员】,该设置页面,根据实际需求,配置其他的内容,比如默认回复,接待时间等。

applets82

applets83

(二)获取客服链接

客服账号创建完成后,在微信客服的设置页面,对应的客服账号点击进入,复制对应客服号下的【客服链接】,填写到相应的后台。

applets84

applets85

开通微信客服

  1. 路径:小程序——功能——客服
  2. 选择微信客服,点击【接入】,填写企业ID后确定即可。

applets86

applets87

配置客服功能

进入超赛后台小程序页面,选中【拓展功能】-【客服设置】,将状态开关开启,填写企业ID和客服链接,点击【保存】即可。配置后客服功能会显示在小程序中,点击可以跳转到客服聊天窗口。

applets88

小程序端客服功能显示入口:

applets89 applets90

配置使用帮助

进入后台小程序页面,选中【拓展功能】-【使用帮助】,先添加分类,再添加问题,编辑完成后,点击【发布】即可,配置后使用帮助功能会显示在小程序中。

若有更新的文档,保存后发布即可实时在线更新。

applets91

applets92

applets93

applets94 applets95

构建微信小程序

构建小程序三要素:

  1. 授权小程序并填写小程序的AppSecret
  2. 已完成微信认证
  3. 微信开发平台已绑定小程序

确定完成以上三项后,选中【构建应用】,点击【立即构建】,等待构建结果即可。

applets96

添加体验者

在【构建应用】—【构建管理】页面,点击开发版本右侧的【+添加体验者】入口。在弹窗内输入微信号和备注,点击添加即可。(体验成员人数限制是90位。)

⚠️注意:这里只会检测该微信号是否存在,不会检测该微信对应的用户是谁,所以需要自行确认输入的微信号是否正确。

applets97

applets98

下载小程序体验版二维码

小程序构建完成后,会有一个体验二维码,点击下载即可保存,即使有版本更新,体验二维码也不会变,但是体验二维码不可作为正式二维码分发出去。

applets99

体验版二维码和正式版二维码的区别

  1. 体验二维码是发布前用于测试的二维码,正式二维码是小程序码,两者生成后都不会改变。
  2. 体验二维码只有添加了体验成员才能使用,体验成员人数限制是90位。
  3. 正式二维码没有人数限制,也无需添加体验人员。

提交小程序到微信公众平台审核

小程序构建完成后,点击【提交审核】,阅读并勾选同意平台规则,添加版本描述等信息,点击【提交审核】即可提交到微信公众平台的小程序上审核,提交后查看审核管理可以看到当前审核状态,审核通过后就能正式发布了。

applets100

applets101

applets102

applets103

applets104

发布小程序

在【构建应用】-【审核管理】页面,审核状态为审核通过待发布时,表示在微信公众平台的审核已经通过,点击右侧的【发布】按钮即可发布正式版小程序。发布完成后,可以在上架管理看到正式版的小程序。

applets105

下载小程序正式版二维码

方式一:已构建应用并成功上架后,进入【构建应用】-【上架管理】,点击右侧的下载二维码,下载保存即可。

applets106

方式二:未构建应用,可以在小程序详情中,基本信息-小程序二维码一栏,点击【下载】即可。

applets107

applets108

撤销小程序审核

在【构建应用】-【审核管理】页面,审核状态为审核中时,点击右侧的【撤销审核】按钮即可。

applets109

applets110

回退小程序版本

在【构建应用】-【上架管理】页面,点击版本后面的三角图标,在下拉框中选中【回退版本】,选中需要回退的版本即可。

⚠️注意:

  1. 如果没有上一个线上版本,将无法回退
  2. 版本回退每天只有20次的调用限额
  3. 可指定版本进行回滚,但最多保存最近发布或回退的5个版本
  4. 当前版本回退后,不能再调用版本回退接口

applets111

暂停服务功能说明

在【构建应用】-【上架管理】页面,点击版本后面的三角图标,在下拉框中选中【暂停服务】,暂停后小程序不再能使用,恢复服务需要登录微信公众平台中设置。

applets112

恢复服务:在微信公众平台小程序账号里,选中【设置】-【暂停服务设置】,点击右侧的【恢复服务】即可。

applets113

©2011-2022; Gizwits IoT Technology Co., Ltd. 粤ICP备11090211号