# 消息模板
为了丰富消息内容,SDK 提供了几种消息模板。
注意
- 发送消息时所有字段均使用
字符串类型
。 - 如果发送的消息中包含链接(网页、图片、视频链接等),需要提前在机器人管理端 (opens new window)报备,操作流程:操作路径为:“开发设置” -> “消息 URL 配置”。
# 可用模板
# 链接、文本列表模板
# 样式(id=23)
# 模板格式
{
"app": "com.tencent.channel.robot",
"view": "albumAddPic",
"ver": "0.0.0.1",
"desc": "#DESC#",
"prompt": "[QQ小程序]#PROMPT#",
"meta": {
"detail": {
"list": "#LIST#"
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# 字段描述
字段名 | 类型 | 描述 |
---|---|---|
#DESC# | string | 描述 |
#PROMPT# | string | 提示消息 |
#LIST# | array | #LIST#数组 |
# LIST 结构
字段名 | 类型 | 描述 |
---|---|---|
desc | string | 文本内容 |
link | string | 链接,需要提前报备,如果不填就显示为文本,如果填了就显示为链接 |
# 请求示例
{
"ark": {
"template_id": 23,
"kv": [
{
"key": "#DESC#",
"value": "descaaaaaa"
},
{
"key": "#PROMPT#",
"value": "promptaaaa"
},
{
"key": "#LIST#",
"obj": [
{
"obj_kv": [
{
"key": "desc",
"value": "需求标题:UI问题解决"
}
]
},
{
"obj_kv": [
{
"key": "desc",
"value": "当前状态\"体验中\"点击下列动作直接扭转状态到:"
}
]
},
{
"obj_kv": [
{
"key": "desc",
"value": "已评审"
},
{
"key": "link",
"value": "https://qun.qq.com"
}
]
},
{
"obj_kv": [
{
"key": "desc",
"value": "已排期"
},
{
"key": "link",
"value": "https://qun.qq.com"
}
]
},
{
"obj_kv": [
{
"key": "desc",
"value": "开发中"
},
{
"key": "link",
"value": "https://qun.qq.com"
}
]
},
{
"obj_kv": [
{
"key": "desc",
"value": "增量测试中"
},
{
"key": "link",
"value": "https://qun.qq.com"
}
]
},
{
"obj_kv": [
{
"key": "desc",
"value": "请关注"
}
]
}
]
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
# 文本、缩略图模板
# 样式(id=24)
# 模板格式
{
"app": "com.tencent.channelrobot.smallpic",
"view": "albumAddPic",
"ver": "0.0.0.1",
"desc": "#DESC#",
"prompt": "[QQ小程序]#PROMPT#",
"meta": {
"detail": {
"title": "#TITLE#",
"desc": "#METADESC#",
"img": "#IMG#",
"link": "#LINK#",
"subTitle": "#SUBTITLE#"
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 字段描述
字段名 | 类型 | 描述 |
---|---|---|
#DESC# | string | 描述 |
#PROMPT# | string | 提示文本 |
#TITLE# | string | 标题 |
#METADESC# | string | 详情描述 |
#IMG# | string | 图片链接 |
#LINK# | string | 跳转链接 |
#SUBTITLE# | string | 来源 |
# 请求示例
{
"ark": {
"template_id": 24,
"kv": [
{
"key": "#DESC#",
"value": "描述描述描放假大方了大家反垄断撒娇两款发动机临时卡封疆大吏撒酒疯;里导数据阿弗莱克的撒娇;廊坊述"
},
{
"key": "#PROMPT#",
"value": "通知信息xxxxx"
},
{
"key": "#TITLE#",
"value": "标题fjd;lsajfldjsalkfjdkw封疆大吏撒娇锋利的撒娇;付了定金撒标题标题标题标题fjkdlajfldjal;fd放大了发动机上来空"
},
{
"key": "#METADESC#",
"value": "Meta描述描述描述风好大换热器继往开来积分考虑到;安静了;了;防静电;来撒会今日而我却哦iopqwfjldsa"
},
{
"key": "#IMG#",
"value": "https://pub.idqqimg.com/pc/misc/files/20190820/2f4e70ae3355ece23d161cf5334d4fc1jzjfmtep.png"
},
{
"key": "#LINK#",
"value": "https://qq.com"
},
{
"key": "#SUBTITLE#",
"value": "子标题"
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# 大图模板 34
# 样式(id=34)
# 模板格式
{
"app": "com.tencent.miniapp_01",
"view": "view_8C8E89B49BE609866298ADDFF2DBABA4",
"ver": "1.0.1.12",
"desc": "#DESC#",
"prompt": "#PROMPT#",
"meta": {
"detail_1": {
"title": "#METATITLE#",
"desc": "#METADESC#",
"icon": "#METAICON#",
"preview": "#METAPREVIEW#",
"url": "#METAURL#"
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 字段描述
字段名 | 类型 | 描述 |
---|---|---|
#DESC# | string | 描述 |
#PROMPT# | string | 提示消息 |
#METATITLE# | string | 标题 |
#METADESC# | string | 描述 |
#METAICON# | string | 小图标 |
#METAPREVIEW# | string | 大图 |
#METAURL# | string | 跳转链接 |
# 请求示例
{
"ark": {
"template_id": 34,
"kv": [
{
"key": "#DESC#",
"value": "descaaaaaa"
},
{
"key": "#PROMPT#",
"value": "promptaaaa"
},
{
"key": "#METATITLE#",
"value": "metatitle"
},
{
"key": "#METADESC#",
"value": "metadesc"
},
{
"key": "#METAICON#",
"value": "https://tangram-1251316161.file.myqcloud.com/files/20211014/bfd7d02235e52d60b05a630ac9ef8bcc.png"
},
{
"key": "#METAPREVIEW#",
"value": "https://tangram-1251316161.file.myqcloud.com/files/20211014/bfd7d02235e52d60b05a630ac9ef8bcc.png"
},
{
"key": "#METAURL#",
"value": "https://qq.com"
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# 大图模板 37
# 样式(id=37)
# 模板格式
{
"app": "com.tencent.imagetextbot",
"view": "index",
"ver": "1.0.0.11",
"prompt": "#PROMPT#",
"meta": {
"robot": {
"title": "#METATITLE#",
"subtitle": "#METASUBTITLE#",
"cover": "#METACOVER#",
"jump_url": "#METAURL#"
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
# 字段描述
字段名 | 类型 | 描述 |
---|---|---|
#PROMPT# | string | 提示消息 |
#METATITLE# | string | 标题 |
#METASUBTITLE# | string | 子标题 |
#METACOVER# | string | 大图,尺寸为 975*540 |
#METAURL# | string | 跳转链接 |
# 请求示例
{
"ark": {
"template_id": 37,
"kv": [
{
"key": "#PROMPT#",
"value": "通知提醒"
},
{
"key": "#METATITLE#",
"value": "标题"
},
{
"key": "#METASUBTITLE#",
"value": "子标题"
},
{
"key": "#METACOVER#",
"value": "https://vfiles.gtimg.cn/vupload/20211029/bf0ed01635493790634.jpg"
},
{
"key": "#METAURL#",
"value": "https://qq.com"
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27