自建腾讯企业微信通知API

作者: 猫先生
时间: 2022-08-19
分类: 建站
2 条评论

现在很多后台应用需要通知信息给用户，支持通知的方式有很多，server酱，丁丁，企业微信，bark，WxPusher，等等的五花八门，我最喜欢的则是企业微信，因为不需要安装其他应用，推送的消息也干净清爽，不夹杂其他内容。从2022年6月20日开始，企业微信新建应用发送消息的时候，必须要添加信任IP，这个IP就是发起请求端的源IP，很多家用宽带的公网IP都是动态的，重启就变，这对于使用企业微信则带来了不便。解决这个问题有两种方法，要求动手能力稍强，两种方法都需要有自己的vps。
1，利用nginx反代，把请求先发送到vps，然后由vps向腾讯发起请求，在企业微信的应用里，添加vps 的IP为信任IP即可。反代代码如下:

server {
    listen 443;
    server_name  xxx.xxx.xxx;
    add_header Strict-Transport-Security "max-age=15768000" always;
    access_log  /var/log/nginx/xxx.xxx.xxx.log  main;
    root   /data/www;
    index  index.php index.html index.htm;


   location / {
proxy_pass https://qyapi.weixin.qq.com/;
}
ssl_certificate /data/webkey/xxx.xxx.xxx.crt;
     ssl_certificate_key /data/webkey/xxx.xxx.xxx.key;
     ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3; 
     ssl_ciphers  TLS13-AES-256-GCM-SHA384:TLS13-CHACHA20-POLY1305-SHA256:TLS13-AES-128-GCM-SHA256:TLS13-AES-128-CCM-8-SHA256:TLS13-AES-128-CCM-SHA256:EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+ECDSA+AES128:EECDH+aRSA+AES128:RSA+AES128:EECDH+ECDSA+AES256:EECDH+aRSA+AES256:RSA+AES256:EECDH+ECDSA+3DES:EECDH+aRSA+3DES:RSA+3DES:!MD5;     
     ssl_prefer_server_ciphers on;
     ssl_early_data on;
     ssl_stapling on;
     ssl_stapling_verify on;


    }

server {
    listen 80;
    server_name xxx.xxx.xxx;
    rewrite ^(.*)$ https://${server_name}$1 permanent; 
    if ($host != 'xxx.xxx.xxx'){
   return 403;
}

}

这样一来，在应用端，把请求链接中的https://qyapi.weixin.qq.com 替换成自己的地址https://xxx.xxx.xxx即可。

2022-08-19T06:24:32.png

2，对于一些支持自定义通知的应用，我们还可以使用基于企业通知的接口，搭建自己的API，因为使用企业微信的通知，需要经过获取token ，然后使用token发送消息，mpnews模板还需要上传素材获取media-id这几个阶段。而支持自定义应用的配置都只让填写一行url来完成推送，一条url无法完成上述多个请求动作，所以，我考虑到把请求都有vps 来完成，网上我找了好久，找到了如下代码。我是搞硬件基础架构的，对php代码来说，一窍不通，但是凭着我对这些东西的敏感性，还是搞清楚了代码的作用。下面附上代码。代码里有些php 是我自己写的，我都佩服自己，觉得该去学编程，但是头发不够了。哈哈哈~

<?php
//获取通过post或者get传递的值并赋值给变量
$title = $_POST['title'];
$content = $_POST['content'];
$msgtype = $_POST['msgtype'];
$url = $_POST['url'];
$picurl = $_POST['picurl'];
$title = $_GET['title'];
$content = $_GET['content'];
$msgtype = $_GET['msgtype'];
$url = $_GET['url'];
$picurl = $_GET['picurl'];

if (!$content){
echo '<h1>企业微信通知API</h1>';
        echo '<hr/>';
        echo '<h4>输入参数以继续，支持POST或者GET请求方式。</h4>';
        echo '<p><b>文本消息(text)</b>：以文字形式通知消息</p>';
        echo '<p><b>示例</b>：<a href="?content=这是一条测试信息&msgtype=text">https://xxx.xxx.xxx/?content=这是一条测试信息&msgtype=text</a></p>';
        echo '<hr/>';
        echo '<p><b>文本卡片消息(textcard)</b>：以卡片形式通知消息</p>';
        echo '<p><b>示例</b>：<a href="?title=通知测试&content=这是一条测试信息&url=https://www.mr-mao.cn&msgtype=textcard">https://xxx.xxx.xxx/?title=通知测试&content=这是一条测试信息&url=https://www.mr-mao.cn&msgtype=textcard</a></p>';
        echo '<hr/>';
        echo '<p><b>图文消息(news)</b>：以图文形式通知消息</p>';
        echo '<p><b>示例</b>：<a href="?title=通知测试&content=这是一条测试信息&picurl=https://www.mr-mao.cn/usr/logo.png&url=https://api.mr-mao.cn/60s/pic/&msgtype=news">https://xxx.xxx.xxx/?title=通知测试&content=这是一条测试信息&picurl=https://www.mr-mao.cn/usr/logo.png&url=https://api.mr-mao.cn/60s/pic/&msgtype=news</a></p>';
        echo '<hr/>';
        echo '<p><b>图文消息(mpnews)</b>：以富文本图文形式通知消息</p>';
        echo '<p><b>示例</b>：<a href="?title=通知测试&content=这是一条测试信息&msgtype=mpnews">https://xxx.xxx.xxx/?title=通
知测试&content=这是一条测试信息&msgtype=mpnews</a></p>';
        echo '<hr/>';

}else{

// 声明页面 header
header("Content-type:text/html;charset=utf-8");
// 获取 access_token
function getToken(){
 // 定义 id 和 secret
 $corpid='xxxxxx';//这里填写你的企业 ID
 $corpsecret='xxxxxxxxxxxxxxxx';//这里填写你刚创建的应用 secret
 // 读取 access_token
 include './access_token.php';
 // 判断是否过期
 if (time() > $access_token['expires']){
 // 如果已经过期就得重新获取并缓存
 $access_token = array();
 $access_token['access_token'] = getNewToken($corpid,$corpsecret);
 $access_token['expires']=time()+7000;
 // 将数组写入 php 文件
 $arr = '<?php'.PHP_EOL.'$access_token = '.var_export($access_token,true).';'.PHP_EOL.'?>';
 $arrfile = fopen("./access_token.php","w");
 fwrite($arrfile,$arr);
 fclose($arrfile);
 // 返回当前的 access_token
 return $access_token['access_token'];
 }else{
 // 如果没有过期就直接读取缓存文件
 return $access_token['access_token'];
 }
}
// 获取新的 access_token
function getNewToken($corpid,$corpsecret){
 $url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={$corpid}&corpsecret={$corpsecret}";
 $access_token_Arr = https_request($url);
 return $access_token_Arr['access_token'];
}
// curl 请求函数
function https_request ($url){
 $curl = curl_init();
 curl_setopt($curl, CURLOPT_URL, $url);
 curl_setopt($curl,CURLOPT_RETURNTRANSFER,1);
 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
 $out = curl_exec($curl);
 curl_close($curl);
 return json_decode($out,true);
}
//获取mpnews消息所需的media_id

if ($msgtype == "mpnews"){
include './access_token.php';
$token = $access_token['access_token'];
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=$token&type=image",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('media'=> new CURLFILE('logo.png')),//需要在程序同级目录下放通知消息的头图文件
));

$response = curl_exec($curl);
curl_close($curl);
$data = json_decode($response,true);
$media_id = $data['media_id'];
}
// 发送应用消息函数
function send($data){
 $curl = curl_init();
 curl_setopt($curl, CURLOPT_URL, 'https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token='.getToken());
 curl_setopt($curl, CURLOPT_POST, true);
 curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0);
 curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2);
 curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
 return curl_exec($curl);
}
 // 文本卡片消息体
 $postdata = array(
 'touser' => '@all', //不需要写联系人，会发送给所有人
 'msgtype' => $msgtype,
 'agentid' => 'xxxxxxxxx',//这里填写你刚创建的应用 AgentId
 "$msgtype" => array(
 "content" => "$content",
 'title' => $title,
 'description' => $content,
 'url' => $url,
 'articles' => array(
 'title' => $title,
 "author" => "FatCat", //自定义作者
 "digest" => $content,
 "content" => $content,
 'thumb_media_id' => $media_id,
 'description' => $content,
 'picurl' => $picurl,
 'url' => $url,
),
 ),
 'enable_id_trans' => 0,
 'enable_duplicate_check' => 0,
 'duplicate_check_interval' => 1800
);
// 调用发送函数
 echo send(json_encode($postdata));
// echo "$title, $description"
}
?>

至此，支持三种消息模板的api搭建完成，enjoy it！访问自己的链接，则可出现简易的参数模板，具体参数点击下面的链接查询，此时，这个api则可以用在任何支持自定义通知的应用中。同时支持post或者get请求。

不同模板所需的请求参数参考腾讯企业的文档库

2022年8月

自建腾讯企业微信通知API

常用网络功能和性能测试工具

最新文章

最近回复

分类

归档

其它