配置 IM 机器人（飞书 / Lark / 钉钉）权限

使用已有的飞书、Lark 或钉钉自建应用接入 InYourWork 时，需要在开放平台为该应用开通对应权限并完成发布。 缺少权限会导致消息收发、群信息解析或附件导入失败。

飞书 / Lark

所需权限清单

• im:message：接收与发送消息（含回复消息、更新任务进度卡片）。
• im:message:send_as_bot：以应用身份主动发送消息。
• im:resource：下载消息中的图片与文件附件，用于把附件导入工作台。
• im:chat、im:chat:readonly：获取群组信息。
• im:chat.group_info:readonly：获取群名称等基础信息，用于在配置面板展示来源群。
• im:chat.members:read：获取群成员列表，用于解析消息发送者昵称。

配置步骤

1. 登录开放平台（飞书 open.feishu.cn / Lark open.larksuite.com），进入目标自建应用。

2. 打开「权限管理」，搜索并开通上方清单中的全部权限。也可以在 InYourWork 的 IM 配置面板点击「前往飞书配置」（Lark 应用为「前往 Lark 配置」）快捷链接，直达应用权限页并自动预填所需权限清单。

3. 权限变更后需要「创建版本」并提交发布，待企业管理员审核通过后权限才会生效。

事件订阅（长连接模式）

InYourWork 通过 WebSocket 长连接接收事件，无需配置公网回调地址。请在应用的「事件订阅」中选择长连接模式，并添加以下事件：

• im.message.receive_v1：接收消息（必需）。
• card.action.trigger：卡片按钮回调，用于任务进度卡片交互。
• im.chat.member.bot.added_v1：机器人被拉入群聊时收到通知。

快捷链接格式

IM 配置面板中的「前往开放平台配置权限」链接格式如下（Lark 应用将域名替换为 open.larksuite.com）：

https://open.feishu.cn/app/{appId}/auth?q=im:message,im:message:send_as_bot,im:resource,im:chat,im:chat:readonly,im:chat.group_info:readonly,im:chat.members:read&op_from=openapi&token_type=tenant

钉钉

通过扫码一键创建的钉钉应用已预置下列权限和 Stream 消息接收模式，无需额外配置； 在 IM 配置面板「使用已有机器人」手动录入自建应用的 Client ID / Client Secret 时，才需要按本节步骤检查配置。

所需权限清单

• 企业内机器人发送消息权限（权限点 Robot.Message.Write，必需）：接收与回复消息、下载消息中的图片与文件附件、主动推送任务进度。
• 互动卡片实例写权限（权限点 Card.Instance.Write）：以互动卡片形式回复并流式更新（打字机效果）。缺失时回复自动降级为普通 markdown 消息，不影响基础收发。

配置步骤

1. 登录钉钉开发者后台（open-dev.dingtalk.com），进入目标企业内部应用。

2. 打开「权限管理」，搜索并开通上方清单中的权限（机器人相关权限默认免审批）。

3. 在「应用能力 → 机器人」中确认已开启机器人，且消息接收模式选择 Stream 模式（InYourWork 通过长连接接收消息，无需公网回调地址）。

4. 在「版本管理与发布」中发布应用，机器人状态变为已发布后生效。

注意事项

• 群聊中机器人仅在被 @ 提及时才会收到消息（平台行为，非配置问题）。
• 音视频消息暂不支持导入（与飞书 / Lark 一致），会收到不支持提示。

验证配置

发布生效后回到 InYourWork 的 IM 配置面板，给机器人发送一条消息和一张图片： 能收到回复说明消息权限正常；图片作为附件出现在工作台中说明附件下载权限正常 （飞书 / Lark 对应 im:resource 权限，钉钉对应企业内机器人发送消息权限）。