{"code":0,"msg":"succeeded","data":{"fullPath":"/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json","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\n### 文本 text\n:::note\n**注意**：如需发送 Markdown 内容，推荐使用富文本 `post` 消息中的 `md` 标签，支持 CommonMark 0.31 + GFM 语法，包括表格、任务列表、删除线、自动链接等能力。除此之外，飞书还额外支持 @ 用户、@ 所有人和图片扩展语法。`text` 类型仅适用于普通文本和部分轻量格式。\n:::\n\n**内容示例**\n\n```json \n{\n \"text\": \"test content\"\n}\n``` \n\n**参数说明**\n\n:::html\n\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\ntext\nstring\n是\n文本内容。\n \n**示例值**：test content\n\n\n\n\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用户名（可不填）\n// @ 所有人\n\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\\\":\\\"Tom text content\\\"}\",\n \"msg_type\": \"text\"\n} \n```\n\n\n消息发送后的效果如下图：\n\n\n\n#### 支持部分样式标签\n\n支持加粗、斜体、下划线、删除线四种样式（可嵌套使用）：\n- **加粗**：`文本示例` \n- *斜体*：`文本示例`\n- _下划线_：`文本示例`\n- ~~删除线~~：`文本示例`\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\\\":\\\"bold content, bold and italic content\\\"}\",\n \"msg_type\": \"text\"\n}\n``` \n\n消息发送后效果如下图：\n\n\n\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\n\n\n\n### 富文本 post\n:::note\n**注意**：发送 Markdown 内容，推荐使用富文本 `post` 消息中的 `md` 标签，支持 CommonMark 0.31 + GFM 语法，包括表格、任务列表、删除线、自动链接等能力。除此之外，飞书还额外支持 @ 用户、@ 所有人和图片扩展语法。\n:::\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:**Tom\\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\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nzh_cn, en_us\nobject\n是\n多语言配置字段。如果不需要配置多语言，则仅配置一种语言即可。\n \n- `zh_cn` 为富文本的中文内容\n- `en_us` 为富文本的英文内容\n \n**注意**：该字段无默认值，至少要设置一种语言。\n \n**示例值**：zh_cn\n\n\n\n∟ title\nstring\n否\n富文本消息的标题。\n \n**默认值**：空\n \n**示例值**：title\n\n \n\n∟ content\nstring\n是\n富文本消息内容。由多个段落组成（段落由`[]`分隔），每个段落为一个 node 列表，所支持的 node 标签类型以及对应的参数说明，参见下文的 **富文本支持的标签和参数说明** 章节。\n \n**注意**：如 **示例值** 所示，各类型通过 tag 参数设置。例如文本（text）设置为 `\"tag\": \"text\"`。\n \n**示例值**：[[{\"tag\": \"text\",\"text\": \"text content\"}]]\n\n\n \n\n\n\n:::\n\n\n#### **富文本支持的标签和参数说明**\n\n- **text：文本标签**\n\n:::html\n\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\ntext\nstring\n是\n文本内容。\n \n**示例值**：test content\n\n\n\nun_escape\nboolean\n否\n是否 unescape 解码。默认为 false，无需使用可不传值。\n \n**示例值**：false\n\n \n\nstyle\n[]string\t\n否\n文本内容样式，支持的样式有：\n \n- bold：加粗\n- underline：下划线\n- lineThrough：删除线\n- italic：斜体\n\n**注意**：\n- 默认值为空，表示无样式。\n- 传入的值如果不是以上可选值，则被忽略。\n \n**示例值**：[\"bold\", \"underline\"]\n\n\n\n\n\n:::\n\n\n- **a：超链接标签**\n\n:::html\n\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\ntext\nstring\n是\n超链接的文本内容。\n \n**示例值**：超链接\n\n\n\nhref\nstring\n是\n超链接地址。\n \n**注意**：请确保链接地址的合法性，否则消息会发送失败。\n \n**示例值**：https://open.feishu.cn\n\n \n\nstyle\n[]string\t\n否\n超链接文本内容样式，支持的样式有：\n \n- bold：加粗\n- underline：下划线\n- lineThrough：删除线\n- italic：斜体\n\n**注意**：\n- 默认值为空，表示无样式。\n- 传入的值如果不是以上可选值，则被忽略。\n \n**示例值**：[\"bold\", \"italic\"]\n\n\n\n\n\n:::\n\n\n- **at：@标签**\n\n:::html\n\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nuser_id\nstring\n是\n用户 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`。\n\n\n\nstyle\n[]string\n否\nat 文本内容样式，支持的样式有：\n \n- bold：加粗\n- underline：下划线\n- lineThrough：删除线\n- italic：斜体\n\n**注意**：\n- 默认值为空，表示无样式。\n- 传入的值如果不是以上可选值，则被忽略。\n \n**示例值**：[\"lineThrough\"]\n\n\n\n\n:::\n\n\n\n- **img：图片标签**\n\n:::html\n\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nimage_key\nstring\n是\n图片 Key。通过[上传图片](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口可以获取到图片 Key（image_key）。\n \n**示例值**：d640eeea-4d2f-4cb3-88d8-c964fab53987\n\n\n\n\n:::\n\n\n\n- **media：视频标签**\n\n:::html\n\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nfile_key\nstring\n是\n视频文件的 Key。通过[上传文件](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)接口上传视频（mp4 格式）后，可以获取到视频文件 Key（file_key）。\n \n**示例值**：file_v2_0dcdd7d9-fib0-4432-a519-41d25aca542j\n\n\n\nimage_key\nstring\n否\n视频封面图片的 Key。通过[上传图片](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口可以获取到图片 Key（image_key）。\n \n**默认值**：空，表示无视频封面。\n\n**示例值**：img_7ea74629-9191-4176-998c-2e603c9c5e8g\n\n\n\n\n:::\n\n- **emotion：表情标签**\n\n:::html\n\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nemoji_type\nstring\n是\n表情文案类型。可选值参见[表情文案说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce)。\n \n**示例值**：SMILE\n\n\n\n\n:::\n\n\n- **code_block：代码块标签**\n\n:::html\n\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nlanguage\nstring\n否\n代码块的语言类型。可选值有 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\n\n\n\ntext\nstring\n是\n代码块内容。\n \n**示例值**：func main() int64 {\\n return 0\\n}\n\n\n\n\n:::\n\n\n\n- **hr：分割线标签**\n\n富文本支持 `tag` 取值为 `hr`，表示一条分割线，该标签内无其他参数。\n\n\n- **md：Markdown 标签**\n\n:::note\n- 支持 CommonMark 0.31 + GFM 常用语法，包括表格、任务列表、删除线、自动链接等能力。除此之外，飞书还额外支持 @ 用户、@ 所有人和图片等扩展语法。\n- 部分样式需要升级到最新客户端版本查看。\n:::\n\n\n:::warning\n**注意**：\n- `md` 标签会独占一个或多个段落，不能与其他标签在同一行。\n- `md` 标签在在`content_v2`字段中会被完整保留，可获取原始markdown内容，**推荐优先读取`content_v2`字段**，详见[接收消息内容结构](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content#45e0953e)。\n- `md` 标签在旧版本消息结构`content`字段中会被兼容适配，如[获取消息内容](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/get)时将不再包含此标签，会根据 `md` 中的内容转换为其他相匹配的标签。例如引用，有序、无序列表，表格等在获取消息内容时，会简化为文本标签（text）进行输出。\n- GFM 支持但飞书不支持的语法：Setext 标题，缩进代码块，任意 raw HTML，邮箱自动链接。\n:::\n\n`md` 标签内通过 `text` 参数设置 Markdown 内容。\n\n:::html\n\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\ntext\nstring\n是\nMarkdown 内容。支持的内容参见下表。\n \n**示例值**：1. item1\\n2. item2\n\n\n\n\n:::\n\n `text` 参数内常用的语法：\n\n:::html\n\n\n\n语法\n示例\n说明\n\n\n\n\n\n@ 用户\n`User`\n\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\n \n \n\n图片\n``\n\n飞书扩展语法。支持在 Markdown 中插入图片。\n\n图片语法中的链接地址只需要传图片 Key 字符串，例如 `img_v3_xxx`。图片 Key 可通过[上传图片](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口获取。\n\n \n \n\n普通文本 / 段落 / 换行\n`hello\\nworld`\n\n支持普通文本、段落和换行。\n\n**注意**：在 Markdown 中，单个 `\\n` 通常会被解析为软换行。如需分隔不同块级元素，建议使用 `\\n\\n`。\n\n\n\n\nATX 标题\n`# h1\\n## h2\\n### h3`\n\n支持 ATX 标题语法，即使用 `#` 表示标题层级，支持 `#` 到 `######`。\n\n**注意**：暂不支持 Setext 标题语法，例如 `Heading\\n---`。如需设置标题，建议使用 ATX 标题。\n\n\n\n\n加粗\n`**加粗文本**`
`__加粗文本__`\n\n支持使用 `**` 或 `__`包裹文本设置加粗。\n\n\n\n\n斜体\n`*斜体文本*`
`_斜体文本_`\n\n支持使用 `*` 或 `_` 包裹文本设置斜体。\n\n斜体可以与加粗组合使用，例如：`***加粗+斜体***`。\n\n\n\n\n删除线\n`~~删除线文本~~`\n\n支持 GFM 删除线语法，使用 `~~` 包裹文本设置删除线。\n\n\n\n\n下划线\n`下划线文本`\n\n支持 GFM 下划线语法，使用 `` `` 包裹文本设置下划线。\n\n\n\n\n行内代码\n\\`code\\`\n\n支持使用反引号包裹行内代码。\n\n\n\n\n代码块\n\\`\\`\\`typescript\\nconsole.log(\"hello\")\\n\\`\\`\\`\n\n支持围栏代码块。代码块内容首尾需要使用 \\`\\`\\` 包裹，首部 \\`\\`\\` 后可以指定代码语言。\n\n支持的语言类型包括 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\n引用\n`> quote`\n\n支持引用块语法。`>` 符与后续内容之间建议保留一个空格。\n\n**注意**：引用块后面如需接其他块级元素，**必须**使用 `\\n\\n` 分隔。\n\n\n\n\n有序列表\n`1. item1\\n2. item2`\n\n支持有序列表。\n\nMarkdown 配置说明：\n\n- 每个编号的 `.` 符与后续内容之间要有一个空格。\n- 每一列独立一行。如示例所示，可使用 `\\n` 换行符换行。\n- 支持嵌套多层级。\n- 可以与无序列表混合使用。\n\n\n\n\n无序列表\n`- item1\\n- item2`\n\n支持无序列表。\n\nMarkdown 配置说明：\n\n- 每列的 `-` 符与后续内容之间要有一个空格。\n- 每一列独立一行。如示例所示，可使用 `\\n` 换行符换行。\n- 支持嵌套多层级。\n- 可以与有序列表混合使用。\n\n\n\n\n任务列表\n`- [ ] todo\\n- [x] done`\n\n支持 GFM 任务列表语法。\n\n**注意**：任务列表仅用于展示任务状态，不等同于飞书任务。\n\n\n\n\n表格\n`| 名称 | 链接 |\\n| --- | --- |\\n| 飞书 | https://www.feishu.cn |`\n\n支持 GFM 表格语法。表格不支持嵌套，表格内不支持图片。\n\n**注意**：表格前后**必须**使用 `\\n\\n` 与其他块级元素分隔。如果只使用单个 `\\n`，后续内容可能被解析为表格的续行。\n\n\n\n\n分割线\n`\\n --- \\n`\n\n支持 Markdown 分割线语法。\n\n\n\n\n超链接\n`[飞书](https://www.feishu.cn)`\n\n支持 Markdown 超链接语法。`[]` 用来设置超链接的文本内容，`()` 用来设置超链接地址。\n\n**注意**：请确保链接地址合法。\n\n\n\n\nURL 自动链接\n``\n\n支持 URL 自动链接。`` 形式均可被识别为链接。\n\n**注意**：暂不支持邮箱自动链接，例如 ``。\n\n\n\n\n脚注\n`这里有一个脚注引用[^1]\\n\\n[^1]: 脚注内容`\n\n支持脚注语法。\n\n**注意**：脚注支持展示，但暂不支持点击定位。\n\n\n\n \n\n\n\n:::\n\n[发送消息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)时的请求体示例：\n\n```json \n{\n \"receive_id\": \"oc_820faa21d7ed275b53d1727a0feaa917\",\n \"msg_type\": \"post\",\n \"content\": \"{\\\"zh_cn\\\":{\\\"content\\\":[[{\\\"tag\\\":\\\"md\\\",\\\"text\\\":\\\"## 新版 Markdown 渲染示例\\\\n\\\\n1. 有序列表第一项\\\\n2. 有序列表第二项\\\\n\\\\n> 这是一段引用内容。\\\\n\\\\n```ts\\\\nconst feature = \\\\\\\"CommonMark 0.31 + GFM\\\\\\\";\\\\nconsole.log(feature);\\\\n```\\\\n\\\\n| 语法 | 状态 | 说明 |\\\\n| --- | --- | --- |\\\\n| 表格 | 支持 | 表格不支持嵌套 |\\\\n| 任务列表 | 支持 | 仅展示任务状态 |\\\\n| 自动链接 | 支持 | 裸 URL 可自动识别为链接 |\\\\n\\\\n- [x] 已完成：任务列表渲染\\\\n- [ ] 待处理：继续补充文档示例\\\\n\\\\n~~这是一段删除线内容~~\\\\n\\\\nhttps://open.feishu.cn\\\\n\\\\nlark \\\\n\\\\n\\\"}]]}}\"\n}\n``` \n发送后的效果图：\n\n\n\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\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nimage_key\nstring\n是\n图片 Key，通过[上传图片](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口可获取到图片 Key（image_key）。\n \n**示例值**：img_7ea74629-9191-4176-998c-2e603c9c5e8g\n\n\n\n\n\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\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 \n \n \n 参数 \n 类型\n 必填 \n 说明 \n \n \n \n\n\n \n \n type\n \n string\n 否\n \n 卡片类型。要发送由搭建工具搭建的卡片（也称卡片模板），固定取值为 `template`。\n \n \n \n \n data\n \n object\n 否\n \n 卡片模板的数据，要发送由搭建工具搭建的卡片，此处需传入卡片模板 ID、卡片版本号等。\n \n \n \n \n └ template_id\n \n string\n 是\n \n 搭建工具中创建的卡片（也称卡片模板）的 ID，如 `AAqigYkzabcef`。可在搭建工具中通过复制卡片模板 ID 获取。 \n\n \n\n \n \n\n \n \n └ template_version_name \n \n string\n 否 \n \n 搭建平台中创建的卡片的版本号，如 `1.0.0`。卡片发布后，将生成版本号。可在搭建工具 **版本管理** 处获取。\n\n \n
**注意**：\n 若不填此字段，将默认使用该卡片的最新版本。\n \n \n \n \n └ template_variable \n \n object\n 否 \n \n 若卡片绑定了变量，你需在该字段中传入实际变量数据的值。\n \n **示例**：如果变量名称在搭建工具中被定义为 `open_id`，此处需要对 `open_id` 变量传入值：\n\n ```json\n {\n \"open_id\": \"ou_d506829e8b6a17607e56bcd6b1aabcef\"\n }\n ```\n\n \n \n \n \n\n :::\n\n\n\n
\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\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 \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\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nchat_id\nstring\n是\n群 ID。获取方式参见[群ID 说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)。\n \n**示例值**：oc_0dd200d32fda15216d2c2ef1ddb32f76\n\n\n\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\": \"{\\\"chat_id\\\":\\\"oc_xxx\\\"}\",\n\t\"msg_type\": \"share_chat\"\n}\n``` \n:::note\n机器人必须在群名片所在的群内，才可以成功发送群名片。\n:::\n\n消息发送后的效果如下图：\n\n\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\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nuser_id\nstring\n是\n用户的 open_id，获取方式参见[如何获取 Open ID](/ssl:ttdoc/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)。\n \n**示例值**：ou_0dd200d32fda15216d2c2ef1ddb32f76\n\n\n\n\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\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\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nfile_key\nstring\n是\n语音文件的 Key，通过[上传文件](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)接口可获取文件的 Key（file_key）。\n \n**示例值**：75235e0c-4f92-430a-a99b-8446610223cg\n\n\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\": \"{\\\"file_key\\\":\\\"file_v2_xxx\\\"}\",\n\t\"msg_type\": \"audio\"\n} \n``` \n\n消息发送后的效果如下图：\n\n\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\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nfile_key\nstring\n是\n视频文件的 Key，通过[上传文件](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)接口获取视频文件的 Key（file_key）。\n \n**示例值**：75235e0c-4f92-430a-a99b-8446610223cg\n\n\n\nimage_key\nstring\n否\n视频的封面图片，可选择配置，不配置则无封面。取值为图片的 Key，通过[上传图片](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口获取图片的 Key（image_key）。\n\n\n\n\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\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\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nfile_key\nstring\n是\n文件的 Key，通过[上传文件](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)接口获取文件的 Key（file_key）。\n \n**示例值**：75235e0c-4f92-430a-a99b-8446610223cg\n\n\n\n\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\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\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\nfile_key\nstring\n是\n表情包文件的 Key，目前仅支持发送机器人收到的表情包，可通过[接收消息事件](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/events/receive)的推送获取表情包的 Key（file_key）。\n \n**示例值**：75235e0c-4f92-430a-a99b-8446610223cg\n\n\n\n\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\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\n\n\n名称\n类型\n是否必填\n描述\n\n\n\n\n\ntype\nstring\n是\n系统消息类型。仅支持取值 `divider`，表示分割线。**目前该类型仅支持在机器人与用户的单聊（p2p）中生效。**\n \n**示例值**：divider\n\n\n\n\nparams\nobject\n是\n系统消息参数。\n\n \n\n ∟ divider_text\nobject\n否\n分割线系统消息的内容。当 `type` 为 `divider` 时该参数必填。\n \n**示例值**：\"divider_text\": { \"text\": \"新话题\", \"i18n_text\": { \"zh_CN\": \"新会话\", \"en_US\": \"New Session\" } }\n\n \n\n ∟∟ text\nstring\n是\n默认文本。\n \n**注意**：\n \n- 该参数为必填参数，不能传空值。\n- 文本长度不能超过 20 个字符或 10 个汉字。\n \n**示例值**：新会话\n\n \n\n ∟∟ i18n_text\nmap\n否\n国际化文本，多语言环境下，优先使用该值。格式为 `{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\" }\n\n \n\noptions\nmap\n否\n可选配置项，格式为 `{key:value}` 形式，`key` 为枚举值，`value` 为枚举值的取值。支持的枚举值有：\n \n- need_rollup：是否需要滚动清屏，boolean 类型参数，默认取值 false，表示不需要。\n \n**示例值**：{ \"need_rollup\": true }\n\n\n\n\n\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\n","updateTime":1783411335000,"allVisible":true,"templateName":"","redirectUri":"/server-docs/im-v1/message-content-description/create_json","id":"6921196730969079810","title":"","keywords":["发送消息","消息"],"visibleTag":"All","bizScope":"6999845508005003284","directoryId":"6946222931480297473","name":"发送消息内容结构","type":"GuideDocumentType"}}