Skip to content

会话标签页概述

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

image.png

字段说明

名称类型描述
chat_tabschat.tab[]会话标签页 注意:一个会话内最多可添加 20 个自定义会话标签页
└ tab_namestring标签页名称 注意: 不能超过 30 个字符(最多 10 个汉字)
└ tab_typestring标签页类型 可选值有: - message:消息类型 - doc_list:云文档列表 - doc:文档 - pin:pin - meeting_minute:会议纪要 - chat_announcement:群公告 - url:url - file:文件 - files_resources:合并类型,包含文件、Doc 文档、URL 链接 - images_videos:合并类型,包含图片、视频 注意:调用添加会话标签页接口时,只支持添加 doc、url 类型的标签页。添加其他标签页需要在飞书客户端内操作,详情参见会话内标签页
└ tab_contentchat_tab_content会话标签页内容
└└ urlstringurl 类型对应的 URL 地址
└└ docstringdoc 类型对应的文档链接
└└ meeting_minutestringmeeting_minute 类型对应的会议纪要链接
└ tab_configchat_tab_config会话标签页的配置
└└ icon_keystring会话标签页的图标。 - 添加会话标签页时,需要先调用上传图片 接口,图片类型设置为 message 上传图片,然后获取 image_key 后传入当前参数。 - 获取会话标签页信息时,可调用下载图片(只能下载由当前机器人上传的图片),将图标下载至本地查看。
└└ is_built_inboolean会话标签页是否在 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
            }
        }
    ]
}

内容来源:飞书开放平台 · 自动爬取整理