微信公众号推送消息笔记

原创

stark张宇

修改于 2024-07-23 12:19:52

1590

修改于 2024-07-23 12:19:52

文章被收录于专栏：stark张宇

根据业务需要，开发一个微信公众号的相关开发，根据相关开发和整理总结了一下相关的流程和需要，进行一些整理和总结分享给大家，最近都在加班和忙碌，博客已经很久未更新了，打气精神，再接再厉，申请、认证公众号的一系列流程就不在这里赘述了，主要进行的是技术的分享，要达到的效果如下图:

设置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 返回结构如下:

{
    "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即当前用户。

{
    "signature": "d43a23e838e2b580ca41babc78d5fe78b2993dea",
    "timestamp": "1721273358",
    "nonce": "1149757628",
    "openid": "odhkK64I1uXqoUQjt7QYx4O0yUvs"
}

用户进行相关操作时，回调接口会收到这样一份请求,都是用MsgType和Event去区分,下面是关注的回调：

{
    "ToUserName": "gh_d98fc9c8e089",
    "FromUserName": "用户openID",
    "CreateTime": "1721357413",
    "MsgType": "event",
    "Event": "subscribe",
    "EventKey": []
}

下面是点击菜单跳转的回调：

{
    "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>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>12345678</CreateTime>
  <MsgType><![CDATA[text]]></MsgType>
  <Content><![CDATA[你好]]></Content>
</xml>

在php代码里的实现即为：

protected function subscribe($params)
{
    $time = time();
    $content = "欢迎文字";
    $send_msg = '<xml>
            <ToUserName><![CDATA['.$params['FromUserName'].']]></ToUserName>
            <FromUserName><![CDATA['.$params['ToUserName'].']]></FromUserName>
            <CreateTime>'.time().'</CreateTime>
            <MsgType><![CDATA[text]]></MsgType>
            <Content><![CDATA['.$content.']]></Content>
        </xml>';

    echo $send_msg;
    return false;
}

模板推送能力

模版推送的两个关键是申请了模版，还有就是模版的data需要和模版中的一致，才能成功发送，模版设置和申请的后台位置在 广告与服务-模版消息

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地址加入白名单即可。

{
    "errcode": 40164,
    "errmsg": "invalid ip 47.63.30.93 ipv6 ::ffff:47.63.30.93, not in whitelist rid: 6698ef60-27d10c40-100819f9"
}

2、模版参数不正确时，接口返回

{
    "errcode": 47003,
    "errmsg": "argument invalid! data.time5.value invalid rid: 669df26e-538a8a1a-15ab8ba4"
}

3、access_token不正确

{
    "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超过调用次数

{
    "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"
}

文档参考

公众号开发文档首页: https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Overview.html

分享一个微信公众号的调试工具地址，特别好用： https://mp.weixin.qq.com/debug/

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

微信公众号开发

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

微信公众号开发

登录后参与评论

0 条评论

热度