FeiShu Robot @ Protocol

定义飞书机器人身份消息协议,实现多机器人间统一发送者身份识别和用户身份消息回复,支持群组用户映射管理和定时更新。

安装

概览

{ “overview_html”: “飞书机器人身份消息协议 v2(FeiShu Robot @ Protocol)是一个专为解决飞书平台中多机器人间通信难题而设计的双层消息机制。在原生飞书环境中,机器人无法直接通过@触发其他机器人的 mention 事件,这严重限制了自动化工作流的协同能力。该协议通过引入标准化的消息格式和用户身份映射管理,实现了机器人之间的可靠@交互。其核心在于采用‘机器人身份发送+用户身份二次确认’的双层结构:首先由发送机器人以自身身份向目标群聊发送包含特殊标记的消息,随后再以真实用户身份补发一条带引用和占位符的富文本消息,从而绕过平台限制成功触发被@机器人的 mention 事件。整个过程依赖于一个本地维护的用户名到 open_id 的映射表,确保能够准确识别并@到目标实体。此协议不仅定义了清晰的消息发送与接收流程,还内置了ID过期刷新机制,保障了长期稳定运行。”, “feature_items”: [ “定义双层消息通信协议,解决飞书机器人间无法相互@触发的核心问题”, “支持通过机器人身份和用户身份分两步完成@操作,确保mention事件可靠触发”, “维护群组内用户名与open_id的动态映射表,支持自动过期刷新与手动更新”, “提供标准化的消息格式解析规则,精准识别发送者与接收者身份”, “兼容富文本与纯文本两种消息类型,适配不同场景下的发送需求” ], “scenarios_html”: “该协议特别适用于需要多个自定义机器人进行复杂协作的飞书群组环境。例如,在一个项目管理群中,一个负责数据处理的机器人(如‘Excalibur’)可以主动@另一个负责通知播报的机器人(如‘Qilin’),请求其向全体成员发送汇总报告。通过本协议的流程,Excalibur 能成功触发 Qilin 的 mention 事件,Qilin 收到通知后便可执行预设任务,形成完整的自动化流水线。此外,对于企业内部的知识库维护,多个知识问答机器人可以基于此协议建立协作网络,当一个机器人无法回答问题时,可迅速@另一个更专业的机器人寻求帮助,实现智能服务的无缝衔接。在日常办公场景中,当某个机器人需要协调多个同事或兄弟机器人共同完成任务时,该协议同样表现出色,它打破了飞书原生对机器人交互的限制,为构建高度集成的智能办公生态提供了坚实的技术基础。” }