飞书配对审批
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3fb2cd03/huangzixuan-feishu-pairing。
技能介绍
要解决的问题
当飞书 IM 通道配置了 pairing 访问策略时,新群聊或用户首次尝试与机器人对话,会收到类似「您暂时还无法与我对话,需要机器人主人的允许。您的请求已发送,获得允许后即可正常使用。」的提示。此时会话处于待审批状态,必须由机器人管理员找到对应请求并逐一处理,否则用户始终无法对话。本技能负责自动化这一段人工查找与处理流程。
核心能力与工作步骤
- 查询待审批列表:通过
qw_query工具查询飞书通道的配对信息,返回pending(待审批)和approved(已通过)两个列表,pending中每条包含conversationId、senderId、conversationName、conversationType和触发消息内容。 - 展示并确认:以清晰格式展示待审批请求的会话名称、类型(群聊/私聊)、发送者 ID 和触发消息。若只有一条记录且用户意图明确,可跳过确认直接执行。
- 执行审批:通过
qw_action工具批准或拒绝指定请求,执行成功后告知用户,并提示对方重新尝试对话。 - 结果验证:再次调用
qw_query确认请求已从pending移入approved,并建议在对应群聊中重新 @机器人 验证回复。
适用边界与注意点
senderId是必传参数,最常见的错误是只传conversationId,会报Missing params.senderId类错误。conversationId和senderId必须来自同一条pending记录,不能混用不同记录的 ID。- 飞书频道未连接时查询可能返回空结果或错误,需先在 QoderWork 中连接频道。
- 审批操作不可撤销,误批准需在频道管理界面手动移除配对。
- 若用户从 IM 通道发起此请求,应直接在文本中询问,而非调用 AskUserQuestion 工具。
使用场景
- 飞书群开启 pairing 策略后,新成员 @机器人 被拒,需要管理员查看待审批列表并批准,让对方能正常对话
- 用户私信机器人收到「需要主人允许」提示,管理员要查询 pending 列表并批准该私聊配对请求
- 多条群聊配对请求积压,管理员逐条核对会话名称与触发消息,选择批准或拒绝指定请求
- 审批执行后,管理员再次查询配对状态确认请求已通过,并在群内 @机器人 验证能否正常回复
适合人员
- 飞书机器人管理员:开启 pairing 策略后,需要及时处理新群聊和用户的配对审批,避免成员一直无法与机器人对话
- 使用 QoderWork 接入飞书的开发者:调试机器人首次回复被拦截的问题时,需要查询 pending 配对列表并执行批准或拒绝
- 机器人运维人员:收到用户反馈「暂时无法与机器人对话」时,需要定位配对请求状态并完成审批操作