小程序卡片消息是聊天和 App 服務之間的橋——用戶在對話里點一下卡片直接落到小程序的具體頁面。它的工程要點在卡片參數怎么拼和落地頁怎么接。一、小程序卡片的結構發(fā)送小程序消息的參數組合比鏈接消息復雜小程序的 appid、頁面路徑path決定落地到哪個頁面、標題、縮略圖。其中頁面路徑是靈魂——同一個小程序路徑帶不帶訂單號參數用戶體驗天差地別?？ㄆl(fā)出去能不能正常打開取決于 appid 和路徑的正確性。程序發(fā)送前最好先驗證路徑模板渲染后的完整性——占位符沒填的路徑點開就是報錯頁。二、通知類場景——狀態(tài)變化帶直達入口訂單、預約、審批這類狀態(tài)通知配上小程序卡片就是通知直達用戶看到訂單已發(fā)貨點卡片直接進訂單詳情頁。比鏈接消息的優(yōu)勢在于免登錄——小程序內通常已有登錄態(tài)用戶點開就能看不用再走一遍驗證。通知卡片的路徑參數設計路徑必須帶業(yè)務主鍵訂單號、預約 ID落地頁按參數渲染對應數據。參數缺失或錯誤的路徑要在發(fā)送前攔截。三、服務引導場景——把功能送到對話里用戶在對話里問怎么查物流預約什么時候程序識別意圖后直接發(fā)對應功能頁的卡片——查物流卡片、預約管理卡片。用戶不用自己找入口對話即服務。引導卡片的關鍵是意圖識別的準確率——識別錯了推錯頁面用戶反而困惑。低置信度時寧可發(fā)文本問一句不硬推卡片。四、點擊數據回流小程序側埋點記錄卡片點擊和發(fā)送日志按用戶批次對賬就能算出每類卡片的打開率。打開率低的通知卡片換標題和縮略圖測試打開率持續(xù)低的服務引導檢查意圖識別邏輯。小程序消息場景對照場景路徑特點發(fā)送時機優(yōu)化指標狀態(tài)通知帶業(yè)務主鍵參數事件觸發(fā)打開率功能引導固定功能頁意圖識別觸發(fā)意圖準確率活動推廣活動頁渠道參數活動周期轉化率小程序卡片發(fā)送實現MINIAPP { appid: wx1234567890, order_page: pages/order/detail?no{order_no}, booking_page: pages/booking/index, } def send_order_card(order): 發(fā)貨通知卡片 path MINIAPP[order_page].format(order_noorder[no]) if { in path: # 路徑校驗占位符必須填滿 return False, 路徑參數缺失 r api(sendMiniApp, { wId: WID, toUser: order[wxid], appid: MINIAPP[appid], page: path, title: f您的訂單已發(fā)貨, thumb: THUMB_ORDER }) if r.get(code) 1000: db.save(miniapp_log, { wxid: order[wxid], path: path, scene: order_notify, sent_at: now()}) return True, 已發(fā)送 return False, r.get(code) app.post(/webhook) def webhook(): d request.json if d.get(messageType) 1: text d.get(content, ) wxid d[fromUser] intent classify_intent(text) # 意圖識別 if intent query_logistics: order get_latest_order(wxid) if order: send_order_card(order) else: sendText(WID, wxid, 請?zhí)峁┯唵翁枎湍樵儈) return {code: 1000}落地建議小程序消息先跑通通知類場景——路徑參數固定、觸發(fā)事件明確最容易標準化。功能引導類依賴意圖識別放第二步。所有卡片發(fā)送前做路徑校驗發(fā)送后記錄日志和對賬打開率形成優(yōu)化閉環(huán)。小程序消息接口參數說明參考 Eyun 開發(fā)文檔平臺開通見 Eyun 官網。