ThinkPHP连接企业微信：团队协同办公配置指南：技巧

必须区分管理接口与客服消息接口的鉴权体系，配置corpid、corpsecret和kf_secret双凭证，封装独立Token获取方法，启用微信客服权限并完成用户消息窗口、external_userid、配额及请求体校验。

在ThinkPHP项目中完成企业微信团队协同办公配置，必须先区分管理类接口与客服消息接口的鉴权体系，否则调用/kf/send_msg等接口时会持续返回40014或48002错误，且无法通过刷新access_token解决。

配置双凭证与独立Token获取方法

在/Application/Common/Conf/config.php中新增weixin配置项，必须同时提供corpsecret（用于管理接口）和kf_secret（仅用于客服接口），缺一不可。

复制以下结构并填入真实值：

【corpid必须与企业微信后台「我的企业」页顶部显示的ID完全一致，字母大小写敏感】

立即学习“PHP免费学习笔记（深入）”；

'weixin' => [ 'corpid' => 'wwxxxxxxxxxxxxxx', 'corpsecret' => 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'kf_secret' => 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy' ]

新建/Application/Common/Service/WeixinTokenService.class.php，封装两个独立方法：getAccessToken()只读取corpsecret→请求https://qyapi.weixin.qq.com/cgi-bin/gettoken；getKfAccessToken()只读取kf_secret→请求https://qyapi.weixin.qq.com/cgi-bin/kf/gettoken。

两个方法均需内置7200秒有效期校验与本地缓存（建议用SaeStorage或File方式），禁止共用同一缓存键名。

启用微信客服接口权限

登录企业微信管理后台 → 左侧菜单「微信客服」→ 「接口调用配置」→ 找到当前应用 → 开启「调用接口」开关。

这一步不做，后续所有/kf/*接口都会返回48002错误，且错误码不会提示具体原因。

确认「客服人员」已绑定该应用，且至少有一名成员被设置为「客服接待人员」。

发送客服消息前的强制校验步骤

第一步：确认目标用户已触发48小时消息窗口——用户必须在过去48小时内主动向企业微信客服发送过消息，或当前会话正由智能助手接待中。

第二步：获取用户的external_userid，不是企业微信后台的userid，也不是手机号。调用/cgi-bin/kf/customer/get_by_unionid或监听customer_msg_push事件获取。

第三步：检查配额——单个external_userid 48小时内最多接收5条消息（含文本、图文、小程序卡片），超限后接口静默失败，不报错也不送达。

第四步：构造请求体，touser字段填external_userid，msgtype设为text，agentid字段必须留空（客服消息接口不认agentid）。

第五步：使用getKfAccessToken()返回的token，调用https://qyapi.weixin.qq.com/cgi-bin/kf/send_msg，HTTP方法为POST，Content-Type必须为application/json。