配置回调
在【管理后台->应用和小程序->审批->API->接收事件服务器】中,设置回调地址,并勾选需要进行状态变化回调通知的审批模板类型。
设置后,回调地址可接收审批应用所有允许进行回调的审批申请相关状态变化通知。
审批申请状态变化回调通知
审批申请状态变化回调通知 - 接口文档 - 企业微信开发者中心
配置页面
描述:
1.配置一个回调地址,Token和EncodingAESKey随机获取就行
2.选择需要回调的模板,需要哪个就勾选哪个就行
3.点击保存就验证看这个回调接口是否通过了
验证回调设置
- 需要写解加密数据的方法
- 引用类方法解密方法
- 验证通过
加解密库下载与返回码
加解密库下载与返回码 - 接口文档 - 企业微信开发者中心
php库
(点击进入)
注意事项:
- WXBizMsgCrypt.php文件提供了WXBizMsgCrypt类的实现,是用户接入企业微信的接口类。Sample.php提供了示例以供开发者参考。errorCode.php, pkcs7Encoder.php, sha1.php, xmlparse.php文件是实现这个类的辅助类,开发者无须关心其具体实现。
- WXBizMsgCrypt类封装了VerifyURL, DecryptMsg, EncryptMsg三个接口,分别用于开发者验证接收消息的url、接收消息的解密以及开发者回复消息的加密过程。使用方法可以参考Sample.php文件。
PHP代码:
$encodingAesKey = "xxxxxxxxxxxx"; //回调里面的EncodingAESKey
$token = "xxxxxxxxxxxx"; //回调里面的token
$corpId = "xxxxxxxxxxxx"; //企业id$sVerifyMsgSig = urldecode($_REQUEST['msg_signature']);
$sVerifyTimeStamp = urldecode($_REQUEST['timestamp']);
$sVerifyNonce = urldecode($_REQUEST['nonce']);
$sVerifyEchoStr = urldecode($_REQUEST['echostr']);$wxcpt = new \WXBizMsgCrypt($token, $encodingAesKey, $corpId);
$errCode = $wxcpt->VerifyURL($sVerifyMsgSig, $sVerifyTimeStamp, $sVerifyNonce, $sVerifyEchoStr, $sEchoStr);
if ($errCode == 0) {echo $sEchoStr;} else {print("ERR: " . $errCode . "\n\n");
}
注意:
- 接收的参数得urldecode一下
- 返回数据的时候得原样式输出(尤其是这里,PHP给的官方demo是有问题的,官方打印的不是原样式,有字符串,导致报40001)
附录:
验证通过页面:
接收消息与事件 概述
概述 - 接口文档 - 企业微信开发者中心
配置审批成功后的回调
回调参数
审批申请状态变化回调通知 - 接口文档 - 企业微信开发者中心
描述:里面有回调后的参数介绍
PHP代码:
$encodingAesKey = "xxxxxxxxxxxx"; //回调里面的EncodingAESKey
$token = "xxxxxxxxxxxx"; //回调里面的token
$corpId = "xxxxxxxxxxxx"; //企业id$sVerifyMsgSig = urldecode($_REQUEST['msg_signature']);
$sVerifyTimeStamp = urldecode($_REQUEST['timestamp']);
$sVerifyNonce = urldecode($_REQUEST['nonce']);$xmldata=file_get_contents("php://input");
$sEchoStr = '';
$wxcpt = new \WXBizMsgCrypt($token, $encodingAesKey, $corpId);
$errCode = $wxcpt->DecryptMsg($sVerifyMsgSig, $sVerifyTimeStamp, $sVerifyNonce, $xmldata, $sEchoStr);
$data=simplexml_load_string($sEchoStr,'SimpleXMLElement', LIBXML_NOCDATA);
$data = json_encode($data);
$data = json_decode($data,true);
dump($data)
注意:
- 接收的参数得urldecode一下
- 返回数据的数据是xml,需要自己转化成需要的
- 这个回调是有流转就有触发,可以判断审批状态是审批完成的再做处理就可以了
备注:
我就是在原来测试回调的方法里面写的
返回参数的描述
审批申请状态变化回调通知 - 接口文档 - 企业微信开发者中心