根据业务需要，开发一个微信公众号的相关开发，根据相关开发和整理总结了一下相关的流程和需要，进行一些整理和总结分享给大家，最近都在加班和忙碌，博客已经很久未更新了，打气精神，再接再厉，申请、认证公众号的一系列流程就不在这里赘述了，主要进行的是技术的分享，要达到的效果如下图: ![999999.png](https://p6-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/4a295ae99d2d403897df1d418785b5c9~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgc3RhcmvlvKDlroc=:q75.awebp?rk3s=f64ab15b&x-expires=1771798541&x-signature=gHgsX%2FY%2B%2BfBXeGPdEmVyIl9t22k%3D) ### 开发接入首先说明我这里用的是PHP开发语言来进行的接入，设置一个url让微信公众号的服务回调这个url,在绑定之前需要一个token的验证，设置不对会提示token不正确的提示官方提供的测试Url工具：https://developers.weixin.qq.com/apiExplorer?type=messagePush ```php private function checkSignature() { $signature = isset($_GET["signature"]) ? $_GET["signature"] : ''; $timestamp = isset($_GET["timestamp"]) ? $_GET["timestamp"] : ''; $nonce = isset($_GET["nonce"]) ? $_GET["nonce"] : ''; $echostr = isset($_GET["echostr"]) ? $_GET["echostr"] : ''; $token = 'klsg2024'; $tmpArr = array($token, $timestamp, $nonce); sort($tmpArr, SORT_STRING); $tmpStr = implode( $tmpArr ); $tmpStr = sha1( $tmpStr ); if( $tmpStr == $signature ){ return $echostr; }else{ return false; } } ``` 在设置的地方调用: 微信公众号的 $echostr 和自定义的匹配上说明调用成功了 ``` public function console(){ //关注公众号推送 $posts = $this->posts; if(!isset($_GET['openid'])){ $res = $this->checkSignature(); if($res){ echo $res; return true; }else{ return false; } } } ``` ### 设置access\_token 公众号的开发的所有操作的前提都是先设置access\_token，在于验证操作的合法性，所需要的token在公众号后台的目录中获取:**公众号-设置与开发-基本设置** 设置和查看： #POST https://api.weixin.qq.com/cgi-bin/token { "grant_type": "client_credential", "appid": "开发者ID(AppID)", "secret": "开发者密码(AppSecret)" } 返回的access_token，过期时间2个小时，Http url 返回结构如下: ```json { "access_token": "82_W8kdIcY2TDBJk6b1VAGEmA_X_DLQnCIi5oSZBxVQrn27VWL7kmUCJFVr8tjO0S6TKuHlqM6z23nzwf18W1gix3RHCw6uXKAXlD-pZEO7JcAV6Xgk3orZW0i2MFMNGQbAEARKU", "expires_in": 7200 } ``` 为了方便起见,公众号平台还开放了一个稳定版的access_token,参数略微有不同。 ``` POST https://api.weixin.qq.com/cgi-bin/stable_token { "grant_type": "client_credential", "appid": "开发者ID(AppID)", "secret": "开发者密码(AppSecret)", "force_refresh":true } ``` ### 自定义菜单第一个疑惑是公众号里的底部菜单是怎么搞出来的，在官方文档中获取到的，如果公众号后台没有设置可以根据自定义菜单来进行设置。 1、创建菜单，参数自己去官方文档上查阅 ``` POST https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN ``` 2、查询菜单接口,文档和调试工具给的有点不一样，我使用的是调试工具给出的url ``` GET https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN ``` 3、删除菜单 ``` GET https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN ``` ### 事件拦截在公众号的开发后台里会设置一个Url，每次在操作公众号时都会回调接口，用事件去调用和处理，操作公众号后，微信公众平台会请求到设置的接口上,公众号的openid 比较重要，是用来识别用户身份的唯一标识，openid即当前用户。 ```json { "signature": "d43a23e838e2b580ca41babc78d5fe78b2993dea", "timestamp": "1721273358", "nonce": "1149757628", "openid": "odhkK64I1uXqoUQjt7QYx4O0yUvs" } ``` 用户进行相关操作时，回调接口会收到这样一份请求,都是用MsgType和Event去区分,下面是关注的回调： ```json { "ToUserName": "gh_d98fc9c8e089", "FromUserName": "用户openID", "CreateTime": "1721357413", "MsgType": "event", "Event": "subscribe", "EventKey": [] } ``` 下面是点击菜单跳转的回调： ```json { "ToUserName": "gh_d98fc9c8e089", "FromUserName": "用户openID", "CreateTime": "1721381657", "MsgType": "event", "Event": "VIEW", "EventKey": "https:\/\/zhjy.rchang.cn\/api\/project_audit\/getOpenid?type=1", "MenuId": "421351906" } ``` ### 消息推送消息能力是公众号中最核心的能力，我们这次主要分享2个，被动回复用户消息和模板推送能力。 #### 被动回复用户消息被动回复用户消息，把需要的参数拼接成xml格式的，我觉得主要是出于安全上的考虑作为出发点。 ```xml 12345678 ``` 在php代码里的实现即为： ```php protected function subscribe($params) { $time = time(); $content = "欢迎的文字"; $send_msg = ' '.time().' '; echo $send_msg; return false; } ``` #### 模板推送能力模版推送的两个关键是申请了模版，还有就是模版的data需要和模版中的一致，才能成功发送，模版设置和申请的后台位置在 **广告与服务-模版消息** ```php public function project_message() { $touser = '发送人公众号openid'; $template_id = '模版ID'; $url = 'https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=' . $this->access_token; $details_url = '点开链接，需要跳转的详情url'; $thing1 = '模版里定义的参数'; $time2 = '模版里定义的参数'; $const3 = '模版里定义的参数'; $send_data = [ 'touser' => $touser, 'template_id' => $template_id, 'url' => $details_url, 'data' => [ 'thing1' => ['value' => $thing1], 'time2' => ['value' => $time2], 'const3' => ['value' => $const3], ] ]; $result = curl_json($url, $send_data); } ``` ### 错误及解决方式 1、公众号后台: 设置与开发-安全中心-IP白名单把IP地址加入白名单即可。 ```json { "errcode": 40164, "errmsg": "invalid ip 47.63.30.93 ipv6 ::ffff:47.63.30.93, not in whitelist rid: 6698ef60-27d10c40-100819f9" } ``` 2、模版参数不正确时，接口返回 ```json { "errcode": 47003, "errmsg": "argument invalid! data.time5.value invalid rid: 669df26e-538a8a1a-15ab8ba4" } ``` 3、access_token不正确 ```json { "errcode": 40001, "errmsg": "invalid credential, access_token is invalid or not latest, could get access_token by getStableAccessToken, more details at https://mmbizurl.cn/s/JtxxFh33r rid: 669df2f1-74be87a6-05e77d20" } ``` 4、access_token超过调用次数 ```json { "errcode": 45009, "errmsg": "reach max api daily quota limit, could get access_token by getStableAccessToken, more details at https:\/\/mmbizurl.cn\/s\/JtxxFh33r rid: 669e5c4c-2bb4e05f-61d6917c" } ``` ### 文档参考公众号开发文档首页: 分享一个微信公众号的调试工具地址，特别好用：