{"code":0,"msg":"succeeded","data":{"redirectUri":"/server-docs/im-v1/message-content-description/create_json","directoryId":"6946222931480297473","updateTime":1749711792000,"name":"发送消息内容结构","templateName":"","keywords":["发送消息","消息"],"content":"# 发送消息内容结构\n\n本文介绍[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)、[回复消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/reply)、[编辑消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/update)接口中各消息类型（`msg_type`）对应的消息内容（`content`）应如何构造。\n\n\n## 注意事项\n\n- 本文提供的示例代码中所有的 `receive_id`（消息接收者 ID）、`user_id`（用户的 user_id）、`image_key`（上传图片后获取到的图片标识 key）、`file_key`（上传文件后获取到的文件标识 Key） 等参数值均为示例数据。你在实际开发过程中，需要替换为真实可用的数据。\n- 本文提供的内容构造示例，仅适用于[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)、[回复消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/reply)、[编辑消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/update)接口，不适用于[批量发送消息](/ssl:ttdoc/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)接口和消息的各历史版本接口。\n- 本文不适用于自定义机器人，自定义机器人使用方式需参考[自定义机器人使用指南](/ssl:ttdoc/ukTMukTMukTM/ucTM5YjL3ETO24yNxkjN)。\n\n\n## 消息内容介绍\n\n在 **发送消息**、**回复消息**、**编辑消息** 接口中，均需要传入消息内容（`content`），不同的消息类型对应的 `content` 也不相同。以文本类型的消息为例，请求体示例如下：\n\n```json\n{\n    \"receive_id\": \"ou_7d8a6e6df7621556ce0d21922b676706ccs\",\n    \"content\": \"{\\\"text\\\":\\\" test content\\\"}\",\n    \"msg_type\": \"text\"\n}\n```\n\n:::note\n**注意**：`content` 字段为 string 类型，JSON 结构需要先进行转义再传值。在调用接口时，你可以先构造一个结构体，然后使用 JSON 序列化转换为 string 类型，或者通过第三方的 JSON 转换工具进行转义。\n:::\n\n\n## 各类型的消息内容 JSON 结构\n\n消息类型包括文本、富文本、卡片、名片、音频、视频以及文件等多种类型，本章节将介绍各类型消息对应的内容如何构造。\n\n### 文本 text\n\n**内容示例**\n\n```json \n{\n    \"text\": \"test content\"\n}\n``` \n\n**参数说明**\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>text</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>文本内容。\n  \n**示例值**：test content</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n**[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)请求体示例**\n\n```json \n{\n    \"receive_id\": \"ou_7d8a6e6df7621556ce0d21922b67670xxxx\",\n    \"content\": \"{\\\"text\\\":\\\"test content\\\"}\",\n    \"msg_type\": \"text\"\n}\n``` \n\n#### 支持换行符\n\n如果需要在文本中换行，可使用 `\\n` 换行符。请求体示例如下（注意内容需要转义）：\n\n```json \n{\n    \"receive_id\": \"oc_xxx\",\n    \"content\": \"{\\\"text\\\":\\\"firstline \\\\n secondline \\\"}\",\n    \"msg_type\": \"text\"\n}\n``` \n\n#### 支持 @ 用户、@ 所有人\n\n```json \n// @ 单个用户\n<at user_id=\"ou_xxxxxxx\">用户名（可不填）</at>\n// @ 所有人\n<at user_id=\"all\"></at>\n``` \n\n- @ 单个用户时，`user_id` 字段必须填入用户的 open_id，union_id 或 user_id 来 @ 指定人。请确保 ID 为有效值，ID 获取方式参考[如何获取 User ID、Open ID 和 Union ID？](/ssl:ttdoc/home/user-identity-introduction/open-id)。\n- @ 所有人时，`user_id` 取值为 `all`，并且需要注意所在群必须开启了 @ 所有人功能。\n- 此处的语法与卡片消息（[消息卡片 Markdown](/ssl:ttdoc/ukTMukTMukTM/uADOwUjLwgDM14CM4ATN#abc9b025)、[飞书卡片 Markdown](/ssl:ttdoc/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-components/content-components/rich-text)） @ 指定人的语法不同，请注意区分。\n\n文本消息 @ 用法示例：\n\n\n```json \n{\n    \"receive_id\": \"oc_xxx\",\n    \"content\": \"{\\\"text\\\":\\\"<at user_id=\\\\\\\"ou_xxxxxxx\\\\\\\">Tom</at> text content\\\"}\",\n    \"msg_type\": \"text\"\n} \n```\n\n\n消息发送后的效果如下图：\n\n![未标题-1.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/d0067a61fadc30a09d987e43af20b930_zFF2OgzaOZ.png?height=448&lazyload=true&maxWidth=400&width=652)\n\n#### 支持部分样式标签\n\n支持加粗、斜体、下划线、删除线四种样式（可嵌套使用）：\n- **加粗**：`<b>文本示例</b>`       \n- *斜体*：`<i>文本示例</i>`\n- _下划线_：`<u>文本示例</u>`\n- ~~删除线~~：`<s>文本示例</s>`\n\n:::warning\n**注意**：\n- 请保证首尾标签对应、嵌套正确，如有首尾标签缺失、嵌套层级错误等情况，会以原始内容发送消息。\n- 标签信息会大幅增加消息体的大小，请酌情使用。\n- 该能力暂不支持[自定义机器人](/ssl:ttdoc/ukTMukTMukTM/ucTM5YjL3ETO24yNxkjN)和[批量发送消息](/ssl:ttdoc/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)接口。\n:::\n\n样式标签使用示例：\n```json \n{\n    \"receive_id\": \"oc_xxx\",\n    \"content\": \"{\\\"text\\\":\\\"<b>bold content<i>, bold and italic content</i></b>\\\"}\",\n    \"msg_type\": \"text\"\n}\n``` \n\n消息发送后效果如下图：\n\n\n![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/11f5004aaaaf02ee90b625311df6d824_JV9jdvPcsy.png?height=126&lazyload=true&maxWidth=400&width=896)\n\n#### 支持超链接\n\n超链接的使用格式为 `[文本](链接)`， 如 `[Feishu Open Platform](https://open.feishu.cn)` 。\n\n:::warning\n**注意**：\n- `[文本]` 中不支持 `[]` 多层嵌套使用，此外，若文本中含有其他 `[` 或 `]` 字符，请确保前后符号匹配，否则可能导致超链接识别异常。\n- 请确保链接是合法的，否则会以原始内容发送消息。\n- 该能力暂不支持[自定义机器人](/ssl:ttdoc/ukTMukTMukTM/ucTM5YjL3ETO24yNxkjN)和[批量发送消息](/ssl:ttdoc/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)接口。\n:::\n\n超链接使用示例：\n```json \n{\n    \"receive_id\": \"oc_xxx\",\n    \"content\": \"{\\\"text\\\":\\\"[Feishu Open Platform](https://open.feishu.cn)\\\"}\",\n    \"msg_type\": \"text\"\n}\n``` \n\n消息发送后效果如下图：\n\n\n![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/b2e2f8e6a7f2169ca88ec2434e2c255f_TNCcXir3DK.png?height=218&lazyload=true&maxWidth=400&width=936)\n\n\n\n### 富文本 post\n\n在一条富文本消息中，支持添加文字、图片、视频、@、超链接等元素。如下 JSON 格式的内容是一个富文本示例，其中：\n\n- 一个富文本可分多个段落（由多个 `[]` 组成），每个段落可由多个元素组成，每个元素由 tag 和相应的描述组成。\n- 图片、视频元素必须是独立的一个段落。\n- `style` 字段暂不支持[自定义机器人](/ssl:ttdoc/ukTMukTMukTM/ucTM5YjL3ETO24yNxkjN)和[批量发送消息](/ssl:ttdoc/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)接口。\n- 实际发送消息时，需要将 JSON 格式的内容压缩为一行、并进行转义。\n- 如需参考该 JSON 示例构建富文本消息内容，则需要把其中的 user_id、image_key、file_key 等示例值替换为真实值。\n\n\n```json \n{\n\t\"zh_cn\": {\n\t\t\"title\": \"我是一个标题\",\n\t\t\"content\": [\n\t\t\t[\n\t\t\t\t{\n\t\t\t\t\t\"tag\": \"text\",\n\t\t\t\t\t\"text\": \"第一行:\",\n\t\t\t\t\t\"style\": [\"bold\", \"underline\"]\n                  \n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"tag\": \"a\",\n\t\t\t\t\t\"href\": \"http://www.feishu.cn\",\n\t\t\t\t\t\"text\": \"超链接\",\n\t\t\t\t\t\"style\": [\"bold\", \"italic\"]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"tag\": \"at\",\n\t\t\t\t\t\"user_id\": \"ou_1avnmsbv3k45jnk34j5\",\n\t\t\t\t\t\"style\": [\"lineThrough\"]\n\t\t\t\t}\n\t\t\t],\n          \t[{\n\t\t\t\t\"tag\": \"img\",\n\t\t\t\t\"image_key\": \"img_7ea74629-9191-4176-998c-2e603c9c5e8g\"\n\t\t\t}],\n\t\t\t[\t\n\t\t\t\t{\n\t\t\t\t\t\"tag\": \"text\",\n\t\t\t\t\t\"text\": \"第二行:\",\n\t\t\t\t\t\"style\": [\"bold\", \"underline\"]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"tag\": \"text\",\n\t\t\t\t\t\"text\": \"文本测试\"\n\t\t\t\t}\n\t\t\t],\n          \t[{\n\t\t\t\t\"tag\": \"img\",\n\t\t\t\t\"image_key\": \"img_7ea74629-9191-4176-998c-2e603c9c5e8g\"\n\t\t\t}],\n          \t[{\n\t\t\t\t\"tag\": \"media\",\n\t\t\t\t\"file_key\": \"file_v2_0dcdd7d9-fib0-4432-a519-41d25aca542j\",\n\t\t\t\t\"image_key\": \"img_7ea74629-9191-4176-998c-2e603c9c5e8g\"\n\t\t\t}],\n          \t[{\n\t\t\t\t\"tag\": \"emotion\",\n\t\t\t\t\"emoji_type\": \"SMILE\"\n\t\t\t}],\n\t\t\t[{\n\t\t\t\t\"tag\": \"hr\"\n\t\t\t}],\n\t\t\t[{\n\t\t\t\t\"tag\": \"code_block\",\n\t\t\t\t\"language\": \"GO\",\n\t\t\t\t\"text\": \"func main() int64 {\\n    return 0\\n}\"\n\t\t\t}],\n\t\t\t[{\n\t\t\t\t\"tag\": \"md\",\n\t\t\t\t\"text\": \"**mention user:**<at user_id=\\\"ou_xxxxxx\\\">Tom</at>\\n**href:**[Open Platform](https://open.feishu.cn)\\n**code block:**\\n```GO\\nfunc main() int64 {\\n    return 0\\n}\\n```\\n**text styles:** **bold**, *italic*, ***bold and italic***, ~underline~,~~lineThrough~~\\n> quote content\\n\\n1. item1\\n    1. item1.1\\n    2. item2.2\\n2. item2\\n --- \\n- item1\\n    - item1.1\\n    - item2.2\\n- item2\"\n\t\t\t}]\n\t\t]\n\t},\n\t\"en_us\": {\n\t\t...\n\t}\n}\n``` \n\n**参数说明**\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>zh_cn, en_us</md-td>\n<md-td>object</md-td>\n<md-td>是</md-td>\n<md-td>多语言配置字段。如果不需要配置多语言，则仅配置一种语言即可。\n  \n- `zh_cn` 为富文本的中文内容\n- `en_us` 为富文本的英文内容\n \n**注意**：该字段无默认值，至少要设置一种语言。\n  \n**示例值**：zh_cn</md-td>\n</md-tr>\n\n<md-tr>\n<md-td>∟ title</md-td>\n<md-td>string</md-td>\n<md-td>否</md-td>\n<md-td>富文本消息的标题。\n  \n**默认值**：空\n  \n**示例值**：title</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>∟ content</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>富文本消息内容。由多个段落组成（段落由`[]`分隔），每个段落为一个 node 列表，所支持的 node 标签类型以及对应的参数说明，参见下文的 **富文本支持的标签和参数说明** 章节。\n  \n**注意**：如 **示例值** 所示，各类型通过 tag 参数设置。例如文本（text）设置为 `\"tag\": \"text\"`。\n  \n**示例值**：[[{\"tag\": \"text\",\"text\": \"text content\"}]]\n</md-td>\n</md-tr>\n  \n\n</md-tbody>\n</md-table>\n:::\n\n\n#### **富文本支持的标签和参数说明**\n\n- **text：文本标签**\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>text</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>文本内容。\n  \n**示例值**：test content</md-td>\n</md-tr>\n\n<md-tr>\n<md-td>un_escape</md-td>\n<md-td>boolean</md-td>\n<md-td>否</md-td>\n<md-td>是否 unescape 解码。默认为 false，无需使用可不传值。\n  \n**示例值**：false</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>style</md-td>\n<md-td>[]string\t</md-td>\n<md-td>否</md-td>\n<md-td>文本内容样式，支持的样式有：\n  \n- bold：加粗\n- underline：下划线\n- lineThrough：删除线\n- italic：斜体\n\n**注意**：\n- 默认值为空，表示无样式。\n- 传入的值如果不是以上可选值，则被忽略。\n  \n**示例值**：[\"bold\", \"underline\"]\n</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n-  **a：超链接标签**\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>text</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>超链接的文本内容。\n  \n**示例值**：超链接</md-td>\n</md-tr>\n\n<md-tr>\n<md-td>href</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>超链接地址。\n  \n**注意**：请确保链接地址的合法性，否则消息会发送失败。\n  \n**示例值**：https://open.feishu.cn</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>style</md-td>\n<md-td>[]string\t</md-td>\n<md-td>否</md-td>\n<md-td>超链接文本内容样式，支持的样式有：\n  \n- bold：加粗\n- underline：下划线\n- lineThrough：删除线\n- italic：斜体\n\n**注意**：\n- 默认值为空，表示无样式。\n- 传入的值如果不是以上可选值，则被忽略。\n  \n**示例值**：[\"bold\", \"italic\"]\n</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n- **at：@标签**\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>user_id</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>用户 ID，用来指定被 @ 的用户。传入的值可以是用户的 user_id、open_id、union_id。各类 ID 获取方式参见[如何获取 User ID、Open ID 和 Union ID](/ssl:ttdoc/home/user-identity-introduction/open-id)。\n  \n**注意**：\n  \n- @ 单个用户时，该字段必须传入实际用户的真实 ID。\n- 如需 @ 所有人，则该参数需要传入 `all`。</md-td>\n</md-tr>\n\n<md-tr>\n<md-td>style</md-td>\n<md-td>[]string</md-td>\n<md-td>否</md-td>\n<md-td>at 文本内容样式，支持的样式有：\n  \n- bold：加粗\n- underline：下划线\n- lineThrough：删除线\n- italic：斜体\n\n**注意**：\n- 默认值为空，表示无样式。\n- 传入的值如果不是以上可选值，则被忽略。\n  \n**示例值**：[\"lineThrough\"]</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n\n- **img：图片标签**\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>image_key</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>图片 Key。通过[上传图片](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口可以获取到图片 Key（image_key）。\n  \n**示例值**：d640eeea-4d2f-4cb3-88d8-c964fab53987</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n\n- **media：视频标签**\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>file_key</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>视频文件的 Key。通过[上传文件](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)接口上传视频（mp4 格式）后，可以获取到视频文件 Key（file_key）。\n  \n**示例值**：file_v2_0dcdd7d9-fib0-4432-a519-41d25aca542j</md-td>\n</md-tr>\n\n<md-tr>\n<md-td>image_key</md-td>\n<md-td>string</md-td>\n<md-td>否</md-td>\n<md-td>视频封面图片的 Key。通过[上传图片](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口可以获取到图片 Key（image_key）。\n  \n**默认值**：空，表示无视频封面。\n\n**示例值**：img_7ea74629-9191-4176-998c-2e603c9c5e8g</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n- **emotion：表情标签**\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>emoji_type</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>表情文案类型。可选值参见[表情文案说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce)。\n  \n**示例值**：SMILE</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n- **code_block：代码块标签**\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>language</md-td>\n<md-td>string</md-td>\n<md-td>否</md-td>\n<md-td>代码块的语言类型。可选值有 PYTHON、C、CPP、GO、JAVA、KOTLIN、SWIFT、PHP、RUBY、RUST、JAVASCRIPT、TYPESCRIPT、BASH、SHELL、SQL、JSON、XML、YAML、HTML、THRIFT 等。\n  \n**注意**：\n- 取值不区分大小写。\n- 不传值则默认为文本类型。\n  \n**示例值**：GO</md-td>\n</md-tr>\n\n<md-tr>\n<md-td>text</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>代码块内容。\n  \n**示例值**：func main() int64 {\\n return 0\\n}</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n\n- **hr：分割线标签**\n\n富文本支持 `tag` 取值为 `hr`，表示一条分割线，该标签内无其他参数。\n\n\n- **md：Markdown 标签**\n\n:::warning\n**注意**：\n- `md` 标签会独占一个或多个段落，不能与其他标签在同一行。\n- `md` 标签仅支持发送，[获取消息内容](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/get)时将不再包含此标签，会根据 `md` 中的内容转换为其他相匹配的标签。\n- 引用、有序、无序列表在获取消息内容时，会简化为文本标签（text）进行输出。\n:::\n\n`md` 标签内通过 `text` 参数设置 Markdown 内容。\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>text</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>Markdown 内容。支持的内容参见下表。\n  \n**示例值**：1. item1\\n2. item2</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n在 `text` 参数内支持的语法如下表所示。\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">语法</md-th>\n<md-th style=\"width:40%\">示例</md-th>\n<md-th style=\"width:40%\">说明</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>@ 用户</md-td>\n<md-td>`<at user_id=\"ou_xxxxx\">User</at>`</md-td>\n<md-td>\n支持 @ 单个用户或所有人。\n  \n- @ 单个用户时，需要在 user_id 内传入实际用户的真实 ID。传入的值可以是用户的 user_id、open_id、union_id。各类 ID 获取方式参见[如何获取 User ID、Open ID 和 Union ID](/ssl:ttdoc/home/user-identity-introduction/open-id)。\n- 如需 @ 所有人，需要将 user_id 取值为 `all`。\n</md-td>\n</md-tr>\n\n<md-tr>\n<md-td>超链接</md-td>\n<md-td>`[Feishu Open Platform](https://open.feishu.cn)`</md-td>\n<md-td>\n在 Markdown 语法内，`[]` 用来设置超链接的文本内容、`()` 用来设置超链接的地址。  \n  \n**注意**：请确保链接地址的合法性，否则只发送文本内容部分。\n</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>有序列表</md-td>\n<md-td>`1. item1\\n2. item2`</md-td>\n<md-td>\nMarkdown 配置说明：\n\n- 每个编号的 `.` 符与后续内容之间要有一个空格。\n- 每一列独立一行。如示例所示，可使用 `\\n` 换行符换行。\n- 支持嵌套多层级。\n  - 每个层级缩进 4 个空格，且编号均从 `1.` 开始。\n  - 可以与无序列表混合使用。\n</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>无序列表</md-td>\n<md-td>`- item1\\n- item2`</md-td>\n<md-td>\nMarkdown 配置说明：\n\n- 每列的 `-` 符与后续内容之间要有一个空格。\n- 每一列独立一行。如示例所示，可使用 `\\n` 换行符换行。\n- 支持嵌套多层级。\n  - 每个层级缩进 4 个空格。\n  - 可以与有序列表混合使用，有序列表以 `1.` 开始编号。\n</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>代码块</md-td>\n<md-td>\\`\\`\\`GO\\nfunc main(){\\n return\\n}\\n\\`\\`\\`</md-td>\n<md-td>\n代码块内容首尾需要使用 \\`\\`\\` 符号包裹，首部 \\`\\`\\` 后紧跟代码语言类型。支持的语言类型有 PYTHON、C、CPP、GO、JAVA、KOTLIN、SWIFT、PHP、RUBY、RUST、JAVASCRIPT、TYPESCRIPT、BASH、SHELL、SQL、JSON、XML、YAML、HTML、THRIFT 等（不区分大小写）。\n</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>引用</md-td>\n<md-td>`> demo`</md-td>\n<md-td>\n引用内容。`>` 符与后续内容之间要有一个空格。  \n</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>分割线</md-td>\n<md-td>`\\n --- \\n`</md-td>\n<md-td>如示例所示，前后需要各有一个 `\\n` 换行符。</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>加粗</md-td>\n<md-td>`**加粗文本**`</md-td>\n<md-td>配置说明：\n\n- `**` 符与加粗文本之间不能有空格。\n- 加粗可以与斜体合用。例如 `***加粗+斜体***`。\n- 加粗的文本不支持再解析其他组件。例如文本为超链接则不会被解析。\n</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>斜体</md-td>\n<md-td>`*斜体文本*`</md-td>\n<md-td>配置说明：\n  \n- `*` 符与加粗文本之间不能有空格。\n- 斜体可以与加粗合用。例如 `***加粗+斜体***`。\n- 斜体的文本不支持再解析其他组件。例如文本为超链接则不会被解析。</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>下划线</md-td>\n<md-td>`~下划线文本~`</md-td>\n<md-td>\n配置说明：\n  \n- `~` 符与下划线文本之间不能有空格。\n- 下划线的文本不支持再解析其他组件。例如文本为超链接则不会被解析。\n- 不支持与加粗、斜体、删除线合用。\n</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>删除线</md-td>\n<md-td>`~~删除线~~`</md-td>\n<md-td>配置说明：\n  \n- `~~` 符与下划线文本之间不能有空格。\n- 删除线的文本不支持再解析其他组件。例如文本为超链接则不会被解析。\n- 不支持与加粗、斜体、下划线合用。</md-td>\n</md-tr>\n \n\n</md-tbody>\n</md-table>\n:::\n\n[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)时的请求体示例：\n\n```json \n{\n\t\"receive_id\": \"oc_820faa21d7ed275b53d1727a0feaa917\",\n\t\"content\": \"{\\\"zh_cn\\\":{\\\"title\\\":\\\"我是一个标题\\\",\\\"content\\\":[[{\\\"tag\\\":\\\"text\\\",\\\"text\\\":\\\"第一行 :\\\"},{\\\"tag\\\":\\\"a\\\",\\\"href\\\":\\\"http://www.feishu.cn\\\",\\\"text\\\":\\\"超链接\\\"},{\\\"tag\\\":\\\"at\\\",\\\"user_id\\\":\\\"ou_1avnmsbv3k45jnk34j5\\\",\\\"user_name\\\":\\\"tom\\\"}],[{\\\"tag\\\":\\\"img\\\",\\\"image_key\\\":\\\"img_7ea74629-9191-4176-998c-2e603c9c5e8g\\\"}],[{\\\"tag\\\":\\\"text\\\",\\\"text\\\":\\\"第二行:\\\"},{\\\"tag\\\":\\\"text\\\",\\\"text\\\":\\\"文本测试\\\"}],[{\\\"tag\\\":\\\"img\\\",\\\"image_key\\\":\\\"img_7ea74629-9191-4176-998c-2e603c9c5e8g\\\"}]]}}\",\n\t\"msg_type\": \"post\"\n}\n``` \n\n发送后的效果图：\n\n![未标题-2.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/e774788f106baf2eb5d3227a545b3246_Lq95B5zSFw.png?height=902&lazyload=true&maxWidth=300&width=672)\n\n\n### 图片 image\n\n**内容示例**\n\n```json \n{\n    \"image_key\": \"img_7ea74629-9191-4176-998c-2e603c9c5e8g\"\n}\n``` \n**参数说明** \n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>image_key</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>图片 Key，通过[上传图片](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口可获取到图片 Key（image_key）。\n  \n**示例值**：img_7ea74629-9191-4176-998c-2e603c9c5e8g</md-td>\n</md-tr>\n\n\n</md-tbody>\n</md-table>\n:::\n\n\n\n**[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)请求体示例**\n\n```json \n{\n\t\"receive_id\": \"oc_xxx\",\n\t\"content\": \"{\\\"image_key\\\": \\\"img_v2_xxx\\\"}\",\n\t\"msg_type\": \"image\"\n} \n``` \n\n消息发送后的效果如下图：\n\n\n![未标题-3.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/a8db03920c6434899e9e8dca6e9ab47d_HazoJPFumr.png?height=250&lazyload=true&maxWidth=300&width=628)\n\n***\n\n### 卡片 interactive\n\n飞书卡片是一种可以灵活构建图文内容的消息类型，你可以通过[可视化搭建工具](/ssl:ttdoc/uAjLw4CM/ukzMukzMukzM/feishu-cards/feishu-card-cardkit/feishu-cardkit-overview)或者 [卡片 JSON](/ssl:ttdoc/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-structure)定义样式精美、可交互的卡片内容。\n\n:::note\n\n如果你使用的是历史版本的 ==发送消息卡片==(`/open-apis/message/v4/send/`) 接口，请求体中的 `content` 参数需要换成 `card`。如果使用[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)接口，消息请求体的内容参数已统一为 `content`。\n:::\n\n**[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)请求体示例**\n\n以下提供了卡片的多种发送方式，详细说明可参见[发送卡片](/ssl:ttdoc/uAjLw4CM/ukzMukzMukzM/feishu-cards/send-feishu-card)。\n\n- **方式一：使用卡片实体 ID 发送**\n\n\t\n\t通过卡片实体 ID 发送卡片适用于需要局部更新卡片或实现流式更新卡片的场景。详情参考[流式更新 OpenAPI 调用指南](/ssl:ttdoc/uAjLw4CM/ukzMukzMukzM/feishu-cards/streaming-updates-openapi-overview)。\n   \n   :::note\n   卡片实体 ID 是卡片实体的唯一标识，需通过调用[创建卡片实体](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card/create)接口获取。\n   :::\n   示例请求体如下所示：\n  ```json\n  {\n      \"receive_id\": \"ou_449b53ad6aee526f7ed311b216aabcef\",\n      \"msg_type\": \"interactive\",\n      \"content\": \"{\\\"type\\\":\\\"card\\\",\\\"data\\\":{\\\"card_id\\\":\\\"7371713483664506900\\\"}}\"\n  }\n  ```\n\n- **方式二：使用卡片模板 `template_id` 发送**\n  \n  通过[卡片搭建工具](https://open.feishu.cn/cardkit?from=open_docs_tool_overview)搭建好卡片后，通过卡片的 `template_id` 发送卡片。\n  :::note\n  使用模板 `template_id` 发送卡片的方式支持使用卡片变量，动态控制卡片内容。\n  :::\n  示例请求体如下所示：\n  ```json\n  {\n    \"receive_id\": \"ou_449b53ad6aee526f7ed311b216aabcef\",\n    \"msg_type\": \"interactive\",\n    \"content\": \"{\\\"type\\\":\\\"template\\\",\\\"data\\\":{\\\"template_id\\\":\\\"xxxxxxxxxxxx\\\",\\\"template_version_name\\\":\\\"1.0.0\\\",\\\"template_variable\\\":{\\\"key1\\\":\\\"value1\\\",\\\"key2\\\":\\\"value2\\\"}}}\"\n  }\n  ```\n\n\n  其中，`content` 包含的参数配置说明如下表所示。\n\n\n  :::html\n          <md-table> \n            <md-thead> \n              <md-tr> \n                <md-th style=\"width: 20%;\">参数</md-th> \n                <md-th style=\"width:15%\">类型</md-th>\n                <md-th style=\"width: 10%;\">必填</md-th>  \n                <md-th>说明</md-th> \n              </md-tr> \n            </md-thead>  \n            <md-tbody> \n\n\n              <md-tr>\n              <md-td>\n              type\n            </md-td>\n                <md-td>string</md-td>\n             <md-td>否</md-td>\n         <md-td>\n          卡片类型。要发送由搭建工具搭建的卡片（也称卡片模板），固定取值为 `template`。\n         </md-td>\n           </md-tr>\n                  <md-tr>\n         <md-td>\n            data\n         </md-td>\n                    <md-td>object</md-td>\n         <md-td>否</md-td>\n         <md-td>\n          卡片模板的数据，要发送由搭建工具搭建的卡片，此处需传入卡片模板 ID、卡片版本号等。\n         </md-td>\n         </md-tr>\n                   <md-tr>\n                 <md-td>\n           └ template_id\n               </md-td>\n                     <md-td>string</md-td>\n          <md-td>是</md-td>\n          <md-td>\n            搭建工具中创建的卡片（也称卡片模板）的 ID，如 `AAqigYkzabcef`。可在搭建工具中通过复制卡片模板 ID 获取。 \n\n  ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/8bf97ff2bceed633b28f5ce2d2ec0270_A9kv4I1t3s.png?height=329&lazyload=true&maxWidth=500&width=1574)\n\n          </md-td>\n         </md-tr>\n\n                              <md-tr> \n                <md-td>\n                  └ template_version_name \n              </md-td>  \n                                <md-td>string</md-td>\n              <md-td>否</md-td>  \n              <md-td>\n                                  搭建平台中创建的卡片的版本号，如 `1.0.0`。卡片发布后，将生成版本号。可在搭建工具 **版本管理** 处获取。\n\n  ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/b3e96c8ca7c5c029bdbce6c0ca1ba413_IR0ZCAj7uz.png?height=384&lazyload=true&maxWidth=500&width=1459)\n            <br>**注意**：\n              若不填此字段，将默认使用该卡片的最新版本。\n              </md-td> \n              </md-tr> \n                <md-tr> \n                <md-td>\n                  └ template_variable \n              </md-td>  \n                  <md-td>object</md-td>\n              <md-td>否</md-td>  \n              <md-td>\n     若卡片绑定了变量，你需在该字段中传入实际变量数据的值。\n                \n   **示例**：如果变量名称在搭建工具中被定义为 `open_id`，此处需要对 `open_id` 变量传入值：\n\n  ```json\n  {\n      \"open_id\": \"ou_d506829e8b6a17607e56bcd6b1aabcef\"\n  }\n  ```\n\n              </md-td> \n              </md-tr> \n            </md-tbody> \n          </md-table>\n\n  :::\n\n\n\n<br>\n- **方式三：使用卡片 JSON 发送**\n\n  通过[卡片搭建工具](https://open.feishu.cn/cardkit?from=open_docs_tool_overview)搭建好卡片后，复制卡片源代码获取卡片 JSON，然后将卡片源代码进行压缩并转义，再传入 `content` 参数中发送卡片。\n  \n  :::note\n  使用 JSON 发送卡片的方式不支持传入卡片变量。\n\t:::\n  \n\t![b9d86d57c25f51570909a23ebc43026a_h4kayeS9dl.gif](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/b9d86d57c25f51570909a23ebc43026a_QEwsOFPWe5.gif?height=872&lazyload=true&width=1914)\n\n\t示例请求体如下所示：\n    ```json \n    {\n      \"receive_id\": \"ou_449b53ad6aee526f7ed311b216aabcef\",\n      \"msg_type\": \"interactive\",\n      \"content\": \"{\\\"schema\\\":\\\"2.0\\\",\\\"config\\\":{\\\"update_multi\\\":true,\\\"style\\\":{\\\"text_size\\\":{\\\"normal_v2\\\":{\\\"default\\\":\\\"normal\\\",\\\"pc\\\":\\\"normal\\\",\\\"mobile\\\":\\\"heading\\\"}}}},\\\"body\\\":{\\\"direction\\\":\\\"vertical\\\",\\\"padding\\\":\\\"12px 12px 12px 12px\\\",\\\"elements\\\":[{\\\"tag\\\":\\\"markdown\\\",\\\"content\\\":\\\"西湖，位于中国浙江省杭州市西湖区龙井路1号，杭州市区西部，汇水面积为21.22平方千米，湖面面积为6.38平方千米。\\\",\\\"text_align\\\":\\\"left\\\",\\\"text_size\\\":\\\"normal_v2\\\",\\\"margin\\\":\\\"0px 0px 0px 0px\\\"},{\\\"tag\\\":\\\"button\\\",\\\"text\\\":{\\\"tag\\\":\\\"plain_text\\\",\\\"content\\\":\\\"🌞更多景点介绍\\\"},\\\"type\\\":\\\"default\\\",\\\"width\\\":\\\"default\\\",\\\"size\\\":\\\"medium\\\",\\\"behaviors\\\":[{\\\"type\\\":\\\"open_url\\\",\\\"default_url\\\":\\\"https://baike.baidu.com/item/%E8%A5%BF%E6%B9%96/4668821\\\",\\\"pc_url\\\":\\\"\\\",\\\"ios_url\\\":\\\"\\\",\\\"android_url\\\":\\\"\\\"}],\\\"margin\\\":\\\"0px 0px 0px 0px\\\"}]},\\\"header\\\":{\\\"title\\\":{\\\"tag\\\":\\\"plain_text\\\",\\\"content\\\":\\\"今日旅游推荐\\\"},\\\"subtitle\\\":{\\\"tag\\\":\\\"plain_text\\\",\\\"content\\\":\\\"\\\"},\\\"template\\\":\\\"blue\\\",\\\"padding\\\":\\\"12px 12px 12px 12px\\\"}}\"\n    } \n    ``` \n\n  消息发送后的效果如下图：\n\n\n  ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/42498546edb8dd2feb32ac2027a8507a_iNml1LSHNG.png?height=283&lazyload=true&maxWidth=500&width=766)\n\n\n\n### 分享群名片 share_chat\n\n**内容示例**\n\n```json \n{\n    \"chat_id\": \"oc_0dd200d32fda15216d2c2ef1ddb32f76\"\n}\n``` \n\n**参数说明** \n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>chat_id</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>群 ID。获取方式参见[群ID 说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)。\n  \n**示例值**：oc_0dd200d32fda15216d2c2ef1ddb32f76</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n**[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)请求体示例**\n\n```json \n {\n\t\"receive_id\": \"oc_xxx\",\n\t\"content\": \"{\\\"chat_id\\\":\\\"oc_xxx\\\"}\",\n\t\"msg_type\": \"share_chat\"\n}\n``` \n:::note\n机器人必须在群名片所在的群内，才可以成功发送群名片。\n:::\n\n消息发送后的效果如下图：\n\n![未标题-5.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/738bf1ab64b76ddf94498d0fddd84c77_pEcY3LGk3g.png?height=306&lazyload=true&maxWidth=300&width=676)\n\n\n\n### 分享个人名片 share_user\n\n**内容示例**\n\n```json \n{\n    \"user_id\": \"ou_0dd200d32fda15216d2c2ef1ddb32f76\"\n} \n``` \n\n:::note\n- `user_id` 只支持设置用户的 open_id，且该用户需要在机器人的可用范围内，详情参见[配置应用可用范围](/ssl:ttdoc/home/introduction-to-scope-and-authorization/availability)。\n- 暂不支持分享机器人的名片。\n:::\n\n**参数说明** \n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>user_id</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>用户的 open_id，获取方式参见[如何获取 Open ID](/ssl:ttdoc/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)。\n  \n**示例值**：ou_0dd200d32fda15216d2c2ef1ddb32f76</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n\n**[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)请求体示例**\n\n```json \n{\n\t\"receive_id\": \"oc_820faa21d7ed275b53d1727a0feaa917\",\n\t\"content\": \"{\\\"user_id\\\":\\\"ou_xxx\\\"}\",\n\t\"msg_type\": \"share_user\"\n} \n``` \n\n消息发送后的效果如下图：\n\n![未标题-6.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/41b0fc85c2725851da3a5e3d17a7b92a_hFxAjwKxCn.png?height=282&lazyload=true&maxWidth=300&width=584)\n\n\n***\n\n\n### 语音 audio\n\n**内容示例**\n\n```json \n{\n    \"file_key\": \"75235e0c-4f92-430a-a99b-8446610223cg\"\n}\n``` \n\n**参数说明** \n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>file_key</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>语音文件的 Key，通过[上传文件](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)接口可获取文件的 Key（file_key）。\n  \n**示例值**：75235e0c-4f92-430a-a99b-8446610223cg</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n**[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)请求体示例**\n\n```json \n{\n\t\"receive_id\": \"oc_xxx\",\n\t\"content\": \"{\\\"file_key\\\":\\\"file_v2_xxx\\\"}\",\n\t\"msg_type\": \"audio\"\n} \n``` \n\n消息发送后的效果如下图：\n\n![未标题-7.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/35b8e3ab3c86e4c36756564ecf2d32c4_hcwZsC3Sdo.png?height=228&lazyload=true&maxWidth=300&width=592)\n\n\n\n\n### 视频 media\n\n**内容示例**\n\n```json \n{\n    \"file_key\": \"75235e0c-4f92-430a-a99b-8446610223cg\",\n    \"image_key\": \"img_xxxxxx\"\n}\n``` \n**参数说明** \n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>file_key</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>视频文件的 Key，通过[上传文件](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)接口获取视频文件的 Key（file_key）。\n  \n**示例值**：75235e0c-4f92-430a-a99b-8446610223cg</md-td>\n</md-tr>\n\n<md-tr>\n<md-td>image_key</md-td>\n<md-td>string</md-td>\n<md-td>否</md-td>\n<md-td>视频的封面图片，可选择配置，不配置则无封面。取值为图片的 Key，通过[上传图片](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口获取图片的 Key（image_key）。</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n**[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)请求体示例**\n\n```json \n{\n    \"receive_id\": \"oc_xxx\",\n    \"content\": \"{\\\"file_key\\\":\\\"file_v2_xxx\\\",\\\"image_key\\\":\\\"img_v2_xxx\\\"}\",\n    \"msg_type\": \"media\"\n} \n``` \n\n消息发送后的效果如下图：\n\n![未标题-8.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/2e9199825f13a97cf0746792bebc4c2f_2KysKba7r4.png?height=808&lazyload=true&maxWidth=350&width=672)\n\n\n### 文件 file\n\n**内容示例**\n\n```json \n{\n    \"file_key\": \"75235e0c-4f92-430a-a99b-8446610223cg\"\n}\n``` \n**参数说明** \n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>file_key</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>文件的 Key，通过[上传文件](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)接口获取文件的 Key（file_key）。\n  \n**示例值**：75235e0c-4f92-430a-a99b-8446610223cg</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n**[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)请求体示例**\n```json \n{\n\t\"receive_id\": \"oc_820faa21d7ed275b53d1727a0feaa917\",\n\t\"content\": \"{\\\"file_key\\\":\\\"file_v2_xxx\\\"}\",\n\t\"msg_type\": \"file\"\n} \n``` \n\n消息发送后的效果如下图：\n\n![未标题-9.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/7bd82e789e4385de6175928164aaa399_JtSebSp7Ej.png?height=240&lazyload=true&maxWidth=400&width=918)\n\n\n\n\n### 表情包 sticker\n\n**内容示例**\n\n```json \n{\n    \"file_key\": \"75235e0c-4f92-430a-a99b-8446610223cg\"\n}\n``` \n**参数说明** \n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>file_key</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>表情包文件的 Key，目前仅支持发送机器人收到的表情包，可通过[接收消息事件](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/events/receive)的推送获取表情包的 Key（file_key）。\n  \n**示例值**：75235e0c-4f92-430a-a99b-8446610223cg</md-td>\n</md-tr>\n\n</md-tbody>\n</md-table>\n:::\n\n\n**发消息请求体示例**\n\n```json \n{\n\t\"receive_id\": \"oc_xxx\",\n\t\"content\": \"{\\\"file_key\\\":\\\"file_v2_xxx\\\"}\",\n\t\"msg_type\": \"sticker\"\n} \n``` \n消息发送后的效果如下图：\n\n![未标题-10.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/5617a52223f44877799f2de8c4639ed9_BBrI1lCAff.png?height=610&lazyload=true&maxWidth=300&width=632)\n\n### 系统消息 system\n\n:::warning\n**注意：**\n- 仅支持使用 `tenant_access_token` 调用[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)接口，发送特定模板的系统消息，除接口必须权限外，还需要拥有 ==发送特定模板系统消息 (im:message:send_sys_msg)== 权限。\n- 飞书客户端版本需要在 V7.20 及以上，才能正常显示分割线系统消息，低于此版本将仅展示文本内容。\n:::\n\n**内容示例**\n\n```json \n{\n    \"type\": \"divider\", \n    \"params\": {\n        \"divider_text\": {\n            \"text\": \"新会话\",\n            \"i18n_text\": {\n                \"zh_CN\": \"新会话\",\n                \"en_US\": \"New Session\"\n            }\n        }\n       \n    },\n    \"options\": {\n        \"need_rollup\": true\n    }\n}\n``` \n\n**参数说明**\n\n:::html\n<md-table>\n<md-thead>\n<md-tr>\n<md-th style=\"width:20%\">名称</md-th>\n<md-th style=\"width:15%\">类型</md-th>\n<md-th style=\"width:15%\">是否必填</md-th>\n<md-th style=\"width:50%\">描述</md-th>\n</md-tr>\n</md-thead>\n<md-tbody>\n\n<md-tr>\n<md-td>type</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>系统消息类型。仅支持取值 `divider`，表示分割线。**目前该类型仅支持在机器人与用户的单聊（p2p）中生效。**\n  \n**示例值**：divider\n</md-td>\n</md-tr>\n\n<md-tr>\n<md-td>params</md-td>\n<md-td>object</md-td>\n<md-td>是</md-td>\n<md-td>系统消息参数。</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td> ∟ divider_text</md-td>\n<md-td>object</md-td>\n<md-td>否</md-td>\n<md-td>分割线系统消息的内容。当 `type` 为 `divider` 时该参数必填。\n  \n**示例值**：\"divider_text\": { \"text\": \"新话题\", \"i18n_text\": { \"zh_CN\": \"新会话\", \"en_US\": \"New Session\" } }</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td> ∟∟ text</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>默认文本。\n  \n**注意**：\n  \n- 该参数为必填参数，不能传空值。\n- 文本长度不能超过 20 个字符或 10 个汉字。\n  \n**示例值**：新会话</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td> ∟∟ i18n_text</md-td>\n<md-td>map</md-td>\n<md-td>否</md-td>\n<md-td>国际化文本，多语言环境下，优先使用该值。格式为 `{key:value}` 形式。支持的语种字段有：\n  \n- en_US（英文）\n- zh_CN（简体中文）\n- zh_HK（繁体中文-香港）\n- zh_TW（繁体中文-台湾）\n- ja_JP（日语）\n- id_ID（印尼语）\n- vi_VN（越南语）\n- th_TH（泰语）\n- pt_BR（葡萄牙语）\n- es_ES（西班牙语）\n- ko_KR（韩语）\n- de_DE（德语）\n- fr_FR（法语）\n- it_IT（意大利语）\n- ru_RU（俄语）\n- ms_MY（马来语）\n  \n**注意**：\n- 语言类型大小写敏感，传值时请保持与上述枚举值完全一致。\n- 每种语言下（若有）文本则不能为空。\n- 文本长度不能超过 20 个字符或 10 个汉字。\n  \n**示例值**：{ \"zh_CN\": \"新会话\", \"en_US\": \"New Session\" }</md-td>\n</md-tr>\n  \n<md-tr>\n<md-td>options</md-td>\n<md-td>map</md-td>\n<md-td>否</md-td>\n<md-td>可选配置项，格式为 `{key:value}` 形式，`key` 为枚举值，`value` 为枚举值的取值。支持的枚举值有：\n  \n- need_rollup：是否需要滚动清屏，boolean 类型参数，默认取值 false，表示不需要。\n  \n**示例值**：{ \"need_rollup\": true }</md-td>\n</md-tr>\n\n\n</md-tbody>\n</md-table>\n:::\n\n**[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)请求体示例**\n\n```json \n{\n        \"receive_id\": \"oc_xxx\",\n        \"content\": \"{\\\"type\\\":\\\"divider\\\",\\\"params\\\":{\\\"divider_text\\\":{\\\"text\\\":\\\"新会话\\\",\\\"i18n_text\\\":{\\\"zh_CN\\\":\\\"新会话\\\",\\\"en_US\\\":\\\"New Session\\\"}}},\\\"options\\\":{\\\"need_rollup\\\":true}}\",\n        \"msg_type\": \"system\"\n} \n``` \n\n效果示例如下图：\n\n\n![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/792f2064dabe161aa6e858514edf82b8_7008qWcmA1.png?height=248&lazyload=true&maxWidth=600&width=1824)\n","bizScope":"6999845508005003284","type":"GuideDocumentType","title":"","allVisible":true,"visibleTag":"All","id":"6921196730969079810","fullPath":"/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json"}}