小白教程：laravel结合easywechat发送公众号模板消息

时间：2021-12-14 15: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' => '点击打开小程序'
            ],
        ],
    ]);

效果图

发送微信公众号模板消息（未完成）