最近接到新需求,需要给关注服务号的用户发送模板消息,写个博客记录一下完成此次需求走过的路,扩展包使用的是easywechat
laravel结合easywechat发送公众号模板消息详细说明,感谢easywechat作者,对新手来说可太好用了!
因为我们情况比较特殊,小程序绑定的公众号和要推送的公众号不是同一个,这个就涉及到union_Id可能不一致的情况,因此需要将两个公众号都绑定到微信开放平台,如果没有,就去注册绑定
因为我这边是一个全新的公众号,所以步骤会比较小白
配置js安全域名
生成secret(主要要保存好,后续重置会影响已上线的业务)
填写并启用服务器配置
这里填写的服务器地址会用于后续收到公众号的各种事件回调,比如关注取消
本地调试需要做内网穿透,具体教程自己去搜吧我也不会
修改配置微信这边会验证填写的服务器地址是否能正常接收,所以会走一次验证需要接口给出正确返回参数
接入文档链接参考
因为微信的验证和后续的回调都会走这一个路由,验证为GET请求,后续的事件回调之类是post请求,因此需要将路由设为any类型
Route::any('official/notify', 'WechatController@officialNotify');
easywechat作者安正超老师为我们考虑了服务器验证 与 消息的接收与回复在一个链接的兼容,所以直接按照文档使用即可
public function officialNotify()
{
Log::channel('wechat')->info("公众号回调!!!!!1" );
$body = file_get_contents('php://input');
Log::channel('wechat')->info($body);
$config = [
'app_id' => config('wechat.yueliu_official_account.app_id'),
'secret' => config('wechat.yueliu_official_account.secret'),
'token' => config('wechat.yueliu_official_account.token'),
// 'aes_key' => config('wechat.yueliu_official_account.aes_key'), // 明文模式请勿填写 EncodingAESKey
'aes_key' => '', // 明文模式请勿填写 EncodingAESKey
'log' => [
'level' => 'error',
'file' => storage_path('logs/wechat.log'),
],
'response_type' => 'array'
];
$app = Factory::officialAccount($config);
$app->server->push(function ($message) {
Log::channel('wechat')->info($message);
switch ($message['MsgType']) {
case 'event':
return '收到事件消息';
break;
case 'text':
return '收到文本消息';
break;
case 'image':
return '收到图片消息';
break;
case 'voice':
return '收到语音消息';
break;
case 'video':
return '收到视频消息';
break;
case 'location':
return '收到坐标消息';
break;
case 'link':
return '收到链接消息';
break;
case 'file':
return '收到文件消息';
// ... 其它消息
default:
return '收到其它消息';
break;
}
});
// 在 laravel 中:
$response = $app->server->serve();
// $response 为 `Symfony\Component\HttpFoundation\Response` 实例
// 对于需要直接输出响应的框架,或者原生 PHP 环境下
$response->send();
// 而 laravel 中直接返回即可:
return $response;
}
我这边的业务需要,在用户关注后需要发送可以跳转小程序的消息给用户,这里需要在收到event消息后,判断是否是关注事件,然后将return的消息改为下面的代码即可,这里的a链接点击后可直接打开小程序,不会在问用户是否确认之类的提示
需要注意的是:关注公众号通过[$app->user->get($openId);]可以拿到unionid和一些基本信息,取消关注只能拿到openid
case 'event':
return '欢迎关注音视频资产管理与协同交付平台「laravel」官方微信。
<a data-miniprogram-appid="小程序的appid" data-miniprogram-path="小程序路径" href="备用网址" data-miniprogram-type="text">点击跳转</a>
网页版请至:
https://learnku.com';
break;
效果图
微信公众号的关注回调事件会将用户的基本信息和unionid也一并发送,一定要将公众号的openid和unionid存起来,后续发送模板消息会根据公众号的openid进行发送
在微信公众平台申请开通模板消息,在右侧菜单最下边“+新功能”找到模板消息,点击申请开通,大概需要1-3个工作日。我这边是1天就通过了
开通后,选择行业,选择模板类型,如果微信提供的模板库找不到和你业务一样的,那就需要自己去提交申请了,但是这个时间比较久,大概需要7-15天,建议还是用模板库的
这里的模板id要存在代码里,后续发送模板消息需要用到
下面就是根据业务需要,给用户发送模板消息了,代码如下
$openId = '公众号的openid';
$config = [
'app_id' => config('wechat.yueliu_official_account.app_id'),
'secret' => config('wechat.yueliu_official_account.secret'),
'token' => config('wechat.yueliu_official_account.token'),
// 'aes_key' => config('wechat.yueliu_official_account.aes_key'), // 明文模式请勿填写 EncodingAESKey
'aes_key' => '', // 明文模式请勿填写 EncodingAESKey
'log' => [
'level' => 'error',
'file' => storage_path('logs/wechat.log'),
],
'response_type' => 'array'
];
$app = Factory::officialAccount($config);
// $user = $app->user->get($openId);
// dd($user);
// 发送模板消息
$app->template_message->send([
'touser' => $openId,
'template_id' => '模板id',
'url' => 'http://www.网站.cn',
'miniprogram' => [ // 跳转到小程序,和上面的url同时存在的话,则优先显示小程序
'appid' => '小程序的id',
'pagepath' => '小程序页面地址',
],
'data' => [
'first' => [
'value' => '赵师傅已加入群组演示项目',
'color' => '#888888'
],
'keyword1' => [
'value' => '加入项目'
],
'keyword2' => [
'value' => '加入成功'
],
'keyword3' => [
'value' => '2021-12-10 14:21:05'
],
'remark' => [
'value' => '点击打开小程序'
],
],
]);
效果图
以上就是laravel结合easywechat发送公众号模板消息的全部过程,完毕!