发送 Markdown 消息（灰度中）

接口

POST /channels/{channel_id}/messages

功能描述

发送 markdown 消息，支持 markdown 模版 和直传 markdown 语法 两种请求格式。

• 请求参数 markdown 模版 和 markdown 语法 只能单一传值。

• markdown 模版

  • 要求操作人在该子频道具有发送消息和对应 Markdown 模版 的权限。
  • 调用前开发者需要先在“QQ开放平台-机器人-发布设置-消息模板”入口为对应机器人创建申请Markdown消息模板，得到模板 id ，在请求时填在对应的 markdown.template_id 上。
  • 模板参数暂不支持数组。
  • 消息体中所包含的URL需要报备并通过验证，方可使用。

• 支持大部分的 markdown 格式，具体请参考 格式说明

• 开发者当前可以在QQ开发者社区频道填写问卷按照相关流程申请开通“QQ开放平台-发布设置”里的消息模板管理入口。

Content-Type

application/json

参数

字段名	类型	描述
markdown	MessageMarkdown	markdown 消息, 参数 markdown 值不为空时，只能发送 markdown 单独一种消息类型

返回

Message 对象

具体错误

错误码

示例

请求数据包

Markdown 请求

（不再新增对外开放）

{
  "markdown": {
    "content": "# 标题 \n## 简介很开心 \n内容[🔗腾讯](https://www.qq.com)"
  }
}

---

Markdown 模版请求

假设机器人已经开通相应权限，markdown模板如下所示，其中参数类型均为文本类型.

#{{.title}}

![img#618px #249px]({{.image}})

*{{.para1}}
*{{.para2}}

## {{.desc}}

{{.content}}[{{.link_introduction}}]({{.link}})

{
	"markdown": {
		"custom_template_id": "101993071_1658748972",
		"params": [{
				"key": "title",
				"values": ["标题"]
			},
			{
				"key": "image",
				"values": [
					"https://resource5-1255303497.cos.ap-guangzhou.myqcloud.com/abcmouse_word_watch/other/mkd_img.png"
				]
			},
			{
				"key": "para1",
				"values": ["段落1"]
			},
			{
				"key": "para2",
				"values": ["段落2"]
			},
			{
				"key": "desc",
				"values": ["简介"]
			},
			{
				"key": "content",
				"values": ["在这个子频道非常开心"]
			},
			{
				"key": "link_introduction",
				"values": ["链接介绍"]
			},
			{
				"key": "link",
				"values": ["https://www.qq.com"]
			}
		]
	}
}
    

则实际下发的 markdown 为，这里需要注意url需要报备并通过验证。

# 标题

![img#618px #249px](https://resource5-1255303497.cos.ap-guangzhou.myqcloud.com/abcmouse_word_watch/other/mkd_img.png)

* 段落1
* 段落2

## 简介

在这个子频道非常开心[链接介绍](https://www.qq.com)

---

响应数据包

{
  "id": "089XXXXXXXX7b5d0fe1d10e6a45f380a48b0f38e9706",
  "channel_id": "1XXXXXX",
  "guild_id": "2160XXXXXXXXXX0268",
  "content": "",
  "timestamp": "2022-MM-DDT18:42:55+08:00",
  "tts": false,
  "mention_everyone": false,
  "author": {
    "id": "1233455677",
    "username": "",
    "avatar": "",
    "bot": true
  },
  "pinned": false,
  "type": 0,
  "flags": 0,
  "seq_in_channel": "11"
}