workbuddy接入企业微信后无法拉取部门列表，需依次排查：一、确认通讯录secret配置正确；二、检查是否开通“读取部门信息”权限；三、验证secret未被禁用或过期；四、开启企业微信通讯录同步开关；五、核对api请求参数（access_token及dept_id=0）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果WorkBuddy接入企业微信后无法拉取部门列表，可能是由于通讯录Secret配置错误或权限未正确开通。以下是排查该问题的具体步骤：
一、确认通讯录Secret是否填写正确
通讯录Secret是调用企业微信通讯录API的身份凭证，若填写错误将导致接口鉴权失败，进而无法获取部门列表。
1、登录企业微信管理后台，进入【应用管理】→【自建应用】→选择对应的WorkBuddy应用。
2、点击【设置】页签，在【API调用】区域找到【通讯录Secret】字段。
3、核对WorkBuddy系统中配置的Secret值是否与后台显示的完全一致，包括大小写和特殊字符。
4、如发现不一致，立即在WorkBuddy后台更新为最新Secret并保存配置。
二、检查通讯录Secret对应权限范围
企业微信的通讯录Secret绑定特定的可读权限范围，若未授权“部门”相关权限，则API返回结果中将不包含部门数据。
1、在企业微信管理后台，进入该应用的【权限管理】→【通讯录权限】页面。
2、查看当前Secret所关联的权限模板，确认已勾选【读取部门信息】选项。
3、若未勾选，需手动启用该权限并提交审批（管理员需完成审批流程）。
4、审批通过后，等待约5分钟使权限策略同步生效。
三、验证通讯录Secret是否被禁用或过期
企业微信允许管理员手动禁用某个Secret，或因安全策略自动失效，此时即使配置正确也无法调用API。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
1、在【API调用】→【通讯录Secret】列表中，检查该Secret状态是否为“已启用”。
2、若状态为“已禁用”，点击右侧操作栏的【启用】按钮恢复使用。
3、若列表中无可用Secret，点击【新建Secret】生成新密钥，并同步更新至WorkBuddy配置中。
四、确认企业微信通讯录同步开关已开启
即使Secret有效且权限完整，若企业微信侧未开启通讯录同步功能，WorkBuddy仍无法获取任何部门结构。
1、进入企业微信管理后台【我的企业】→【通讯录同步】→【同步设置】。
2、检查【启用通讯录同步】开关是否处于开启状态。
3、若为关闭状态，切换为开启，并确保同步方式为【全量同步】或【增量同步】（非仅限成员）。
五、检查WorkBuddy调用API时的请求参数
WorkBuddy在调用企业微信获取部门列表接口（/cgi-bin/department/list）时，若传入了错误的access_token或未携带dept_id参数，可能返回空列表或根部门以外的数据。
1、确认WorkBuddy日志中调用接口时使用的access_token是由该通讯录Secret获取的，而非其他应用Secret。
2、检查请求URL是否包含dept_id=0（用于获取根部门及全部子部门），若缺失该参数则仅返回单个部门。
3、若日志显示HTTP 400或403响应，说明access_token无效或权限不足，需重新获取token并校验scope。
