业务赋能中心
飞书协同与消息触达
飞书登录、账号绑定、业务通知、卡片回调和直播录制消息入口说明。
能力定位
飞书协同用于把 StudioX 的业务流程延伸到员工日常沟通工具中。它不替代平台页面，而是让关键状态、待办提醒和轻量操作能及时触达相关人员。
当前飞书链路覆盖：
- 飞书 OAuth 登录和手机号补全。
- 个人中心飞书账号绑定。
- 成片审核、驳回、平台卡审等通知。
- 剪辑任务转交和接收提醒。
- 直播录制消息识别、确认弹窗和任务创建。
- 飞书卡片按钮回调和消息事件回调。
使用前提
要让飞书协同稳定工作，需要同时满足：
- 员工在系统内有账号，并拥有对应业务权限。
- 员工在个人中心完成飞书绑定。
- 飞书应用、机器人、事件订阅和卡片回调配置正确。
- 云端回调地址可被飞书访问。
- 异步队列和通知服务正常消费。
常见业务场景
飞书快捷登录
员工可通过飞书授权登录 StudioX。如果手机号或员工信息缺失，系统会进入补全流程，再完成账号关联。
成片状态通知
成片提交审核、审核通过、驳回、平台卡审等关键状态可发送到飞书群或相关人员。通知失败不会回滚业务状态，但需要在队列和飞书配置中排查。
剪辑任务转交
任务转交说明会进入飞书卡片，让接收成员快速知道转交原因、任务内容和下一步动作。
直播录制消息入口
员工可以在飞书中发送自然语言直播链接或直播间信息，系统解析后通过卡片确认是否创建录制任务。当前业务默认支持抖音、快手、小红书、淘宝等直播平台口径。
排查顺序
如果飞书协同不生效，建议按顺序排查：
- 员工是否完成飞书绑定。
- 业务动作是否真实触发通知或卡片。
- 飞书应用的回调地址、事件订阅和权限是否正确。
- 群
chat_id、机器人配置或通知开关是否正确。 - 异步队列是否正常消费。
- 云端日志中是否有飞书接口错误、签名错误或解密错误。
使用边界
- 飞书消息只是业务触达方式，不是唯一事实来源。
- 最终状态以 StudioX 云端业务记录为准。
- 卡片操作需要能识别员工身份，未绑定飞书时可能无法完成闭环。
- 通知发送失败不应该阻塞成片审核、任务转交或直播录制状态落库。