laravel发送微信公众号模板消息

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