Feishu At Mention
v0.0.2飞书消息@提及功能。当需要在飞书消息中@群成员时使用此技能。支持三种消息类型:(1) 普通文本消息使用 at user_id 标签格式;(2) 富文本消息使用 JSON 对象格式的 tag at 元素;(3) 卡片消息使用 at id 标签格式。根据消息类型选择正确的@标签格式,确保触发飞书的@通知效果。
运行时依赖
安装命令
点击复制技能文档
飞书消息 @ 提及
根据飞书消息类型选择正确的@标签格式。
- 普通文本消息(text)
@所有人
示例 { "content": "{\"text\":\"Tom 请查看此消息\"}" }
- 富文本消息(post)
在 content 数组中添加:
{"tag": "at", "user_id": "ou_xxxxxx", "user_name": "Tom"}
@所有人 {"tag": "at", "user_id": "all"}
示例 { "zh_cn": { "content": [ [ {"tag": "text", "text": "通知:"}, {"tag": "at", "user_id": "ou_xxxxxx", "user_name": "Tom"} ] ] } }
- 飞书卡片(interactive)
在卡片 Markdown 内容中使用:
@所有人
示例 { "elements": [ { "tag": "div", "text": { "content": "请处理任务", "tag": "lark_md" } } ] }
格式对比 消息类型 @指定用户 @所有人 关键点 普通文本 名字 需要 user_id 和用户名 富文本 {"tag":"at","user_id":"ou_xxx","user_name":"名字"} {"tag":"at","user_id":"all"} JSON 对象格式 卡片 使用 id(无引号),自闭合 获取 open_id
从对话元数据获取:
发送er_id: 发送者的 open_id(格式:ou_xxxxxxxx)
或通过 API 获取:
feishu_chat action=members chat_id=<群聊 ID> member_id_type="open_id"
注意事项 权限限制:自定义机器人仅支持使用 open_id@指定人,自建应用可使用 user_id、emAIl 等 @所有人限制:需群组开启相关权限,且机器人需为群主或管理员 格式严格:不同消息类型的@标签格式不可混用 open_id 格式:以 ou_ 开头 常见错误
❌ 在普通文本中使用卡片格式:
{"content": "{\"text\":\" 你好\"}"}
❌ 在卡片中使用普通文本格式:
{"content": "请Tom处理", "tag": "lark_md"}
❌ 富文本中使用错误的属性名:
{"tag": "at", "id": "ou_xxx"} // 应该是 user_id