EasyWechat 4.x 微信小程序订阅消息

2023-01-08 11:51:09 浏览数 (1)

1. 前言

EasyWechat 4.x 订阅消息文档: https://easywechat.com/docs/4.x/mini-program/subscribe_message

微信官方文档订阅消息:https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message.html

下发订阅消息官方文档(注意:订阅消息参数值内容限制):https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.send.html

2. 发送订阅消息

page 参数

点击模板卡片后的跳转页面,仅限本小程序内的页面。

站长源码网

支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转。

miniprogram_state 参数

跳转小程序类型 formal 正式版 trial 体验版 developer 开发版, 省略时默认为正式版

EasyWechat 订阅消息示例中并没有该参数,我是在微信订阅消息官方文档发现的,经测试,该参数可用

代码语言:javascript复制
$data = [
'template_id' => 'bDmywsp2oEHjwAadTGKxxxxxx', // 订阅消息模板id
'touser' => 'oSyZp5OBNPBRhG-7BVgWxbiNZm', // 接收者用户openid
'page' => 'pages/index/index', // 小程序页面路径
'data' => [ // 模板内容
'date01' => [
'value' => '2019-12-01',
],
'number01' => [
'value' => 10,
],
],
'miniprogram_state' => 'formal', // formal 正式版 trial 体验版 developer 开发版
];
// 返回数组
$result = $app->subscribe_message->send($data);

特别注意:模板id为空时会抛出异常而不是以返回值的形式返回,所以最好使用 try catch 捕获下错误

代码语言:javascript复制
try {
// 返回数组 模板id为空时抛出异常
$result = $app->subscribe_message->send($data);
} catch (Throwable $e) {
fault($e->getMessage());
}

发送成功

代码语言:javascript复制
[
"errcode" => 0,
"errmsg" => "ok",
"msgid" => 1888884277765816322,
]

判断是否发送成功

代码语言:javascript复制
if (isset($result['errcode']) && $result['errcode'] == 0 ) {
    // 发送成功
}
3. 发送失败时常见返回值

用户没有授权或授权的次数已用尽

代码语言:javascript复制
[
    "errcode" => 43101,
    "errmsg"  => "user refuse to accept the msg rid: 60b07a4d-07ed4b8e-286b09ae",
]

0 人点赞