接收消息内容

本文将说明从获取会话历史消息、获取指定消息的内容等接口中获得的各类型消息的 content 字段。

示例

Content 是 String 类型， JSON 结构的消息内容。

以文本类型消息为例，示例如下：

{
    "content": "{\"text\":\"文本消息\"}"
}

各类型消息 JSON 结构

文本 text

{
    "text": "文本消息"
}

文本消息中，超链接的格式为超链接文本，如：[飞书开放平台](www.feishu.cn)。特别地，对于邮箱类型的超链接，格式为邮箱文本。

富文本 post

{
    "title":"我是一个标题",
    "content":[
        [
            {
                "tag":"text",
                "text":"第一行 :"
            },
            {
                "tag":"a",
                "href":"http://www.feishu.cn",
                "text":"超链接"
            },
            {
                "tag":"at",
                "user_id":"@_user_1",
                "user_name":""
            }
        ],
        [
            {
                "tag":"img",
                "image_key":"img_47354fbc-a159-40ed-86ab-2ad0f1acb42g"
            }
        ],
        [
            {
                "tag":"text",
                "text":"第二行:"
            },
            {
                "tag":"text",
                "text":"文本测试"
            }
        ],
        [
            {
                "tag":"img",
                "image_key":"img_47354fbc-a159-40ed-86ab-2ad0f1acb42g"
            }
        ],
        [
            {
                "tag":"media",
                "file_key": "file_v2_0dcdd7d9-fib0-4432-a519-41d25aca542j",
                "image_key": "img_7ea74629-9191-4176-998c-2e603c9c5e8g"
            }
        ],
        [
            {
                "tag": "emotion",
                "emoji_type": "SMILE"
            }
        ]
    ]
}

富文本支持的标签和参数说明 :

text

字段	类型	描述
text	string	文本内容
un_escape	bool	表示是不是 unescape 解码

字段	类型	描述
text	string	链接显示的文本内容
href	string	链接地址

字段	类型	描述
user_id	string	被at用户的open_id
user_name	string	用户姓名

img

字段	类型	描述
image_key	string	图片的唯一标识

media

字段	类型	描述
file_key	string	视频文件的唯一标识
image_key	string	视频封面图片的唯一标识

emotion

字段	类型	描述
emoji_type	string	表情类型，所有可用表情参见表情文案

图片 image

{
    "image_key": "img_4adb3cc3-902b-4187-b0f1-842f67fd017g"
}

文件 file

{
    "file_key": "75235e0c-4f92-430a-a99b-8446610223cg",
    "file_name": "test.txt" // 文件名
}

文件夹 folder

{
    "file_key": "75235e0c-4f92-430a-a99b-8446610223cg",
    "file_name": "folder" //文件夹名称 
}

音频 audio

{
    "file_key": "75235e0c-4f92-430a-a99b-8446610223cg", // 文件key
    "duration": 2000                                    // 时长 毫秒级,
}

视频 media

{
    "file_key": "75235e0c-4f92-430a-a99b-8446610223cg",  // 文件key
    "image_key": "img_xxxxxx",                           // 视频封面图片key
    "file_name":"测试视频.mp4",                            // 文件名
    "duration": 2000                                     // 视频时长 毫秒级,
}

表情包 sticker

{
    "file_key": "75235e0c-4f92-430a-a99b-8446610223cg"
}

消息卡片 interactive

卡片结构各字段说明请参考卡片模块介绍。

{
    "title": "卡片标题",
    "elements": [
        [
            {
                "tag": "button",
                "text": "主按钮",
                "type": "primary"
            },
            {
                "tag": "button",
                "text": "次按钮",
                "type": "default"
            },
            {
                "tag": "button",
                "text": "危险按钮",
                "type": "danger"
            }
        ],
        [
            {
                "tag": "a",
                "href": "https://www.feishu.cn",
                "text": "飞书"
            },
            {
                "tag": "text",
                "text": "整合即时沟通、日历、音视频会议、云文档、云盘、工作台等功能于一体，成就组织和个人，"
            },
            {
                "tag": "at",
                "user_id": "@_user_1",
                "user_name": ""
            },
            {
                "tag": "text",
                "text": "更高效、更愉悦。"
            }
        ],
        [
            {
                "tag": "hr"
            }
        ],
        [
            {
                "tag": "text",
                "text": "图片标题"
            },
            {
                "tag": "img",
                "image_key": "img_acd8a194-3e63-49ca-bcf6-224624457a3g"
            }
        ],
        [
            {
                "tag": "note",
                "elements": [
                    {
                        "tag": "img",
                        "image_key": "img_acd8a194-3e63-49ca-bcf6-224624457a3g"
                    },
                    {
                        "tag": "text",
                        "text": "备注信息"
                    }
                ]
            }
        ],
        [
            {
                "tag": "text",
                "text": "深度整合使用率极高的办公工具，企业成员在一处即可实现高效沟通与协作。"
            },
            {
                "tag": "img",
                "image_key": "img_acd8a194-3e63-49ca-bcf6-224624457a3g"
            }
        ],
        [
            {
                "tag": "text",
                "text": "在移动端同样进行便捷的沟通、互动与协作，手机电脑随时随地保持同步。"
            },
            {
                "tag": "select_static",
                "options": [
                    "选项1",
                    "选项2",
                    "选项3",
                    "选项4"
                ],
                "placeholder": "默认提示文本"
            }
        ],
        [
            {
                "tag": "text",
                "text": "ISV产品接入及企业自主开发，更好地对接现有系统，满足不同组织的需求。"
            },
            {
                "tag": "overflow",
                "options": [
                    "打开飞书应用目录",
                    "打开飞书开发文档",
                    "打开飞书官网"
                ]
            }
        ],
        [
            {
                "tag": "text",
                "text": "国际权威安全认证与信息安全管理体系，为企业提供全生命周期安全保障。"
            },
            {
                "tag": "date_picker",
                "placeholder": "请选择日期",
                "initial_date": "2021-1-1"
            }
        ]
    ]
}

红包 hongbao

{
    "text": "[红包]"
}

日程

日程分享卡片 share_calendar_event

{
    "summary": "日程分享测试",
    "start_time": "1608265395000", // 毫秒级时间戳
    "end_time": "1608267015000"    // 毫秒级时间戳
}

日程邀请卡片 calendar

{
    "summary": "日程邀请测试",
    "start_time": "1608265395000", // 毫秒级时间戳
    "end_time": "1608267015000"    // 毫秒级时间戳
}

日程转让卡片/日程附言/切换日程所在日历 general_calendar

{
    "summary": "日程转让测试",
    "start_time": "1608265395000", // 毫秒级时间戳
    "end_time": "1608267015000"    // 毫秒级时间戳
}

群名片 share_chat

{
    "chat_id": "oc_0dd200d32fdaxxxxxxxx32f76"
}

个人名片 share_user

{
    "user_id": "ou_0dd200d32xxxxx6d2c2ef1ddb32f76" // 用户open_id
}

系统消息 system

{
        "template": "{from_user} invited {to_chatters} to this chat.",
        "from_user": ["botName"],
        "to_chatters": ["小明", "小王", "小红"]
}

位置 location

{
    "name": "xx省xx市",
    "longitude": "xxx.xxx",
    "latitude": "xxx.xxx"
}

视频通话 video_chat

{
    "topic": "视频通话消息",
    "start_time": "1623124523829" // 毫秒级时间戳
}

任务 todo

{
    "task_id": "acd096a5-a157-4b9d-80e2-5b317456f005",
    "summary": {"title":"","content":[[{"tag":"text","text":"多吃水果，多运动，健康生活，快乐工作。"}]]}, 
    "due_time": "1623124318000"
}

任务的参数说明 :

字段	类型	描述
task_id	string	任务ID，使用此ID可以对任务进行操作，详情参见任务概述
summary	post	富文本格式的任务标题
due_time	string	任务截止时间的毫秒级时间戳

投票 vote

{
    "topic": "投票测试",
    "options": ["选项1","选项2","选项3"]
}

投票的参数说明 :

字段	类型	描述
topic	string	投票主题
options	list	选项内容列表

示例#

各类型消息 JSON 结构#

文本 text#

富文本 post#

图片 image#

文件 file#

文件夹 folder#

音频 audio#

视频 media#

表情包 sticker#

消息卡片 interactive#

红包 hongbao#

日程#

日程分享卡片 share_calendar_event#

日程邀请卡片 calendar#

日程转让卡片/日程附言/切换日程所在日历 general_calendar#

群名片 share_chat#

个人名片 share_user#

系统消息 system#

位置 location#

视频通话 video_chat#

任务 todo#

投票 vote#

示例