# 会话标签页概述

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

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/367d6fb12bb5537cea5140a72d31f941_ubSnJ4Uknk.png?height=1602&lazyload=true&maxWidth=600&width=1840)

## 字段说明

名称 | 类型 | 描述
---|---|---
chat_tabs | chat.tab[] | 会话标签页<br>**注意**：一个会话内最多可添加 20 个自定义会话标签页
└ tab_name | string | 标签页名称<br>**注意**： 不能超过 30 个字符（最多 10 个汉字）
└ tab_type | string | 标签页类型<br>**可选值有**：<br>- message：消息类型<br>- doc_list：云文档列表<br>- doc：文档<br>- pin：pin<br>- meeting_minute：会议纪要<br>- chat_announcement：群公告<br>- url：url<br>- file：文件<br>- files_resources：合并类型，包含文件、Doc 文档、URL 链接<br>- images_videos：合并类型，包含图片、视频<br>**注意**：调用[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)接口时，只支持添加 doc、url 类型的标签页。添加其他标签页需要在飞书客户端内操作，详情参见[会话内标签页](https://www.feishu.cn/hc/zh-CN/articles/536850681075)。
└ 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 | 会话标签页的图标。<br>- 添加会话标签页时，需要先调用[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 接口，图片类型设置为 message 上传图片，然后获取 `image_key` 后传入当前参数。<br>- 获取会话标签页信息时，可调用[下载图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/get)（只能下载由当前机器人上传的图片），将图标下载至本地查看。
└└ 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
            }
        }
    ]
}
```