最近接到新需求,需要给关注服务号的用户发送模板消息,写个博客记录一下完成此次需求走过的路,扩展包使用的是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发送公众号模板消息的全部过程,完毕!