飞书工作通知无法推送的首要原因是应用可见范围设置不当。需依次检查：一、飞书开放平台中“应用可见范围”是否覆盖目标用户；二、管理后台“应用可用范围”是否启用并含目标部门；三、目标群组是否已添加workbuddy机器人；四、“im:message:send_as_bot”等发送权限是否已授权通过。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成WorkBuddy飞书应用接入，但工作通知无法推送到飞书用户或群组，则很可能是由于飞书侧应用可见范围设置不当，导致消息投递被平台拦截。以下是针对性排查与修正步骤：
一、确认飞书应用“应用可见范围”是否覆盖目标用户
飞书强制校验应用对用户的可见性，若目标用户不在可见范围内，即使机器人已启用、权限已配置，所有推送请求（包括单聊与群消息）均会被静默拒绝，不返回错误提示，仅表现为“无响应”或“消息未送达”。
1、登录飞书开放平台，进入「企业自建应用」列表，找到已绑定WorkBuddy的对应应用。
2、点击应用名称进入详情页，在左侧菜单中选择「基本信息」。
3、向下滚动至「应用可见范围」模块，查看当前设置状态。
4、若显示为「指定成员/部门」或「仅管理员可见」，则必须修改为本企业全部成员；如确需限制范围，须确保目标接收者（含个人账号及群组内所有成员）均明确包含在所选部门或人员列表中。
5、点击「保存」按钮，系统将提示“配置已更新”，该操作立即生效，无需重启应用或重新绑定WorkBuddy。
二、验证飞书管理后台中的“应用可用范围”设置
飞书开放平台的“应用可见范围”仅控制API调用权限可见性，而管理后台的“应用可用范围”则决定该应用是否出现在员工工作台及群机器人列表中——若此处关闭，WorkBuddy机器人将无法被添加至群组，自然无法向群内推送消息。
1、使用企业超级管理员账号登录飞书管理后台。
2、在左侧导航栏点击「工作台」→「应用列表」，在搜索框中输入WorkBuddy应用名称。
3、在应用卡片右侧点击「更多」→「应用可用范围」。
4、确认「启用状态」为开启，并检查「可用范围」是否勾选全部成员或至少包含目标群组所属部门。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
5、若范围为「自定义」，点击「编辑」，手动添加目标群组中所有成员所在部门，完成后点击「确定」并等待同步完成（通常30秒内）。
三、检查飞书群组内是否已成功添加WorkBuddy机器人
即使应用整体可见，WorkBuddy仍需以机器人身份被显式添加至具体群组，才能获得向该群发送消息的资格。未添加或添加失败将导致群通知完全失效，且不会触发任何日志或告警。
1、打开飞书客户端，进入需要接收通知的目标群聊。
2、点击右上角「…」→「群设置」→「群机器人」→「添加机器人」。
3、在搜索框中输入WorkBuddy应用在飞书开放平台中设置的机器人名称（非应用名称），从结果中选择并点击确认。
4、添加成功后，该机器人头像将出现在群成员列表顶部，且群公告中会显示“XXX已加入本群”。
5、若搜索不到机器人，请返回飞书开放平台检查「机器人」模块下「启用机器人」开关是否为开启状态，并确认「机器人名称」已点击「保存」。
四、核对飞书应用权限中“发送消息”能力是否已授权并审核通过
飞书将“发送消息”列为高危权限，需经企业管理员人工审批。若权限申请处于待审、驳回或过期状态，WorkBuddy虽能完成绑定，但所有send_message接口调用均返回403 Forbidden，且前端无明确报错。
1、在飞书开放平台应用详情页，点击左侧「权限管理」→「已申请权限」。
2、查找权限项：im:message:send_as_bot（以机器人身份发送消息）和im:message:send_multi_users（向多用户发送消息）。
3、确认其状态为已授权；若显示“待审批”，请立即联系企业管理员前往管理后台「权限审批」页面完成审核。
4、若权限曾被撤销或过期，需重新进入「权限管理」→「添加权限」，勾选上述两项并提交新申请。
