# 小程序訂閱消息

# 功能介紹

消息能力是小程序能力中的重要組成，我們?yōu)殚_發(fā)者提供了訂閱消息能力，以便實(shí)現(xiàn)服務(wù)的閉環(huán)和更優(yōu)的體驗(yàn)。 訂閱消息推送位置：服務(wù)通知

訂閱消息下發(fā)條件：用戶自主訂閱

訂閱消息卡片跳轉(zhuǎn)能力：點(diǎn)擊查看詳情可跳轉(zhuǎn)至該小程序的頁面

# 消息類型

1. 一次性訂閱消息

一次性訂閱消息用于解決用戶使用小程序后，后續(xù)服務(wù)環(huán)節(jié)的通知問題。用戶自主訂閱后，開發(fā)者可不限時間地下發(fā)一條對應(yīng)的服務(wù)消息；每條消息可單獨(dú)訂閱或退訂。

2. 長期訂閱消息

一次性訂閱消息可滿足小程序的大部分服務(wù)場景需求，但線下公共服務(wù)領(lǐng)域存在一次性訂閱無法滿足的場景，如航班延誤，需根據(jù)航班實(shí)時動態(tài)來多次發(fā)送消息提醒。為便于服務(wù)，我們提供了長期性訂閱消息，用戶訂閱一次后，開發(fā)者可長期下發(fā)多條消息。

目前長期性訂閱消息僅向政務(wù)民生、醫(yī)療、交通、金融、教育等線下公共服務(wù)開放，后期將逐步支持到其他線下公共服務(wù)業(yè)務(wù)。

# 訂閱消息語音提醒

當(dāng)前小程序訂閱消息通知與微信消息的通知的提示音是一樣的，對于部分訂閱消息模板，增加語音提醒能力，播報(bào)預(yù)料部分字段支持開發(fā)者定義。

當(dāng)開發(fā)者調(diào)用wx.requestSubscribeMessage時僅訂閱1條消息且該模板支持開啟語音提醒，用戶在訂閱時可以選擇開啟語音提醒。開啟后將在接收訂閱消息時會同步播報(bào)語音提醒。當(dāng)用戶開啟了語音提醒，該模板的訂閱狀態(tài)為'acceptWithAudio'。

訂閱彈窗樣式如下：

當(dāng)前支持開啟語音提醒的模板及播報(bào)語料如下：

標(biāo)題 類型 類目 播報(bào)語料 收款到賬通知 長期訂閱 銀行 小程序收款元

以下情況會導(dǎo)致語音提醒無法播報(bào)： 用戶將服務(wù)通知設(shè)置為免打擾

用戶開啟了手機(jī)靜音模式或手機(jī)音量過低

用戶未打開微信新消息通知，可引導(dǎo)用戶前往微信-“我”-“設(shè)置”-“新消息通知”中打開

用戶未打開系統(tǒng)對微信的通知

用戶開啟了低電量模式

用戶版本過低：需要iOS 8.0.6與安卓8.0.3及以上

# 使用說明

# 步驟一：獲取模板 ID

在微信公眾平臺手動配置獲取模板 ID：

登錄 https://mp.weixin.qq.com 獲取模板，如果沒有合適的模板，可以申請?zhí)砑有履０?#xff0c;審核通過后可使用。

# 步驟二：獲取下發(fā)權(quán)限

# 步驟三：調(diào)用接口下發(fā)訂閱消息

# 注意事項(xiàng) 用戶勾選 “總是保持以上選擇，不再詢問” 之后，下次訂閱調(diào)用 wx.requestSubscribeMessage 不會彈窗，保持之前的選擇，修改選擇需要打開小程序設(shè)置進(jìn)行修改。

# 訂閱消息事件推送

1、當(dāng)用戶觸發(fā)訂閱消息彈框后，用戶的相關(guān)行為事件結(jié)果會推送至開發(fā)者所配置的服務(wù)器地址。

# XML格式示例

1610969440

2

2

# JSON 格式示例

{

"ToUserName": "gh_123456789abc",

"FromUserName": "o7esq5OI1Uej6Xixw1lA2H7XDVbc",

"CreateTime": "1620973045",

"MsgType": "event",

"Event": "subscribe_msg_popup_event",

"SubscribeMsgPopupEvent": [ {

"TemplateId": "hD-ixGOhYmUfjOnI8MCzQMPshzGVeux_2vzyvQu7O68",

"SubscribeStatusString": "accept",

"PopupScene": "0"

}],

}

# 參數(shù)說明

參數(shù) 說明 ToUserName 小程序帳號ID

FromUserName 用戶openid

CreateTime 時間戳

TemplateId 模板id(一次訂閱可能有多個id)

SubscribeStatusString 訂閱結(jié)果(accept接收；reject拒收)

PopupScene 彈框場景，0代表在小程序頁面內(nèi)

**2、當(dāng)用戶在手機(jī)端服務(wù)通知里消息卡片右上角“...”管理消息時，或者在小程序設(shè)置管理中的訂閱消息管理頁面內(nèi)管理消息時，相應(yīng)的行為事件會推送至開發(fā)者所配置的服務(wù)器地址。(目前只推送取消訂閱的事件，即對消息設(shè)置“拒收”)**

# XML 格式示例

1610969440

# JSON 格式示例

{

"ToUserName": "gh_123456789abc",

"FromUserName": "o7esq5OI1Uej6Xixw1lA2H7XDVbc",

"CreateTime": "1610968440",

"MsgType": "event",

"Event": "subscribe_msg_change_event",

"SubscribeMsgChangeEvent": [ {

"TemplateId":"BEwX0BOT3MqK3Uc5oTU3CGBqzjpndk2jzUf7VfExd8",

"SubscribeStatusString": "reject"

}],

}

# 參數(shù)說明

參數(shù) 說明 ToUserName 小程序帳號ID

FromUserName 用戶openid

CreateTime 時間戳

TemplateId 模板id(一次訂閱可能有多個id)

SubscribeStatusString 訂閱結(jié)果(reject拒收)

**3、調(diào)用訂閱消息接口發(fā)送消息給用戶的最終結(jié)果，會推送下發(fā)結(jié)果事件至開發(fā)者所配置的服務(wù)器地址。**

# XML格式示例

1610969468

1700827132819554304

0

# JSON 格式示例

{

"ToUserName": "gh_123456789abc",

"FromUserName": "o7esq5PHRGBQYmeNyfG064wEFVpQ",

"CreateTime": "1620963428",

"MsgType": "event",

"Event": "subscribe_msg_sent_event",

"SubscribeMsgSentEvent": {

"List": {

"TemplateId": "BEwX0BO-T3MqK3Uc5oTU3CGBqzjpndk2jzUf7VfExd8",

"MsgID": "1864323726461255680",

"ErrorCode": "0",

"ErrorStatus": "success"

}

}

}

# 參數(shù)說明

參數(shù) 說明 ToUserName 小程序帳號ID

FromUserName 用戶openid

CreateTime 時間戳

TemplateId 模板id(一次訂閱可能有多個id)

MsgID 消息id(調(diào)用接口時也會返回)

ErrorCode 推送結(jié)果狀態(tài)碼(0表示成功)

ErrorStatus 推送結(jié)果狀態(tài)碼對應(yīng)的含義

注意：失敗僅包含因異步推送導(dǎo)致的系統(tǒng)失敗

總結(jié)

以上是生活随笔為你收集整理的小程序消息服务器webapi,小程序订阅消息的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。