官方开发文档:文档 - 企业微信开发者中心 获取access_token 请求方式 GET请求地址 https://qyapi.weixin.qq.com/cgi-bin/gettoken请求参数是否必填说明corpid是企业ID,参考:
官方开发文档:文档 - 企业微信开发者中心
请求方式 | GET | |
请求地址 | https://qyapi.weixin.qq.com/cgi-bin/gettoken | |
请求参数 | 是否必填 | 说明 |
corpid | 是 | 企业ID,参考:术语说明-corpid |
corpsecret | 是 | 应用密钥,参考:术语说明-secret |
获取到的access_token用户后续的操作,作为鉴权调用者的身份。获取到的access_token在有效期内无需重复获取(注意:不能频繁调用gettoken接口,否则会受到频率拦截),待到失效或过有效期,需要重新获取(access_token的有效期通过返回的expires_in来传达)。
public function __construct(){ if (Cache::has('access_token')) { $this->access_token = Cache::get('access_token'); } else { $url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=%s&corpsecret=%s"; $response = $this->curlAll(sprintf($url,$this->corpid,$this->secret)); $response = json_decode($response,true); if($response['errcode'] != 0){ return false; }else{ Cache::put('access_token', $response['access_token'], $response['expires_in']); $this->access_token = $response['access_token']; } }}public function curlAll($url, $post_arr = []){ if ($post_arr) { $post_string = JSON_encode($post_arr); //参数 } $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); curl_setopt($ch, CURLOPT_HttpHEADER, array('Content-Type: application/json;charset=utf-8')); if ($post_arr) { curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $post_string); } curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0); $data = curl_exec($ch); curl_close($ch); return $data;}
返回值说明:
参数 | 说明 |
---|---|
errcode | 出错返回码,为0表示成功,非0表示调用失败。 错误码参考:全局错误码 - 接口文档 - 企业微信开发者中心 |
errmsg | 返回码提示语 |
access_token | 获取到的凭证,最长为512字节 |
expires_in | 凭证的有效时间(秒) |
请求方式 | POST | |
请求地址 | https://qyapi.weixin.qq.com/cgi-bin/user/getuserid | |
请求参数 | 是否必填 | 说明 |
access_token | 是 | 刚获取到的access_token |
mobile | 是 | 用户在企业微信通讯录中的手机号码。长度为5~32个字节 |
public function getUserIdByMobile($mobile){ $url = 'https://qyapi.weixin.qq.com/cgi-bin/user/getuserid?access_token='.$this->access_token; $params = [ 'mobile' => $mobile ]; $response = $this->curlAll($url,$params); $response = json_decode($response,true); if($response['errcode'] != 0){ return false; }else{ return $response['userid']; }}
返回值说明:
errcode | 返回码0表示成功,非0表示失败 错误码参考:全局错误码 - 接口文档 - 企业微信开发者中心 |
errmsg | 对返回码的文本描述内容 |
userid | 成员UserID。对应管理端的帐号,企业内必须唯一。 注意:第三方应用获取的值是密文的userid |
此接口为发送给个人可以批量发送给多个用户
请求方式 | POST | |
请求地址 | https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN | |
请求参数 | 是否必填 | 说明 |
touser | 否 | 指定接收消息的成员,成员ID列表(多个接收者用‘|’分隔,最多支持1000个)。 特殊情况:指定为"@all",则向该企业应用的全部成员发送 |
toparty | 否 | 指定接收消息的部门,部门ID列表,多个接收者用‘|’分隔,最多支持100个。 当touser为"@all"时忽略本参数 |
totag | 否 | 指定接收消息的标签,标签ID列表,多个接收者用‘|’分隔,最多支持100个。 当touser为"@all"时忽略本参数 |
msgtype | 是 | 消息类型,此时固定为:text |
agentid | 是 | 企业应用的id,整型。企业内部开发,可在应用的设置页面查看;第三方服务商,可通过接口 获取企业授权信息 获取该参数值 |
content | 是 | 消息内容,最长不超过2048个字节,超过将截断(支持id转译) |
safe | 否 | 表示是否是保密消息,0表示可对外分享,1表示不能分享且内容显示水印,默认为0 |
enable_id_trans | 否 | 表示是否开启id转译,0表示否,1表示是,默认0。仅第三方应用需要用到,企业自建应用可以忽略。 |
enable_duplicate_check | 否 | 表示是否开启重复消息检查,0表示否,1表示是,默认0 |
duplicate_check_interval | 否 | 表示是否重复消息检查的时间间隔,默认1800s,最大不超过4小时 |
public function sendTextMsg(array $userIds){ $params = [ "touser" => implode('|',$userIds), "msgtype" => "text", "agentid" => $this->AgentId, "text" => [ "content" => '消息本体', ], ]; $url = 'https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token='.$this->access_token; $response = $this->curlAll($url,$params); $response = json_decode($response,true); if($response['errcode'] != 0){ return false; } return true; }
返回值说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
invaliduser | 不合法的userid,不区分大小写,统一转为小写 |
invalidparty | 不合法的partyid |
invalidtag | 不合法的标签id |
unlicenseduser | 没有基础接口许可(包含已过期)的userid |
msgid | 消息id,用于撤回应用消息 |
response_code | 仅消息类型为“按钮交互型”,“投票选择型”和“多项选择型”的模板卡片消息返回,应用可使用response_code调用更新模版卡片消息接口,24小时内有效,且只能使用一次 |
来源地址:https://blog.csdn.net/weixin_47407120/article/details/126380535
--结束END--
本文标题: 企业微信消息推送(推送给个人)
本文链接: https://lsjlt.com/news/397858.html(转载时请注明来源链接)
有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
回答
回答
回答
回答
回答
回答
回答
回答
回答
回答
0