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