小程式訂閱消息公測已經有些日子,今天以世界上最好的語言(PHP)為例,說一下如何發送訂閱消息。 1、訂閱消息 其實如果用過模板消息的話,改用訂閱消息挺簡單的,看一下官方文檔稍加摸索就能使用。 但是對於那些第一次用的萌新來說,可能會遇到各種各樣的坑,所以我會具體的說一下實現的過程,有經驗的可以直接翻到 ...
小程式訂閱消息公測已經有些日子,今天以世界上最好的語言(PHP)為例,說一下如何發送訂閱消息。
1、訂閱消息
其實如果用過模板消息的話,改用訂閱消息挺簡單的,看一下官方文檔稍加摸索就能使用。
但是對於那些第一次用的萌新來說,可能會遇到各種各樣的坑,所以我會具體的說一下實現的過程,有經驗的可以直接翻到文章底部查看 Demo。
雖然如此,但是更詳細的參數描述還是需要去看官方文檔,傳送門:
https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message.html
2、準備工作
首先是要獲取template_id,也就是模板 ID。
這個在小程式後臺的公共模板庫找到適用的模板選用,之後到我的模板中複製系統分配的模板 ID即可。如果沒找到合適的,就需要自己申請模板,3 - 7 天審核期。
然後就是小程式的 AppId 和 AppSecret,獲取方式在小程式後臺的開發功能中找到開發設置,保存 ID 和秘鑰。
這裡需要註意的是AppSecret只有在第一次生成的時候會顯示,之後不再明文顯示,這個需要開發者自己保存好,如果泄露或者忘記密匙重置即可。
至於 openid 的獲取這裡就不做具體說明瞭。
3、授權接收
發送前需要接受者授權接收該類訂閱消息,否則訂閱消息是無法下發,代碼很簡單,調用官方的訂閱介面:
wx.requestSubscribeMessage({ tmplIds: ['template_id'], // 此處可填寫多個模板 ID,但低版本微信不相容只能授權一個 success (res) { console.log('已授權接收訂閱消息') } })
拉起的授權框是這樣的,但是截止發文之前,開發者工具是無法調用介面,只能在真機上運行,無奈。
4、下發訂閱消息
下發消息調用subscribeMessage.send ,分為雲調用和 https 調用,雲調用比較簡單,免去了 access_token 的獲取:
const cloud = require('wx-server-sdk') cloud.init() exports.main = async (event, context) => { try { const result = await cloud.openapi.subscribeMessage.send({ touser: 'OPENID', page: 'index', data: { name3: { value: '我是玖柒後' }, thing4: { value: 'Hello World!' }, phrase1: { value: "發送成功!" }, date5: { value: "發送成功!" }, thing2: { value: "1024 身體健康!" } }, templateId: 'TEMPLATE_ID' }) console.log(result) return result } catch (err) { console.log(err) return err } }
然後在伺服器端發起請求,請求地址:
https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=token
在這之前先獲取小程式全局唯一後臺介面調用憑據(access_token),這就用到了之前保存的 AppId 和 AppSecret。
// 小程式 appID 和 appSecret 獲取 token function getAccessToken($appid, $appsecret) { $url = 'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=' . $appid . '&secret=' . $appsecret; $html = file_get_contents($url); $output = json_decode($html, true); $access_token = $output['access_token']; return $access_token; }
雖然看起來稍微有點複雜,但其實也只要向伺服器發送一個請求就可以了,獲取和調用都由伺服器處理,收到的消息和模板消息差不多。
PHP 訂閱消息完整的 API 模板關註公眾號,後臺回覆「訂閱消息」獲取。