飞书消息 @ 提及

根据飞书消息类型选择正确的@标签格式。

1. 普通文本消息（text）

@指定用户

id=ouxxxxxxxx>用户名

@所有人

示例

json
{
content: {\text\:\id=\\\ouxxxxxxxx\\\>Tom 请查看此消息\}
}

2. 富文本消息（post）

@指定用户

在 content 数组中添加：

json
{tag: at, userid: ouxxxxxx, user_name: Tom}

@所有人

json
{tag: at, user_id: all}

示例

json
{
zh_cn: {
content: [
[
{tag: text, text: 通知:},
{tag: at, userid: ouxxxxxx, user_name: Tom}
]
]
}
}

3. 飞书卡片（interactive）

@指定用户

在卡片 Markdown 内容中使用：

@所有人

示例

json
{
elements: [
{
tag: div,
text: {
content: 请处理任务,
tag: lark_md
}
}
]
}

格式对比

获取 open_id

从对话元数据获取：

• - senderid: 发送者的 openid（格式：ou_xxxxxxxx）

或通过 API 获取：
bash
feishuchat action=members chatid=<群聊 ID> memberidtype=open_id

注意事项

1. 1. 权限限制：自定义机器人仅支持使用 openid@指定人，自建应用可使用 userid、email 等
2. @所有人限制：需群组开启相关权限，且机器人需为群主或管理员
3. 格式严格：不同消息类型的@标签格式不可混用
4. openid 格式：以 ou 开头

常见错误

❌ 在普通文本中使用卡片格式：
json
{content: {\text\:\ 你好\}}

❌ 在卡片中使用普通文本格式：
json
{content: 请id=\ouxxx\>Tom处理, tag: lark_md}

❌ 富文本中使用错误的属性名：
json
{tag: at, id: ouxxx} // 应该是 userid