小程序 · 2023年7月15日

微信开发之用户组的介绍

1:创建用户组

   微信跟QQ一样可以创建组名,删除组名,修改组名,查询组名,这些操作都是一系列的接口,只需要调用相关的接口,并以curl的形式进行发送,便可以获得相关的结果

创建分组

一个公众账号,最多支持创建100个分组。

接口调用请求说明

http请求方式: POST(请使用https协议)https://api.weixin.qq.com/cgi-bin/groups/create?access_token=ACCESS_TOKEN

POST数据格式:json

POST数据例子:{“group”:{“name”:”test”}}

参数说明

参数 说明

access_token 调用接口凭证

name 分组名字(30个字符以内)

返回说明 正常时的返回JSON数据包示例:

{

    “group”: {

        “id”: 107, 

        “name”: “test”

    }

}

   下面是相关代码的实现

我们需要通过curl的形式将数据包发送过去,返回的结果是一个StdClass形式的json数据,我们需要将stdClass进行转换为数组形式,所以我们创建一个func.php文件,后面的组的相关操作都基于这些函数

<?php 
       //设定appID 和secret
	   define ("APPID","wx70fe852945a945b6",true);
	   define ("SECRET",'d05c2fc161d71c8317331a39044a7d93',true);
	   $APPID="wx70fe852945a945b6";
	   $SECRET="d05c2fc161d71c8317331a39044a7d93";
      function curl($url,$data=null)
	  {
		   //初始化
		   $curl=curl_init();
		   curl_setopt($curl, CURLOPT_URL, $url);//设置传输链接
           curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);//设置SSL凭证
           curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false );
           curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);//是否显示在浏览器上
		   if(!empty($data))
		   {
			   //进行post数据
			   curl_setopt($curl,CURLOPT_POST,1);
			   curl_setopt($curl,CURLOPT_POSTFIELDS,$data);
			   }
			$result=curl_exec($curl);//执行curl
			curl_close($curl);//关闭curl
			return $result;
		  }
		   function transition ($data)
	  {
		    if(is_object($data))
			{
				  $data=(array)$data;
				}
			if(is_array($data))
			{
				 foreach($data as $key=>$value)
				 {
					   $data[$key]=transition($value);
					 }
				}
				return $data;
		  }
		  //将多维数组转成字符串
		   function recount($result)
		{
			    if(is_array($result))
				{
			   foreach($result as $key=>$value)
			   {    
				  recount($value); 
				  return $value;
				   }
				  
				}
				
				
			}
		  //access_token链接地址
		  $access_token_url="https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$APPID&secret=$SECRET";
		 //获取access_token.将返回的json格式转成数组,返回一个数组形式的access_token
		 $access_token=(array)json_decode(curl($access_token_url));
		 $access_token=$access_token['access_token'];
		
?>

登录后复制

利用上面的access_token我们便可以做我们想做的任何事了

首先我们进行组的创建,我们将文件命名为creategroup.php

     1  界面展示

看起来很简单的HTML的代码,相信有HTML基础的都能写出

 那么如何创建组呢?很简单,我们只需将创建组的API链接提交过去就可以了

相关的代码

  <?php  echo '<meta http-equiv="content-type" content="text/html; charset=utf-8">'; 
?>
<!doctype html>
<html>
<head>
<title>无标题文档</title>
</head>
<body>
      <form action="#" method="post">
         <p>新建分组</p>
         <input type="text" name="tag" placeholder="新建一个分组">
         <input type="submit" name="-1" id="sub" value="提交">
         
      </form>
      <?php 
	     //如果提交成功,那么进行组的创建
	         if(isset($_POST[-1]))
			  {
	          
			     function create_group()
				{    require "func.php";
					 $create_url="https://api.weixin.qq.com/cgi-bin/tags/create?access_token=$access_token";
			         $tag=$_POST['tag'];//获取组名
					$poststr="
					          {
								  "tag":
								      {
										  "name":"$tag";
									  }
								  }
					";		
					if($result=curl($create_url,$poststr))
	{
		 echo "<script type="text/javascript">alert('执行成功,三秒之后将自动跳回主页')</script>";
		 //设置跳转回主页
		  echo "<script type="text/javascript">setTimeout(window.navigate("getgroup.php"),3000)</script>";
		}
	else
	{echo "<script type="text/javascript">alert('执行失败')</script>";}
	
					}
					create_group();
			  }
			  
	  ?>
</body>
</html>

登录后复制

2:接下来是展示所有的组名,我们先看看微信官方的文档

   查询所有分组

接口调用请求说明

http请求方式: GET(请使用https协议)https://api.weixin.qq.com/cgi-bin/groups/get?access_token=ACCESS_TOKEN

参数说明

参数 说明

access_token 调用接口凭证

返回说明 正常时的返回JSON数据包示例:

{
    "groups": [
        {
            "id": 0, 
            "name": "未分组", 
            "count": 72596
        }, 
        {
            "id": 1, 
            "name": "黑名单", 
            "count": 36
        }, 
        {
            "id": 2, 
            "name": "星标组", 
            "count": 8
        }, 
        {
            "id": 104, 
            "name": "华东媒", 
            "count": 4
        }, 
        {
            "id": 106, 
            "name": "不测试组", 
            "count": 1
        }
    ]
}

登录后复制

参数说明

参数 说明

groups 公众平台分组信息列表

id 分组id,由微信分配

name 分组名字,UTF8编码

count 分组内用户数量

错误时的JSON数据包示例(该示例为AppID无效错误):

    官方文档对于返回的json数据已经很明了了,一个组名里边包含了基本的信息,组id,组名以及组内的用户数量。我们无法直接将返回的json数据直接显示到页面上,那么我们如何解析json呢?微信给我们返回的是一个stdclass类型的json,所以第一步我们需要将json转为数组,php中有一个json_decode()函数,此函数能够将json数据转为stdclass的数组,stdclass并不等于数组,所以我们还要讲stdclass转化为array形式,在func.php中transition()函数就有这样的功能。

我们先看看页面显示样子,看看我们通过curl从腾讯上获取的数据是什么样的

上图我们创建了一个表,第一行是一个创建新组的功能,在以下的行中,我们能够看到组编号,组名,以及组内人数。那么这个是如何做到的呢?很简单,当我们已经获取到返回回来的json数据之后,我们对json进行数据包装,把json做成数组形式。那么如何实现数据包装呢?也很简单,我们不断的调用解析函数,将它最终变为数组的形式,然后遍历这个数组就行了。

展示源代码:getGroup.php

 
     <div>
    <div>
<?php  
      require "func.php";
  $groupurl="https://api.weixin.qq.com/cgi-bin/groups/get?access_token={$access_token}";
  $result=json_decode(curl($groupurl));//获取包装之后的数据,以数组的形式存储
  //$result=curl($groupurl);
   //将STDclass类型转为数组类型
  function G_transition ($data)
  {
    if(is_object($data))
{
  $data=(array)$data;
}
if(is_array($data))
{
 foreach($data as $key=>$value)
 {
   $data[$key]=G_transition($value);
 }
}
return $data;
  }
  $result=G_transition($result);  
  function G_recount($result)
{
    if(is_array($result))
{
   foreach($result as $key=&gt;$value)
   {    
  G_recount($value); 
  return $value;
   }
}
}
$resultG=G_recount($result);
echo "<table>";
     echo "<tr><th><a>创建一个新组</a></th></tr>";
 echo "<th>编号</th>
<th>组名</th>
<th>人数</th>";
for($i=0;$i<count>";
 foreach ($resultG[$i] as $key=&gt;$value)
   { 
  if($key=='id')
  {
  echo "<td>[$value]<a>删除</a><a>修改</a>
</td>";
  }
  else 
  {
        echo "<td> $value</td>";
  }
}
echo "";
}
echo "</count>
</table>";
?&gt;
      </div>
      <hr> 
       <div>
          <hr>
<p style="text-align: left;">  3:我们如何修改分组名</p>
<p style="text-align: left;">     修改分组名</p>
<p style="text-align: left;">接口调用请求说明</p>
<p style="text-align: left;">http请求方式: POST(请使用https协议)https://api.weixin.qq.com/cgi-bin/groups/update?access_token=ACCESS_TOKEN</p>
<p style="text-align: left;">POST数据格式:json</p>
<p style="text-align: left;">POST数据例子:{"group":{"id":108,"name":"test2_modify2"}}</p>
<p style="text-align: left;">参数说明</p>
<p style="text-align: left;">参数	说明</p>
<p style="text-align: left;">access_token	调用接口凭证</p>
<p style="text-align: left;">id	分组id,由微信分配</p>
<p style="text-align: left;">name	分组名字(30个字符以内)</p>
<p style="text-align: left;">返回说明 正常时的返回JSON数据包示例:</p>
<p style="text-align: left;">{"errcode": 0, "errmsg": "ok"}</p>
<p style="text-align: left;">错误时的JSON数据包示例(该示例为AppID无效错误):</p>
<p style="text-align: left;">  官方文档提供了修改分组名的接口,所以我们可以做一个修改的链接和一个修改组的modify.php文件</p>
<p style="text-align: left;">   根据官方文档,我们需要通过组id才能进行修改,根据我们在创建组的时候传输过来的json数据中我们可以获取到组id,所有我们可以通过创建链接的方式,当点击链接的时候,会把组id以get的方式传送到modify文件中,而modify.php可以通过$_GET的形式接收组id.</p>
<p style="text-align: left;">   我们先写好这个传送组id的链接,</p>
<pre class="brush:php;toolbar:false">      for($i=0;$i<count>";
 foreach ($resultG[$i] as $key=&gt;$value)
   { 
  if($key=='id')
  {
  echo "<td>[$value]<a>删除</a><a>修改</a>
</td>";
  }
  else 
  {
        echo "<td> $value</td>";
  }
}
echo "";
}</count>

登录后复制

代码中,我们对返回的数组进行遍历,如果发现key值是id,那么我们将值获取过来并且加入到链接尾部,注意get方式的写法

      echo “

[$value] “;

跳转到modify.php页面后,我们进行相关的处理,在该页面上,我们仍然有一个HTML输入框

代码如下:

    

登录后复制       

更新组名

       “>                           alert(“$result”);       “; //进行页面跳转  echo “<script> setTimeout(window.location.href=”getgroup.php”,3000); </script>”;   } else {  echo “<script> alert('wrong'); </script>”; } } if(isset($_POST[‘-1’])) { modify(); } ?>

如果执行成功,那么会进行弹出提醒框,等待五秒后自动跳转回getGroup.php页面

4:删除组

   组名一般不允许删除,但是微信平台仍然给出了相关的删除接口

   注意本接口是删除一个用户分组,删除分组后,所有该分组内的用户自动进入默认分组。 接口调用请求说明

http请求方式: POST(请使用https协议)https://api.weixin.qq.com/cgi-bin/groups/delete?access_token=ACCESS_TOKEN

POST数据格式:json

POST数据例子:{“group”:{“id”:108}}

参数说明

参数 说明

access_token 调用接口凭证

group 分组

id 分组的id

返回说明 正常时的返回JSON数据包示例:

通过传递的json数据,我们只需要将组id进行传递到delete.php页面并进行相关的删除操作即可

 代码显示:

    <?php  
    //该段程序用来删除组标签,成功之后会给予提示,并且跳转回getgroup.php页面
function delete()
{
$num=$_GET['num'];//接收来自getgroup页面的编号
require "func.php";
$delete_url="https://api.weixin.qq.com/cgi-bin/tags/delete?access_token=$access_token";
$data=json_encode(array("tag"=>array("id"=&gt;$num)));
//如果curl函数执行成功,那么会返回一个状态值
if($result=curl($delete_url,$data))
{
 echo "<script>alert('执行成功,三秒之后将自动跳回主页')</script>";
 //设置跳转回主页
  echo "<script>setTimeout(window.history.back(-1),8000)</script>";
}
else
{echo "<script>alert('执行失败')</script>";}
}
delete();
?&gt;

登录后复制

5:对组成员进行批量移动

   有时候我们需要对组内的成员进行移动到其他的组里面,在这点上,微信平台也给出了相应的接口我们先看官方的文档说明

    批量移动用户分组

接口调用请求说明

http请求方式: POST(请使用https协议)https://api.weixin.qq.com/cgi-bin/groups/members/batchupdate?access_token=ACCESS_TOKEN

POST数据格式:json

POST数据例子:{“openid_list”:[“oDF3iYx0ro3_7jD4HFRDfrjdCM58″,”oDF3iY9FGSSRHom3B-0w5j4jlEyY”],”to_groupid”:108}

参数说明

参数 说明

access_token 调用接口凭证

openid_list 用户唯一标识符openid的列表(size不能超过50)

to_groupid 分组id

返回说明 正常时的返回JSON数据包示例:

{“errcode”: 0, “errmsg”: “ok”}

 从传递的json数据可以看到,具有一个open_list和一个to_groupid,分别表示要移动的组成员的openid和将要移动的组id.那么我们如何开始移动呢?现在已基本清楚了,只需要把openid传递到open_list,将组id传递到to_groupid中,然后将包装好的json数据通过curl函数post过去.在批量分组之前,我们还要知道一件事,如何获取用户的相关信息,这个信息指的是用户微信上设置的性别,省份,国家,语言,所属组等等的相关信息,同样,微信提供了获取用户信息的接口,参照上述解决方法就可以获取到用户的相关的信息

以下是获取到的用户表

通过第一列的选择之后,在选择要分的组,点击移动就可以将用户移动到想要的组里面,下图是移动后的展示

所属组编号发生了变化

源代码展示


登录后复制           


               

               

               

               

               

               

               

               

               

               

               

               

               “;    $info_url=”https://api.weixin.qq.com/cgi-bin/user/info?access_token=$access_token&openid=$value&lang=zh_CN”;    $info=transition(json_decode(curl($info_url)));                              //var_dump($info);    //echo “”;   //  global $userinfo; //$userinfo=$info; //var_dump($userinfo);    foreach($info as $key=>$value)    {    //对表格进行相关的修饰,进行相关的判断     switch($key) {    //如果是id,那么做成一个复选框  case “openid”:      echo ”

“;      case “subscribe”://忽略相关的描述,不对这个字段生成列  break;  //如果是性别,性别值1代表男,0代表女,2代表并未填写  case “sex”:       if($value==1)   {  echo ”

“; }   else if($value==0)   {  echo ”

“;  }  else    {    echo ”

“; }   break;  //如果是头像链接,那么生成一个50*50像素的图片  case “headimgurl”;  echo ”

“;  break;  //以下是默认列  case “nickname”:  case “language”:  case “city”:  case “province”:  case “country”:  case “subscribe_time”:  echo ”

“;  break;  //如果remark的值为空,那么备注名是空值  case “remark”:   if(empty($value))   {    echo ”

“;   } else { echo ”

“; } break; case “groupid”:       echo”

“;   break; }    }  echo “”; }    }   ?>           

选择移动 昵称 性别 语言 所在城市 省份 国家 头像 加入时间 备注名 所属组                       “;  $count=count($resultG);  foreach($resultG as $key)//遍历包装好的json数据,已经转成了多维数组  {  echo “$key[name] “;                  $count–;  //获取组ID  } echo “”;  echo “”; ?>                          暂未填写                $value 暂无 $value $value