一、目的php
完成在微信公众号中群发消息。这里只是完成简单的文字发送。也能够发送语音图片等,只是发送数据格式不一样而已,下面有连接,能够查询数据类型的数据发送格式。html
二、群发短信的流程json
三、获取测试公众帐号 + 关注公众号api
1)、公众测试帐号获取安全
访问上面的链接,选择“接口测试号申请”得到直接打开http://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index经过微信客户端扫码登陆便可登陆。服务器
登陆完便可获取到一个测试公众帐号的信息。主要有appId和appsecret两个参数,这将惟一标示一个公众号,而且须要将他们做为参数获取用户的信息。、微信
2)、配置接口信息微信开发
这一步能够参照微信接入说明 ,该页提供一个php的实例下载,很简单基本上修改一下自定义的TOKEN就行了,而后把验证页面放到本身的服务器上。app
这里我提供我作的一个例子:微信公众平台
准备资源:
域名+空间(个人是sae空间+万网域名)、仅做验证的php文件
域名指向的空间根目录我建立了一个wx_sample.php
wx_sample.php
<?php /** * wechat php test */ //define your token define("TOKEN", "weixin"); $wechatObj = new wechatCallbackapiTest(); $wechatObj->valid(); class wechatCallbackapiTest { public function valid() { $echoStr = $_GET["echostr"]; //valid signature , option if($this->checkSignature()){ echo $echoStr; exit; } } public function responseMsg() { //get post data, May be due to the different environments $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; //extract post data if (!empty($postStr)){ /* libxml_disable_entity_loader is to prevent XML eXternal Entity Injection, the best way is to check the validity of xml by yourself */ libxml_disable_entity_loader(true); $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA); $fromUsername = $postObj->FromUserName; $toUsername = $postObj->ToUserName; $keyword = trim($postObj->Content); $time = time(); $textTpl = "<xml> <ToUserName><![CDATA[%s]]></ToUserName> <FromUserName><![CDATA[%s]]></FromUserName> <CreateTime>%s</CreateTime> <MsgType><![CDATA[%s]]></MsgType> <Content><![CDATA[%s]]></Content> <FuncFlag>0</FuncFlag> </xml>"; if(!empty( $keyword )) { $msgType = "text"; $contentStr = "Welcome to wechat world!"; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); echo $resultStr; }else{ echo "Input something..."; } }else { echo ""; exit; } } private function checkSignature() { // you must define TOKEN by yourself if (!defined("TOKEN")) { throw new Exception('TOKEN is not defined!'); } $signature = $_GET["signature"]; $timestamp = $_GET["timestamp"]; $nonce = $_GET["nonce"]; $token = TOKEN; $tmpArr = array($token, $timestamp, $nonce); // use SORT_STRING rule sort($tmpArr, SORT_STRING); $tmpStr = implode( $tmpArr ); $tmpStr = sha1( $tmpStr ); if( $tmpStr == $signature ){ return true; }else{ return false; } } } ?>
而后填写配置信息Token (必定要与上面的wx_sample.php中的token一致)、URL(wx_sample.php的地址)
而后提交就能够了
若是提示失败,请检查Token与URL【若是是本身的域名和空间,请备案; 百度sae、新浪sae的须要本身申请并且认证经过(就是本身拍一个手握证件照上传,很简单的 最短2天就o了),这一步必须】
3)配置JS接口安全域名
填这个域名是必定不要带protocol的,好比说 http://www.sagosoft.com/ 这样是不对的,这是URL不是域名
域名应该是相似 www.sagosoft.com这样的 【不然在微信js-sdk接入时会提示invalid url domain】
4)关注公众号
用户只有关注了这个公众号了,才能经过打开有公众号信息的连接去受权第三方登陆,并获取用户信息的操做。故咱们还须要用咱们的微信关注微信号,操做以下:
5)配置回调函数
咱们在微信客户端访问第三方网页(即咱们本身的网页)的时候,咱们能够经过微信网页受权机制,咱们不只要有前面获取到的appid和appsecret还须要有当用户受权以后,回调的域名设置,即用户受权后,页面会跳转到哪里。具体的配置以下:
仍是在刚刚的页面,有一个“网页受权获取用户基本信息”,点击后面的修改
填写回调的域名:
域名是上面配置的根域名,假如你上面 “接口配置信息” 填写的url 为zcr.sinaaappc.com/wx_sample.php,这里只要填写zcr.sinaaappc.com 就能够了。
若是你的网址没有被列入过黑名单,就会在顶部出现
注意:
一、这里填写的是域名(是一个字符串),而不是URL,所以请勿加http://等协议头; 二、受权回调域名配置规范为全域名,好比须要网页受权的域名为:www.qq.com,配置之后此域名下面的页面http://www.qq.com/music.html 、 http://www.qq.com/login.html 均可以进行OAuth2.0鉴权。但http://pay.qq.com 、 http://music.qq.com 、 http://qq.com没法进行OAuth2.0鉴权
到这里,咱们就完成了公众号测试帐号的获取和配置,已经用户关注微信公众号。
四、经过appid和appsecret获取咱们的access_token
access_token是公众号的全局惟一票据,公众号调用各接口时都需使用access_token。开发者须要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时,需定时刷新,重复获取将致使上次获取的access_token失效。
获取方法:
http请求方式: GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
参数说明
参数 | 是否必须 | 说明 |
---|---|---|
grant_type | 是 | 获取access_token填写client_credential |
appid | 是 | 第三方用户惟一凭证 |
secret | 是 | 第三方用户惟一凭证密钥,即appsecret |
返回说明
正常状况下,微信会返回下述JSON数据包给公众号:
{"access_token":"ACCESS_TOKEN","expires_in":7200}
参数 | 说明 |
---|---|
access_token | 获取到的凭证 |
expires_in | 凭证有效时间,单位:秒 |
错误时微信会返回错误码等信息,JSON数据包示例以下(该示例为AppID无效错误):
{"errcode":40013,"errmsg":"invalid appid"}
例子:
获取access_token:
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=wx4d1cb8dbd827a16e9&secret=d462d4c36b116795d1d99dcf0547af5443d
返回数据:
{ "access_token": "qR5UK2vMf5aTHV8e-uB10FZW0caTZm_1kbkUe4OPK2ILVvNaoa7pLzYWqLUAmx6Sjq1E7pKHrVAtuG0_1MPkqmDfOkm2750kaLWNk59DS-iDOpjjxompJtXa3WhbN5FKRWNhADAVAR", "expires_in": 7200 }
五、经过access_token群发短信
在公众平台网站上,为订阅号提供了天天一条的群发权限,为服务号提供每个月(天然月)4条的群发权限。而对于某些具有开发能力的公众号运营者,能够经过高级群发接口,实现更灵活的群发能力。
请注意:
1、对于认证订阅号,群发接口天天可成功调用1次,这次群发可选择发送给所有用户或某个分组; 2、对于认证服务号虽然开发者使用高级群发接口的每日调用限制为100次,可是用户每个月只能接收4条,不管在公众平台网站上,仍是使用接口群发,用户每个月只能接收4条群发消息,多于4条的群发将对该用户发送失败; 三、具有微信支付权限的公众号,在使用群发接口上传、群发图文消息类型时,可以使用<a>标签加入外链; 四、开发者可使用预览接口校对消息样式和排版,经过预览接口可发送编辑好的消息给指定用户校验效果。
1)根据分组进行群发【订阅号与服务号认证后都可用】
调用接口:
http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN
在body添加以下数据(以JSON格式数据发送)——发送其余格式数据,只须要改里面参数信息便可,具体可查看微信官方文档:
{ "filter":{ "is_to_all":false, "group_id":2 }, "text":{ "content":"CONTENT" }, "msgtype":"text" }
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
filter | 是 | 用于设定图文消息的接收者 |
is_to_all | 否 | 用于设定是否向所有用户发送,值为true或false,选择true该消息群发给全部用户,选择false可根据group_id发送给指定群组的用户 |
group_id | 否 | 群发到的分组的group_id,参加用户管理中用户分组接口,若is_to_all值为true,可不填写group_id |
mpnews | 是 | 用于设定即将发送的图文消息 |
media_id | 是 | 用于群发的消息的media_id |
msgtype | 是 | 群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,音乐为music,图片为image,视频为video,卡券为wxcard |
title | 否 | 消息的标题 |
description | 否 | 消息的描述 |
thumb_media_id | 是 | 视频缩略图的媒体ID |
例子:发送给全部人
url:
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=KBoNONaJZ4-KhafQVJoQ6VBX0F-bls7nAsJBn8Fy7GLwav4Be1lRJcob1RHH6wW35IxxFwkJnZfnc-On9EQITg3oxEWUw7O2YyVW9naDknu6PQX9fnSmQcr8ojTK8Ug-HDTcAAABXN
发送的json数据:发送给全部人
{ "filter":{ "is_to_all":true }, "text":{ "content":"CONTENT" }, "msgtype":"text" }
返回数据:
{ "errcode": 0, "errmsg": "send job submission success", "msg_id": 1000000003 }
参数意义:
参数 | 说明 |
---|---|
type | 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb),图文消息为news |
errcode | 错误码 |
errmsg | 错误信息 |
msg_id | 消息发送任务的ID |
msg_data_id | 消息的数据ID,该字段只有在群发图文消息时,才会出现。能够用于在图文分析数据接口中,获取到对应的图文消息的数据,是图文分析数据接口中的msgid字段中的前半部分,详见图文分析数据接口中的msgid字段的介绍。 |
错误码及其以及查询:
使用postman模拟https请求发送以下图所示:
2)根据OpenID列表群发【订阅号不可用,服务号认证后可用】
发送的http请求url:(注意:和上面的不一样)
http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN
数据格式:
{ "touser":[ "OPENID1", "OPENID2" ], "msgtype": "text", "text": { "content": "hello from boxer."} }
其中 OPENID1和OPENID2是咱们要发送的微信用户openId(用户的惟一标示)。
例子:
发送"oF3PcsnsrMiJzEwalZZbAfWQpxCI","oF3PcshH1CUIhR_WYau6swUiPzlw" 两个用户。
内容为:hello from boxer.<a href='www.baidu.com'>欢迎来到百度</a>
url:
https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=wRyTbnsiu18ssEhMPLf4bDfeT-Bt6e6tgR4CQGVLBipRcyJPkdAKPYfM6-qkKuHUN8uRKJh6Xvm0OuAdFgqOo8Ru8hoDxl-cGc9bh-ezJb2ZUcJSnQk2s416zI8kbEOfOGYdAFARJB
json数据:
{ "touser":[ "oF3PcsnsrMiJzEwalZZbAfWQpxCI", "oF3PcshH1CUIhR_WYau6swUiPzlw" ], "msgtype": "text", "text": { "content": "hello from boxer.<a href='http://www.seewoedu.com/'>欢迎希沃学院</a>"} }
返回数据:
{ "errcode": 0, "errmsg": "send job submission success", "msg_id": 3147483654 }
使用postman模拟发送请求以下:
微信号接收到的内容:
相关微信开发:
致谢:感谢您的阅读!转文请加上原文连接。谢谢! 接外包开发