会话标签页概述
会话标签页是指飞书客户端某一会话顶部的标签页,如下图所示。通过 OpenAPI 支持添加、删除、更新以及获取会话标签页等操作。

字段说明
| 名称 | 类型 | 描述 |
|---|---|---|
| chat_tabs | chat.tab[] | 会话标签页 注意:一个会话内最多可添加 20 个自定义会话标签页 |
| └ tab_name | string | 标签页名称 注意: 不能超过 30 个字符(最多 10 个汉字) |
| └ tab_type | string | 标签页类型 可选值有: - message:消息类型 - doc_list:云文档列表 - doc:文档 - pin:pin - meeting_minute:会议纪要 - chat_announcement:群公告 - url:url - file:文件 - files_resources:合并类型,包含文件、Doc 文档、URL 链接 - images_videos:合并类型,包含图片、视频 注意:调用添加会话标签页接口时,只支持添加 doc、url 类型的标签页。添加其他标签页需要在飞书客户端内操作,详情参见会话内标签页。 |
| └ tab_content | chat_tab_content | 会话标签页内容 |
| └└ url | string | url 类型对应的 URL 地址 |
| └└ doc | string | doc 类型对应的文档链接 |
| └└ meeting_minute | string | meeting_minute 类型对应的会议纪要链接 |
| └ tab_config | chat_tab_config | 会话标签页的配置 |
| └└ icon_key | string | 会话标签页的图标。 - 添加会话标签页时,需要先调用上传图片 接口,图片类型设置为 message 上传图片,然后获取 image_key 后传入当前参数。 - 获取会话标签页信息时,可调用下载图片(只能下载由当前机器人上传的图片),将图标下载至本地查看。 |
| └└ is_built_in | boolean | 会话标签页是否在 App 内嵌打开 |
数据示例
json
{
"chat_tabs": [
{
"tab_name": "文档",
"tab_type": "doc",
"tab_content": {
"url": "https://www.feishu.cn",
"doc": "https://example.feishu.cn/wiki/wikcnPIcqWjJQwkwDzrB9t40123xz",
"meeting_minute": "https://example.feishu.cn/docs/doccnvIXbV22i6hSD3utar4123dx"
},
"tab_config": {
"icon_key": "img_v2_b99741-7628-4abd-aad0-b881e4db83ig",
"is_built_in": false
}
}
]
}