微信公众平台开发——群发信息

秒速五厘米 2022-05-27 14:10 280阅读 0赞

1、目的

完成在微信公众号中群发消息。这里只是完成简单的**文字发送**。也可以发送语音图片等，只是发送数据格式不同而已，下面有链接，可以查询数据类型的数据发送格式。

2、群发短信的流程

1.  获取测试公众账号（有账号的可以不用测试账号，不过正式的账号限制比较多）
2.  用户关注上面的公众账号
3.  通过appid和appsecret获取我们的access\_token
4.  通过access\_token群发短信

3、获取测试公众账号 + 关注公众号

1）、公众测试账号获取

访问上面的连接，选择“接口测试号申请”获得直接打开[http://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index][http_mp.weixin.qq.com_debug_cgi-bin_sandboxinfo_action_showinfo_t_sandbox_index]通过微信客户端扫码登录即可登录。

登录完即可获取到一个测试公众账号的信息。主要有appId和appsecret两个参数，这将唯一标示一个公众号，并且需要将他们作为参数获取用户的信息。、

![731178-20160913090340992-695210995.png][]

2）、配置接口信息

这一步可以参照[微信接入说明][Link 1] ，该页提供一个php的实例下载，很简单基本上修改一下自定义的TOKEN就好了，然后把验证页面放到自己的服务器上。

这里我提供我做的一个例子：

准备资源：

域名+空间（我的是sae空间+万网域名）、仅作验证的php文件

域名指向的空间根目录我创建了一个wx\_sample.php

wx\_sample.php

![复制代码][copycode.gif]

<?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;
            }
        }
    }
    
    ?>

![复制代码][copycode.gif]

然后填写配置信息Token （一定要与上面的wx\_sample.php中的token一致）、URL（wx\_sample.php的地址）

![731178-20160913091159367-521040156.png][]

然后提交就可以了

如果提示失败，请检查Token与URL【如果是自己的域名和空间，请备案； 百度sae、新浪sae的需要自己申请而且认证通过（就是自己拍一个手握证件照上传，很简单的 最短2天就o了），这一步必须】

3）配置JS接口安全域名

填这个域名是一定不要带protocol的，比如说 http://www.sagosoft.com/   这样是不对的,这是URL不是域名

域名应该是类似 www.sagosoft.com这样的 【否则在微信js-sdk接入时会提示invalid url domain】

![731178-20160913091519555-1829562453.png][]

4）关注公众号

用户只有关注了这个公众号了，才能通过打开有公众号信息的链接去授权第三方登录，并获取用户信息的操作。故我们还需要用我们的微信关注微信号，操作如下：

还是刚刚那个登录成功后跳转的页面，我们可以看到，该页面有一个二维码，我们可以通过扫描该二维码进行关注，关注成功在右边的“用户列表”会多一个用户的信息。如下图所示：

![731178-20160913091659336-1726147628.png][]

5）配置回调函数

我们在微信客户端访问第三方网页（即我们自己的网页）的时候，我们可以通过微信网页授权机制，我们不仅要有前面获取到的appid和appsecret还需要有当用户授权之后，回调的域名设置，即用户授权后，页面会跳转到哪里。具体的配置如下：

还是在刚刚的页面，有一个“网页授权获取用户基本信息”，点击后面的修改

![731178-20160913091845648-216859397.png][]

填写回调的域名：

域名是上面配置的根域名，假如你上面 “接口配置信息” 填写的url 为zcr.sinaaappc.com/wx\_sample.php,这里只要填写zcr.sinaaappc.com  就可以了。

![731178-20160913092014586-102528969.png][]

如果你的网址没有被列入过黑名单，就会在顶部出现

![731178-20160913092002992-276930192.png][]

![731178-20160913092045852-1184156168.png][]

**注意**：

1、这里填写的是域名（是一个字符串），而不是URL，因此请勿加http://等协议头；
    2、授权回调域名配置规范为全域名，比如需要网页授权的域名为：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鉴权

到这里，我们就完成了公众号测试账号的获取和配置，已经用户关注微信公众号。

4、通过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

**参数说明**

<table style="width:640px;"> 
 <tbody> 
  <tr> 
   <th>参数</th> 
   <th>是否必须</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td>grant_type</td> 
   <td>是</td> 
   <td>获取access_token填写client_credential</td> 
  </tr> 
  <tr> 
   <td>appid</td> 
   <td>是</td> 
   <td>第三方用户唯一凭证</td> 
  </tr> 
  <tr> 
   <td>secret</td> 
   <td>是</td> 
   <td>第三方用户唯一凭证密钥，即appsecret</td> 
  </tr> 
 </tbody> 
</table>

**返回说明**

正常情况下，微信会返回下述JSON数据包给公众号：

{"access_token":"ACCESS_TOKEN","expires_in":7200}

<table style="width:640px;"> 
 <tbody> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td>access_token</td> 
   <td>获取到的凭证</td> 
  </tr> 
  <tr> 
   <td>expires_in</td> 
   <td>凭证有效时间，单位：秒</td> 
  </tr> 
 </tbody> 
</table>

错误时微信会返回错误码等信息，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
    }

5、通过access\_token群发短信

在公众平台网站上，为订阅号提供了每天一条的群发权限，为服务号提供每月（自然月）4条的群发权限。而对于某些具备开发能力的公众号运营者，可以通过高级群发接口，实现更灵活的群发能力。[**微信拓客软件**][Link 2]

请注意：

1、对于认证订阅号，群发接口每天可成功调用1次，此次群发可选择发送给全部用户或某个分组；
    2、对于认证服务号虽然开发者使用高级群发接口的每日调用限制为100次，但是用户每月只能接收4条，无论在公众平台网站上，还是使用接口群发，用户每月只能接收4条群发消息，多于4条的群发将对该用户发送失败；
    3、具备微信支付权限的公众号，在使用群发接口上传、群发图文消息类型时，可使用<a>标签加入外链；
    4、开发者可以使用预览接口校对消息样式和排版，通过预览接口可发送编辑好的消息给指定用户校验效果。

1）根据分组进行群发【订阅号与服务号认证后均可用】

调用接口：

http请求方式: POST
    https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN

在body添加如下数据（以JSON格式数据发送）——发送其他格式数据，只需要改里面参数信息即可，具体可查看[微信官方文档][Link 3]：

![复制代码][copycode.gif]

{
       "filter":{
          "is_to_all":false,
          "group_id":2
       },
       "text":{
          "content":"CONTENT"
       },
        "msgtype":"text"
    }

![复制代码][copycode.gif]

参数说明：

<table style="width:640px;"> 
 <tbody> 
  <tr> 
   <th>参数</th> 
   <th>是否必须</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td>filter</td> 
   <td>是</td> 
   <td>用于设定图文消息的接收者</td> 
  </tr> 
  <tr> 
   <td>is_to_all</td> 
   <td>否</td> 
   <td>用于设定是否向全部用户发送，值为true或false，选择true该消息群发给所有用户，选择false可根据group_id发送给指定群组的用户</td> 
  </tr> 
  <tr> 
   <td>group_id</td> 
   <td>否</td> 
   <td>群发到的分组的group_id，参加用户管理中用户分组接口，若is_to_all值为true，可不填写group_id</td> 
  </tr> 
  <tr> 
   <td>mpnews</td> 
   <td>是</td> 
   <td>用于设定即将发送的图文消息</td> 
  </tr> 
  <tr> 
   <td>media_id</td> 
   <td>是</td> 
   <td>用于群发的消息的media_id</td> 
  </tr> 
  <tr> 
   <td>msgtype</td> 
   <td>是</td> 
   <td>群发的消息类型，图文消息为mpnews，文本消息为text，语音为voice，音乐为music，图片为image，视频为video，卡券为wxcard</td> 
  </tr> 
  <tr> 
   <td>title</td> 
   <td>否</td> 
   <td>消息的标题</td> 
  </tr> 
  <tr> 
   <td>description</td> 
   <td>否</td> 
   <td>消息的描述</td> 
  </tr> 
  <tr> 
   <td>thumb_media_id</td> 
   <td>是</td> 
   <td>视频缩略图的媒体ID</td> 
  </tr> 
 </tbody> 
</table>

**例子：发送给所有人**

url：

https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=KBoNONaJZ4-KhafQVJoQ6VBX0F-bls7nAsJBn8Fy7GLwav4Be1lRJcob1RHH6wW35IxxFwkJnZfnc-On9EQITg3oxEWUw7O2YyVW9naDknu6PQX9fnSmQcr8ojTK8Ug-HDTcAAABXN

发送的json数据：发送给所有人

![复制代码][copycode.gif]

{
       "filter":{
          "is_to_all":true
       },
       "text":{
          "content":"CONTENT"
       },
        "msgtype":"text"
    }

![复制代码][copycode.gif]

返回数据：

{
      "errcode": 0,
      "errmsg": "send job submission success",
      "msg_id": 1000000003
    }

参数意义：

<table style="width:640px;"> 
 <tbody> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td>type</td> 
   <td>媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb），图文消息为news</td> 
  </tr> 
  <tr> 
   <td>errcode</td> 
   <td>错误码</td> 
  </tr> 
  <tr> 
   <td>errmsg</td> 
   <td>错误信息</td> 
  </tr> 
  <tr> 
   <td>msg_id</td> 
   <td>消息发送任务的ID</td> 
  </tr> 
  <tr> 
   <td>msg_data_id</td> 
   <td>消息的数据ID，该字段只有在群发图文消息时，才会出现。可以用于在图文分析数据接口中，获取到对应的图文消息的数据，是图文分析数据接口中的msgid字段中的前半部分，详见图文分析数据接口中的msgid字段的介绍。<br></td> 
  </tr> 
 </tbody> 
</table>

错误码及其以及查询：

[全局错误码解析][Link 4]

使用postman模拟https请求发送如下图所示：

![731178-20160913094023352-1075966058.png][]

2）根据OpenID列表群发【订阅号不可用，服务号认证后可用】

发送的http请求url：（注意：和上面的不同）

http请求方式: POST
    https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN

数据格式：

![复制代码][copycode.gif]

{
       "touser":[
        "OPENID1",
        "OPENID2"
       ],
        "msgtype": "text",
        "text": { "content": "hello from boxer."}
    }

![复制代码][copycode.gif]

其中 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数据：

![复制代码][copycode.gif]

{
       "touser":[
        "oF3PcsnsrMiJzEwalZZbAfWQpxCI",
        "oF3PcshH1CUIhR_WYau6swUiPzlw"
       ],
       "msgtype": "text",
        "text": { "content": "hello from boxer.<a href='http://www.seewoedu.com/'>欢迎希沃学院</a>"}
    }

![复制代码][copycode.gif]

返回数据:

{
      "errcode": 0,
      "errmsg": "send job submission success",
      "msg_id": 3147483654
    }

使用postman模拟发送请求如下：

![731178-20160913095146039-756573267.png][]

微信号接收到的内容：

![731178-20160913095255008-445120913.jpg][]

相关微信开发：[**微信好友列表获取 **][Link 2]  [微信群发][Link 2]

[http_mp.weixin.qq.com_debug_cgi-bin_sandboxinfo_action_showinfo_t_sandbox_index]: http://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index
[731178-20160913090340992-695210995.png]: /images/20220527/80cf4bc8362f49c6b374ee3d3a02b26b.png
[Link 1]: http://mp.weixin.qq.com/wiki/17/2d4265491f12608cd170a95559800f2d.html#.E7.AC.AC.E4.BA.8C.E6.AD.A5.EF.BC.9A.E9.AA.8C.E8.AF.81.E6.9C.8D.E5.8A.A1.E5.99.A8.E5.9C.B0.E5.9D.80.E7.9A.84.E6.9C.89.E6.95.88.E6.80.A7
[copycode.gif]: /images/20220527/1099f73e14d841a09a0db715e4f0941d.png
[731178-20160913091159367-521040156.png]: /images/20220527/4312b993db45401b88a21eac423c3fe8.png
[731178-20160913091519555-1829562453.png]: /images/20220527/b5ed8328bac34b8ba1017f021f5b1ec5.png
[731178-20160913091659336-1726147628.png]: /images/20220527/e882d42320db489cb0f0fdc5c21c5a31.png
[731178-20160913091845648-216859397.png]: /images/20220527/7657d6e2c0af47d881abff8c3fef8f07.png
[731178-20160913092014586-102528969.png]: /images/20220527/5aa5e94729cc455aa56b3192d2f38e90.png
[731178-20160913092002992-276930192.png]: /images/20220527/c7ccafedfde24fe09345e389d7117725.png
[731178-20160913092045852-1184156168.png]: /images/20220527/3834492befc642789cda55bb92fd8b7d.png
[Link 2]: http://wx.gam7.com
[Link 3]: http://mp.weixin.qq.com/wiki/15/40b6865b893947b764e2de8e4a1fb55f.html#.E6.A0.B9.E6.8D.AE.E5.88.86.E7.BB.84.E8.BF.9B.E8.A1.8C.E7.BE.A4.E5.8F.91.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8E.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.9D.87.E5.8F.AF.E7.94.A8.E3.80.91
[Link 4]: http://mp.weixin.qq.com/wiki/10/6380dc743053a91c544ffd2b7c959166.html
[731178-20160913094023352-1075966058.png]: /images/20220527/8657488135644ea3aeabb8935bcc72fd.png
[731178-20160913095146039-756573267.png]: /images/20220527/765ec548304c44ffab082b9546fe8801.png
[731178-20160913095255008-445120913.jpg]: /images/20220527/dc5af5239f3747dfabff02bd5aa8fa70.png