小程序的推送功能，簡(jiǎn)單說(shuō)就是能主動(dòng)給用戶發(fā)消息提醒，比如訂單狀態(tài)變更、活動(dòng)通知、服務(wù)提醒這些，既能幫用戶及時(shí)獲取關(guān)鍵信息，也能提升小程序的用戶粘性。不過(guò)很多人搞不清楚推送功能怎么實(shí)現(xiàn)，尤其是模板消息和訂閱消息的區(qū)別和配置方法。這里先明確一個(gè)關(guān)鍵：現(xiàn)在模板消息已經(jīng)逐步被訂閱消息替代了，新開(kāi)發(fā)優(yōu)先做訂閱消息，模板消息僅針對(duì)老項(xiàng)目兼容。下面就用大白話，把這兩種消息的實(shí)現(xiàn)邏輯和配置步驟講明白，全程避開(kāi)專業(yè)術(shù)語(yǔ)的坑。
不管是模板消息還是訂閱消息，實(shí)現(xiàn)推送的核心邏輯都一樣，簡(jiǎn)單說(shuō)就是“三步走”：第一步，得有小程序賬號(hào)和后臺(tái)服務(wù)，這是推送的基礎(chǔ)；第二步，要讓用戶同意接收消息（也就是授權(quán)），不然沒(méi)法主動(dòng)發(fā)；第三步，通過(guò)官方接口把消息組裝好，發(fā)送給用戶。
這里要強(qiáng)調(diào)兩個(gè)關(guān)鍵前提：一是必須有服務(wù)器或者用官方提供的云服務(wù)，因?yàn)橥扑拖⑿枰笈_(tái)代碼調(diào)用接口，不能只靠小程序前端；二是要配置好域名白名單（如果是自建服務(wù)器），確保小程序能正常和服務(wù)器、官方接口通信，不然消息發(fā)不出去。就像寄快遞，得有寄件地址（服務(wù)器）、收件人同意收件（用戶授權(quán)），還要走正規(guī)快遞通道（官方接口），少一步都不行。
模板消息是早期的推送方式，現(xiàn)在官方已經(jīng)不推薦新用了，但很多老小程序還在使用，這里簡(jiǎn)單說(shuō)下配置步驟，重點(diǎn)講清楚注意事項(xiàng)，避免踩坑。
首先登錄小程序官方后臺(tái)，找到“模板消息”相關(guān)模塊（不同平臺(tái)入口可能略有差異），然后根據(jù)自己的業(yè)務(wù)場(chǎng)景選擇模板，比如“訂單支付成功通知”“預(yù)約提醒”等。如果沒(méi)有合適的現(xiàn)成模板，可以申請(qǐng)自定義模板，填寫(xiě)模板標(biāo)題、內(nèi)容字段（比如訂單號(hào)、時(shí)間、金額），提交后等待審核，審核通過(guò)后就能拿到一個(gè)唯一的“模板ID”，這個(gè)ID很關(guān)鍵，后續(xù)發(fā)送消息要用到。
這里要注意：模板消息的內(nèi)容必須和業(yè)務(wù)場(chǎng)景匹配，不能亂申請(qǐng)，比如做電商的不能申請(qǐng)教育類的模板，審核會(huì)不通過(guò)；而且模板里的字段是固定的，后續(xù)發(fā)送消息時(shí)只能填充對(duì)應(yīng)字段的內(nèi)容，不能隨意加無(wú)關(guān)信息。
要給用戶發(fā)模板消息，必須知道用戶的唯一標(biāo)識(shí)（也就是OpenID），這個(gè)可以通過(guò)小程序前端代碼獲取，用戶登錄小程序時(shí)就能拿到，拿到后要存到后臺(tái)數(shù)據(jù)庫(kù)里。
另外，模板消息有個(gè)嚴(yán)格要求：必須有用戶觸發(fā)的場(chǎng)景，比如用戶完成支付、提交表單、點(diǎn)擊按鈕后，才能發(fā)送對(duì)應(yīng)的模板消息，不能無(wú)理由主動(dòng)發(fā)。比如用戶下單后，才能發(fā)“訂單提交成功”的模板消息，不能用戶沒(méi)操作就發(fā)廣告，不然會(huì)被官方限制。
這一步需要后臺(tái)開(kāi)發(fā)人員寫(xiě)代碼，核心是“組裝消息內(nèi)容+調(diào)用官方接口”。首先，根據(jù)之前拿到的模板ID，把對(duì)應(yīng)的字段內(nèi)容填好，比如模板里有“訂單號(hào)”“支付時(shí)間”“金額”，就從數(shù)據(jù)庫(kù)里把這些數(shù)據(jù)取出來(lái)，按照模板要求的格式組裝好。
然后，調(diào)用官方提供的模板消息發(fā)送接口，傳入模板ID、用戶OpenID、組裝好的消息內(nèi)容，還有點(diǎn)擊消息后跳轉(zhuǎn)的小程序頁(yè)面路徑（可選）。調(diào)用接口后，官方會(huì)返回發(fā)送結(jié)果，如果返回成功，用戶就能在消息列表里收到通知了；如果失敗，會(huì)返回錯(cuò)誤碼，比如“模板ID錯(cuò)誤”“用戶未授權(quán)”，根據(jù)錯(cuò)誤碼排查問(wèn)題就行。
模板消息的限制很多，重點(diǎn)注意這幾點(diǎn)：一是發(fā)送頻率有限制，不能頻繁發(fā)，不然會(huì)被限流；二是必須有用戶觸發(fā)場(chǎng)景，無(wú)場(chǎng)景發(fā)送會(huì)被處罰；三是只能用于通知類消息，不能發(fā)廣告、營(yíng)銷類內(nèi)容；四是新小程序現(xiàn)在已經(jīng)無(wú)法申請(qǐng)新的模板消息了，只能用訂閱消息，所以老項(xiàng)目如果有條件，建議升級(jí)成訂閱消息。
訂閱消息是現(xiàn)在官方推薦的推送方式，比模板消息靈活，限制也更合理，支持一次性訂閱和長(zhǎng)期訂閱（部分類目支持），下面詳細(xì)拆解配置步驟，從準(zhǔn)備工作到最終發(fā)送，一步一步講清楚。
首先，確保已經(jīng)完成小程序賬號(hào)注冊(cè)和認(rèn)證，拿到AppID和AppSecret（在后臺(tái)“開(kāi)發(fā)設(shè)置”里找），這兩個(gè)是調(diào)用官方接口的“鑰匙”，要妥善保存。然后，準(zhǔn)備好服務(wù)器（自建或云服務(wù)），如果是自建服務(wù)器，要在小程序后臺(tái)配置好服務(wù)器域名白名單，把官方接口域名和自己的服務(wù)器域名加進(jìn)去，不然接口調(diào)用會(huì)失敗。
如果用官方云開(kāi)發(fā)，就不用自己配置服務(wù)器和域名了，直接用云函數(shù)調(diào)用接口就行，更簡(jiǎn)單，適合不懂后臺(tái)開(kāi)發(fā)的新手。
登錄小程序官方后臺(tái)，找到“訂閱消息”模塊，選擇“公共模板庫(kù)”，根據(jù)業(yè)務(wù)場(chǎng)景篩選模板，比如“服務(wù)預(yù)約提醒”“物流狀態(tài)通知”“活動(dòng)開(kāi)始提醒”等。選中模板后，勾選需要的字段（比如預(yù)約時(shí)間、服務(wù)內(nèi)容、地點(diǎn)），提交后就能拿到“模板ID”，和模板消息一樣，這個(gè)ID是后續(xù)發(fā)送消息的關(guān)鍵。
如果公共模板庫(kù)沒(méi)有合適的，可以申請(qǐng)“自定義模板”，填寫(xiě)模板標(biāo)題、字段名稱、字段類型（文本、數(shù)字、日期等），提交審核，審核通過(guò)后就能使用。這里要注意：自定義模板的審核比較嚴(yán)格，字段要和業(yè)務(wù)相關(guān)，不能冗余，比如沒(méi)必要的字段不要加，不然會(huì)審核不通過(guò)。
訂閱消息的核心要求是“用戶主動(dòng)同意”，所以必須在小程序前端加一個(gè)授權(quán)按鈕，讓用戶點(diǎn)擊后彈出授權(quán)彈窗，用戶選擇“允許”后，才能后續(xù)發(fā)送消息。不能默認(rèn)授權(quán)，也不能誘導(dǎo)用戶同意，不然會(huì)被官方處罰。
具體操作：在小程序的某個(gè)頁(yè)面（比如下單頁(yè)、預(yù)約頁(yè)）添加一個(gè)按鈕，綁定點(diǎn)擊事件，點(diǎn)擊后調(diào)用官方提供的授權(quán)接口（比如wx.requestSubscribeMessage），傳入之前拿到的模板ID。這時(shí)會(huì)彈出彈窗，讓用戶選擇“允許”或“拒絕”；如果用戶勾選“總是保持以上選擇，不再詢問(wèn)”，后續(xù)再調(diào)用授權(quán)接口就不會(huì)再?gòu)棿?，保持之前的選擇。
用戶授權(quán)后，前端要把授權(quán)結(jié)果（同意或拒絕）和用戶的OpenID一起傳到后臺(tái)，后臺(tái)把這些信息存到數(shù)據(jù)庫(kù)里，后續(xù)發(fā)送消息時(shí)要先判斷用戶是否授權(quán)，只有授權(quán)過(guò)的才能發(fā)。這里要注意：每次發(fā)送不同類型的消息，都需要對(duì)應(yīng)的模板授權(quán)，比如發(fā)“訂單提醒”和“活動(dòng)通知”，需要用戶分別授權(quán)兩個(gè)模板。
這一步和模板消息類似，但接口不同，需要后臺(tái)調(diào)用訂閱消息的發(fā)送接口。首先，從數(shù)據(jù)庫(kù)里取出用戶的OpenID、對(duì)應(yīng)的模板ID，然后根據(jù)模板的字段要求，組裝消息內(nèi)容，比如模板字段是“活動(dòng)名稱”“開(kāi)始時(shí)間”“地點(diǎn)”，就把對(duì)應(yīng)的信息填進(jìn)去，確保字段名稱和模板里的一致，不然會(huì)顯示異常。
然后，調(diào)用官方訂閱消息發(fā)送接口，傳入模板ID、用戶OpenID、消息內(nèi)容、跳轉(zhuǎn)頁(yè)面路徑（可選）等參數(shù)。調(diào)用后，官方會(huì)返回發(fā)送結(jié)果，0表示成功，其他錯(cuò)誤碼表示失敗，比如“用戶未授權(quán)”“模板ID錯(cuò)誤”“消息字段不匹配”等，根據(jù)錯(cuò)誤碼排查問(wèn)題即可。
這里要注意：訂閱消息有發(fā)送頻率限制，比如開(kāi)通支付功能的小程序每天最多發(fā)300萬(wàn)條，沒(méi)開(kāi)通的最多100萬(wàn)條，具體以官方規(guī)則為準(zhǔn)；而且消息內(nèi)容要真實(shí)有效，不能夸大或發(fā)送無(wú)關(guān)信息。
現(xiàn)在訂閱消息還支持語(yǔ)音提醒功能，只要模板支持，用戶在授權(quán)時(shí)可以選擇開(kāi)啟語(yǔ)音提醒，收到消息時(shí)會(huì)同步播報(bào)語(yǔ)音，比如“收款到賬10元”。配置方法也很簡(jiǎn)單，在調(diào)用授權(quán)接口時(shí)，確保模板支持語(yǔ)音提醒，用戶勾選即可，不需要額外寫(xiě)復(fù)雜代碼。
另外，要做好消息管理，比如用戶后續(xù)取消訂閱（在消息列表里設(shè)置拒收），官方會(huì)把這個(gè)事件推送到后臺(tái)，后臺(tái)要及時(shí)更新用戶的授權(quán)狀態(tài)，避免后續(xù)再給拒收的用戶發(fā)消息，既浪費(fèi)資源又影響用戶體驗(yàn)。
不管是哪種推送方式，都要注意以下幾點(diǎn)，不然容易出現(xiàn)推送失敗或者被官方處罰的情況：
1. 嚴(yán)格遵守授權(quán)規(guī)則：不能誘導(dǎo)用戶授權(quán)，比如不授權(quán)就不讓用小程序核心功能；也不能在用戶沒(méi)授權(quán)的情況下強(qiáng)行發(fā)送消息，會(huì)直接失敗。
2. 控制推送頻率和時(shí)間：不要頻繁給用戶發(fā)消息，比如一天發(fā)好幾次，容易讓用戶反感，還可能被限流；推送時(shí)間盡量選在用戶活躍時(shí)段，比如9:00-21:00，避開(kāi)休息時(shí)間。
3. 保護(hù)用戶隱私：消息內(nèi)容里不能包含用戶敏感信息，比如手機(jī)號(hào)、身份證號(hào)；后臺(tái)存儲(chǔ)用戶OpenID等信息時(shí)，要做好加密，防止信息泄露。
4. 做好異常監(jiān)控：后臺(tái)要記錄每次推送的結(jié)果，比如哪些用戶發(fā)送失敗、失敗原因是什么，定期排查問(wèn)題；同時(shí)要監(jiān)控用戶的訂閱狀態(tài)變化，及時(shí)調(diào)整推送策略。
5. 消息內(nèi)容有價(jià)值：推送的消息必須和用戶相關(guān)，能幫用戶解決問(wèn)題，比如訂單提醒、服務(wù)到期提醒等，不要發(fā)無(wú)關(guān)的廣告或垃圾信息，不然用戶會(huì)取消訂閱，還可能投訴。
簡(jiǎn)單說(shuō)結(jié)論：新開(kāi)發(fā)的小程序，直接選訂閱消息，功能更全、限制更合理，還支持語(yǔ)音提醒等進(jìn)階功能；如果是老小程序，已經(jīng)在用模板消息且能滿足需求，可以暫時(shí)繼續(xù)用，但建議逐步升級(jí)成訂閱消息，因?yàn)楣俜胶罄m(xù)可能會(huì)逐步停止對(duì)模板消息的支持。
最后再梳理一下核心：實(shí)現(xiàn)推送的關(guān)鍵是“賬號(hào)+服務(wù)器+用戶授權(quán)+官方接口”，配置步驟看似復(fù)雜，其實(shí)拆解開(kāi)來(lái)就是“申請(qǐng)模板-獲取授權(quán)-發(fā)送消息”三步，只要跟著步驟來(lái)，注意好授權(quán)和合規(guī)問(wèn)題，就能順利實(shí)現(xiàn)推送功能。如果不懂后臺(tái)開(kāi)發(fā)，也可以用官方的云服務(wù)，減少服務(wù)器配置的麻煩，專注于消息內(nèi)容和業(yè)務(wù)邏輯即可。
聯(lián)系電話題-1.jpg)