小程序卡片消息是聊天和 App 服務(wù)之間的橋——用戶在對話里點一下卡片直接落到小程序的具體頁面。它的工程要點在卡片參數(shù)怎么拼和落地頁怎么接。一、小程序卡片的結(jié)構(gòu)發(fā)送小程序消息的參數(shù)組合比鏈接消息復(fù)雜小程序的 appid、頁面路徑path決定落地到哪個頁面、標(biāo)題、縮略圖。其中頁面路徑是靈魂——同一個小程序路徑帶不帶訂單號參數(shù)用戶體驗天差地別。卡片發(fā)出去能不能正常打開取決于 appid 和路徑的正確性。程序發(fā)送前最好先驗證路徑模板渲染后的完整性——占位符沒填的路徑點開就是報錯頁。二、通知類場景——狀態(tài)變化帶直達(dá)入口訂單、預(yù)約、審批這類狀態(tài)通知配上小程序卡片就是通知直達(dá)用戶看到訂單已發(fā)貨點卡片直接進訂單詳情頁。比鏈接消息的優(yōu)勢在于免登錄——小程序內(nèi)通常已有登錄態(tài)用戶點開就能看不用再走一遍驗證。通知卡片的路徑參數(shù)設(shè)計路徑必須帶業(yè)務(wù)主鍵訂單號、預(yù)約 ID落地頁按參數(shù)渲染對應(yīng)數(shù)據(jù)。參數(shù)缺失或錯誤的路徑要在發(fā)送前攔截。三、服務(wù)引導(dǎo)場景——把功能送到對話里用戶在對話里問怎么查物流預(yù)約什么時候程序識別意圖后直接發(fā)對應(yīng)功能頁的卡片——查物流卡片、預(yù)約管理卡片。用戶不用自己找入口對話即服務(wù)。引導(dǎo)卡片的關(guān)鍵是意圖識別的準(zhǔn)確率——識別錯了推錯頁面用戶反而困惑。低置信度時寧可發(fā)文本問一句不硬推卡片。四、點擊數(shù)據(jù)回流小程序側(cè)埋點記錄卡片點擊和發(fā)送日志按用戶批次對賬就能算出每類卡片的打開率。打開率低的通知卡片換標(biāo)題和縮略圖測試打開率持續(xù)低的服務(wù)引導(dǎo)檢查意圖識別邏輯。小程序消息場景對照場景路徑特點發(fā)送時機優(yōu)化指標(biāo)狀態(tài)通知帶業(yè)務(wù)主鍵參數(shù)事件觸發(fā)打開率功能引導(dǎo)固定功能頁意圖識別觸發(fā)意圖準(zhǔn)確率活動推廣活動頁渠道參數(shù)活動周期轉(zhuǎn)化率小程序卡片發(fā)送實現(xiàn)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, 路徑參數(shù)缺失 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}落地建議小程序消息先跑通通知類場景——路徑參數(shù)固定、觸發(fā)事件明確最容易標(biāo)準(zhǔn)化。功能引導(dǎo)類依賴意圖識別放第二步。所有卡片發(fā)送前做路徑校驗發(fā)送后記錄日志和對賬打開率形成優(yōu)化閉環(huán)。小程序消息接口參數(shù)說明參考 Eyun 開發(fā)文檔平臺開通見 Eyun 官網(wǎng)。