应申请contact:user:readonly及contact:user.employee_id:readonly权限并由企业管理员审批。登录飞书开放平台批量导入两项权限,再通知管理员在企业管理后台完成人工授权,否则用户信息读取将失败或返回403错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用WorkBuddy飞书版时无法获取用户信息,例如姓名、部门、工号或头像等字段为空或返回403错误,则极可能是飞书应用未正确申请对应用户信息读取权限(Scope)。以下是解决此问题的步骤:
一、确认已申请contact:user:readonly基础权限
该权限是读取当前用户基本信息的最低必要权限,缺失将导致WorkBuddy完全无法调用飞书用户API。飞书开放平台强制要求该权限必须通过批量导入方式添加,不可手动勾选单条。
1、登录飞书开放平台,进入目标企业自建应用详情页。
2、在左侧菜单栏点击「权限管理」→「批量导入 / 导出权限」。
3、清空弹窗中全部已有内容,粘贴以下权限标识:contact:user:readonly。
4、点击「确定新增权限」,等待页面刷新后确认该项状态显示为「已授权」且无黄色警告图标。
二、补充申请contact:user.employee_id:readonly(如需工号)
若业务场景明确需要获取用户工号(employee_id),仅contact:user:readonly不足以满足,必须额外显式申请该扩展权限。该权限属于user维度独立Scope,不包含在基础权限包中。
1、仍在同一「批量导入 / 导出权限」弹窗中,追加粘贴:contact:user.employee_id:readonly。
飞书多维表格周报权限检查与合并工具。输入多维表格 URL,自动提取链接列,批量检查阅读权限,合并有权限文档为新文档。输出有权限、无权限列表及新文档链接。触发词:多维表格周报合并、批量合并周报、多维表格文档合并。
2、确保两项权限在同一操作中完成导入,避免分次提交导致权限缓存不一致。
3、提交后返回「权限列表」主页面,逐项核对contact:user:readonly与contact:user.employee_id:readonly均处于「已开通」状态。
三、触发企业管理员人工审批流程
飞书平台对contact类权限实施强管控策略,即使开发者已在后台完成申请,也必须由企业飞书管理员在管理后台完成最终授权,否则权限始终处于「待管理员审批」灰置状态,WorkBuddy调用将直接被网关拦截。
1、通知企业飞书管理员登录飞书企业管理后台。
2、导航至「应用管理」→「已安装应用」→ 找到WorkBuddy对应应用 → 点击「权限管理」。
3、在待审批列表中,对上述两项contact权限分别点击「同意」按钮。
4、管理员完成审批后,WorkBuddy需重启飞书集成模块或等待5分钟权限缓存自动刷新。

















