微信小程序弹窗、小程序订阅消息、小程序短链功能均需要在「通道管理」中完成「微信小程序」的授权后，才可以进行使用。

开通通道管理-微信小程序的相关权限，具体操作请参见权限设置。

小程序订阅消息包括一次性订阅和长期订阅，但目前长期订阅消息仅向政务民生、医疗、交通、金融、教育等线下公共服务开放，具体说明参考微信官方文档《小程序订阅消息》。
一次性订阅消息用于解决用户使用小程序时，后续服务环节的通知问题。用户自主订阅后，开发者可不限时间地下发一条对应的服务消息；每条消息可单独订阅或退订。也就是说C端用户必须先授权订阅，授权之后企业才可以触达。
重要说明：小程序订阅消息授权功能需客户在自己的小程序中进行开发，GMP平台不负责开发。

新增小程序

新增小程序是指完成小程序的授权动作，使得可以在微信小程序弹窗、小程序订阅消息中使用微信小程序。

1. 登录GMP控制台，选择营销配置 - 通道配置 - 微信小程序。​点击新增小程序。
2. 填写相关参数配置，点击确定接入。
   1. 接入方式选择三方授权模式，​该方式是客户侧通过扫码进行授权。
   2. ID 类型：需要选择组合 ID，通常选择的 ID 类型为 appid+openid。
   3. QPS 上限：代表每秒 GMP 消息的发送量。
3. 扫码授权，授权时必须勾选**「获取小程序码」、「小程序基本信息管理」、「小程序链接管理」**这三个权限，其他权限为可选。具体详情可参见权限集详细介绍。

频控与黑/白名单设置

该设置仅对小程序订阅消息生效。

小程序订阅消息配置

1. 接入小程序成功后，点击订阅消息配置。
   
   若在接入小程序时，进行了【小程序开发与数据分析】授权，订阅消息配置如下：
   

2. Access Token 配置（交互逻辑见接入模式对比）。

   • 方式一：​请将小程序密钥（secret）配置到GMP平台中，生效后我们将使用appID和secret调用小程序接口
   • 方式二：​一般是小程序托管由第三方管理，且之前已经生成过Token令牌的情况下会用到该方式，贴入 获取Access Token的地址；并将您的HTTP服务配置为GET方式，且以json格式返回accessToken信息：

   {
       "errcode": 0,   // 0代表成功，非0代表失败
       "errmsg": "",   // 失败时的错误信息
       "access_token": "", // accessToken
       "expires_in": 7200  // accessToken剩余的有效期时间，单位秒
   }
   

   

   • 方式三（V5.6及以上版本支持）：gmp请求对接方的「Access Token Url」时，支持不鉴权和aksk鉴权两种请求方式，需填写ak、sk、签名有效期，GMP在请求接口时，会计算签名，放在 Authorization 头部中。
     签名计算方式详见，GMP ak/sk 鉴权计算说明。
     

3. 事件回调地址配置（事件回调地址接入模式对比）。
   配置方式

   • 「开发者模式接入小程序」：类似开发者模式供GMP使用
   • 「非开发者模式模式接入小程序」：客户将小程序已交由第三方开发；例如：
     • 客户侧已开发微信服务平台，需选择「非开发者模式模式接入小程序」
     • 客户侧已使用过开发者模式对接小程序，需选择「非开发者模式模式接入小程序」
       URL服务器地址（GMP微信回执接收地址）
   • 「开发者模式接入小程序」：登录微信后台>开发管理>开发设置>消息推送，粘贴GMP平台的URL服务器地址，改地址需要带上?wechat_appid=。如https://xxx/gmp/wechatproxy?wechat_appid=xxx
   • 「非开发者模式模式接入小程序」：不需复制URL服务器地址到微信后台
     • 如需推送事件，请将事件推送至 URL服务器地址（GMP微信回执接收地址）

   说明

   第三方开发小程序的事件回调流程：

   1. GMP会提供回执接口地址（接口协议跟微信回调接口要求的协议一致，即该接口也支持微信侧直接调用推送事件信息）
   2. 客户原有的微信回调接口 接收到微信侧推送的事件信息之后，调用 GMP提供的回执接口 同步微信推送的事件信息给GMP

   微信侧回调请求参数说明
   回执内容各自段含义说明

   第三方转发时候，需要再路径中加入wechat_appid的query参数

   • query参数：

     • wechat_appid：微信appid
     • encrypt_type：加密类型
     • timestamp：时间戳
     • nonce：随机数
     • msg_signature：微信加密签名，signature结合了开发者填写的 token 参数和请求中的 timestamp 参数、nonce参数。

   • body参数,保持和微信返回的body一致：

     • XML格式示例
     1610969468 1700827132819554304 0
     • JSON格式示例

     {
     "ToUserName": "gh_123456789abc",
     "FromUserName": "o7esq5PHRGBQYmeNyfG064wEFVpQ",
     "CreateTime": "1620963428",
     "MsgType": "event",
     "Event": "subscribe_msg_sent_event",
     "List": {
     "TemplateId": "BEwX0BO-T3MqK3Uc5oTU3CGBqzjpndk2jzUf7VfExd8",
     "MsgID": "1864323726461255680",
     "ErrorCode": "0",
     "ErrorStatus": "success"
     }

     }

   Token令牌、EncodingAESKey：

   • 「开发者模式接入小程序」：登录微信开放平台>开发管理>开发设置>消息推送，复制内容粘贴到GMP平台
   • 「非开发者模式模式接入小程序」：与第三方平台的Token令牌。
     
     
     
     消息加密方式：
   • 「开发者模式接入小程序」：与小程序后台一致
   • 「非开发者模式模式接入小程序」：与第三方平台配置保持一致
     数据格式：
   • 「开发者模式接入小程序」：与小程序后台一致
   • 「非开发者模式模式接入小程序」：与第三方平台配置保持一致

接入模式对比
Access Token接入模式对比（发送链路）

事件回调地址接入模式对比（回执链路）

发送小程序订阅消息

1. 选择智能运营-消息触达，点击新建触达任务，选择小程序订阅消息。具体操作可参见创建消息触达任务。
   
2. 点击确定，会校验所选小程序是否完成【通道管理】中订阅消息配置.
3. 设置发送订阅消息。
   • 受众用户、触发条件、目标设置与GMP平台其他触达任务设置无差异
   • 触达配置：支持选择小程序订阅消息模板，根据所选模板进行字段配置；点击模板卡片后跳转页面，仅支持本小程序的页面