QQ机器人文档

# 消息模板

为了丰富消息内容，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

# 字段描述

字段名 类型 描述
#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

# 文本、缩略图模板

# 样式(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

# 字段描述

字段名 类型 描述
#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

# 大图模板 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

# 字段描述

字段名 类型 描述
#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

# 大图模板 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

# 字段描述

字段名 类型 描述
#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

← 消息内嵌格式 →

手机QQ扫码
开发者社区
加入官方频道开发者社区