小程序訂閱消息公測已經有些日子,今天以世界上最好的語言(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、授權接收
發送前需要接受者授權接收該類訂閱消息,否則訂閱消息是無法下發,代碼很簡單,調用官方的訂閱接口:
拉起的授權框是這樣的,但是截止發文之前,開發者工具是無法調用接口,只能在真機上運行,無奈。
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 模板關注公眾號,后台回復「訂閱消息」獲取。





