# 资源介绍
# 资源定义
消息卡片是Boss Hi的一种可以承载丰富的内容和交互行为的消息类型。通过消息卡片，你可以：
- 使用消息卡片提供的发送样式精美的卡片，比如醒目的通知、文章列表等，让重要的信息更好地触达用户。
- 使用消息卡片提供的交互组件，使用户只需在卡片上点击一下就能提交信息，从而无需离开聊天会话，就能快捷完成审批、投票统计、报警处理等系统操作。
实现以上功能无需客户端开发经验，Boss Hi已经为卡片消息定义了结构化的组件与样式，通过服务端一段 JSON 描述，即可构造样式精美、可交互的消息卡片。消息卡片详细介绍>>
# 字段说明
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| content | string | 是 | compressive_card卡片消息内容，json结构序列化后的字符串 |
# 数据示例
以下示例代码可拷贝至消息卡片搭建工具 (opens new window) 中编辑使用。
{
"header": {
"text": {
"content": "多文本1",
"tag": "plain_text"
},
"color": "grey"
},
"cardLink": {
"url": "https://{{$themeConfig.openOrigin}}/app-manage",
"pcUrl": "",
"androidUrl": "",
"iosUrl": ""
},
"globalConfig": {
"forward": true,
"shareCard": true
},
"modules": [
{
"title": {
"tag": "plain_text",
"content": "图片模块"
},
"imgKey": "16b4abd7b8d85821jwFaTrfq3LOHdOfnIXEwYrmQzxtXN0CX5Azo6wTXz_Ws-sHsSAy7d5Css-Q1WMZjHlYqmxj8XyDw9vC1BpSzk8quAeWmduLxTFuIAOZbYbd_umaOlAQWTzPBwvxbnrrMVaSWGOSY_sl9Ws1ILQ48A483dtmLGmZk6eBNTnI~",
"alt": {
"tag": "plain_text",
"content": "图片文本"
},
"preview": true,
"tag": "img"
},
{
"tag": "split_line"
},
{
"text": {
"tag": "plain_text",
"content": "内容模块文本1"
},
"tag": "div"
},
{
"content": "普通文本标准\n/nemoji 😁😢🌞💼🏆❌✅*斜体***粗体**~~删除线~~",
"textAlign": "left",
"multiUrl": {
"url": "https://www.baidu.com",
"pcUrl": "https://www.4399.com",
"androidUrl": "",
"iosUrl": "https://www.4399.com"
},
"tag": "markdown"
},
{
"text": {
"tag": "hi_md",
"content": "**加粗** *斜体* ***加粗斜体*** ~~删除线~~ **~~加粗删除线~~** ***~~加粗斜体删除线~~*** [测试链接](www.baidu.com)"
},
"tag": "div"
},
{
"text": {
"tag": "plain_text",
"content": "内容模块文本2"
},
"fields": [
{
"text": {
"tag": "plain_text",
"content": "多文本1"
},
"needLayout": true
},
{
"text": {
"tag": "plain_text",
"content": "多文本2"
},
"needLayout": true
},
{
"text": {
"tag": "plain_text",
"content": "多文本3"
},
"needLayout": true
},
{
"text": {
"tag": "plain_text",
"content": "多文本4"
},
"needLayout": true
}
],
"extra": {
"tag": "img",
"imgKey": "4491ba5156d2c694jwFaTrfq3LOHdOfnIXEwYrmQzxtXN0CX5Azo6wTXz_Ws-sHsSAy7d5Css-Q1WMZjHlYqmxj8XyDw9vC1BpSzk8quAeWmMqfxTFuIDOZbYbd_umCelAQWTzPBwvBbnbrMVaSWZeSY_sl9Ws1HBA48A483dtyhGmtC6eBNTnI~",
"alt": {
"tag": "plain_text",
"content": "提示hover"
},
"preview": true
},
"arrange": "bisected",
"tag": "div"
},
{
"actions": [
{
"text": {
"tag": "plain_text",
"content": "有回调的按钮"
},
"multiUrl": {
"url": "https://www.baidu.com",
"pcUrl": "https://www.4399.com",
"androidUrl": "",
"iosUrl": ""
},
"callBacks": [
{
"key": "click1",
"value": "1"
}
],
"confirm": {
"title": {
"tag": "plain_text",
"content": "弹窗标题"
},
"text": {
"tag": "plain_text",
"content": "弹窗内容"
}
},
"type": "primary",
"tag": "button",
"needLayout": true
},
{
"tag": "list_selector",
"placeholder": {
"tag": "plain_text",
"content": "默认文本"
},
"initialOption": "joy",
"options": [
{
"text": {
"tag": "plain_text",
"content": "下拉选项文本1"
},
"value": "joy"
},
{
"text": {
"tag": "plain_text",
"content": "下拉选项文本2"
},
"value": "2"
}
],
"callBacks": [
{
"key": "click1",
"value": "1"
}
],
"needLayout": true
}
],
"arrange": "bisected",
"tag": "actions"
},
{
"elements": [
{
"tag": "img",
"imgKey": "ade4bab797daa516jwFaTrfq3LOHdOfnIXEwYrmQzxtXN0CX5Azo6wTXz_Ws-sHsSAy7d5Css-Q1WMZjHlYqmxj8XyDw9vC1BpSzi4CuAcemLJnxTFuJDOZbYbd_umWklAQWUCjV0vRbmtfMVaSTbeSY_sl9Ws1HGg48RowjcYOmGmVk6eBXUHDe",
"preview": true,
"alt": {
"tag": "plain_text",
"content": "备注图片1"
}
},
{
"tag": "plain_text",
"content": "备注文本1"
},
{
"tag": "plain_text",
"content": "备注文本2"
}
],
"tag": "note"
},
{
"tag": "img",
"imgKey": "cfa2705bf496b6ecjwFaTrfq3LOHdOfnIXEwYrmQzxtXN0CX5Azo6wTXz_Ws-sHsSAy7d5Css-Q1WMZjHlYqmxj8XyDw9vC1BpSzk8quAeWmNOLxTFucCOZbYbd_umfllAQWTzPBwvRbruHMVaSRHOSY_sl9Ws1HGA48A483dtmJGmRs6eBNTnI~",
"title": {
"content": "这是图片标题",
"tag": "plain_text"
},
"alt": {
"content": "hover 提示",
"tag": "plain_text"
},
"preview": true
},
{
"tag": "markdown",
"content": "普通文本\n标准emoji 😁😢🌞💼🏆❌✅\n*斜体*\n**粗体**\n~~删除线~~\n<u>下划线</u>\n[直书链接](https://zhishu.zhipin.com/)",
"textAlign": "left"
}
]
}
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
# 发送消息卡片示例
通过调用 发送消息接口，向某个群组发送上图示例的审批消息卡片，cURL示例代码如下：
curl --location --request POST 'https://hi-gw.weizhipin.com/open-apis/im/v2/messages?receive_id_type=user_id' \
--header 'Authorization: Bearer b-z33z05ed4945ef9f451884186bf025281119' \
--header 'Content-Type: application/json' \
--data-raw '{
"receive_id": "11111111436",
"content": "{\"header\":{\"text\":{\"content\":\"多文本1\",\"tag\":\"plain_text\"},\"color\":\"grey\"},\"cardLink\":{\"url\":\"https://{{$themeConfig.openOrigin}}/app-manage\",\"pcUrl\":\"\",\"androidUrl\":\"\",\"iosUrl\":\"\"},\"globalConfig\":{\"forward\":true,\"shareCard\":true},\"modules\":[{\"title\":{\"tag\":\"plain_text\",\"content\":\"图片模块\"},\"imgKey\":\"16b4abd7b8d85821jwFaTrfq3LOHdOfnIXEwYrmQzxtXN0CX5Azo6wTXz_Ws-sHsSAy7d5Css-Q1WMZjHlYqmxj8XyDw9vC1BpSzk8quAeWmduLxTFuIAOZbYbd_umaOlAQWTzPBwvxbnrrMVaSWGOSY_sl9Ws1ILQ48A483dtmLGmZk6eBNTnI~\",\"alt\":{\"tag\":\"plain_text\",\"content\":\"图片文本\"},\"preview\":true,\"tag\":\"img\"},{\"tag\":\"split_line\"},{\"text\":{\"tag\":\"plain_text\",\"content\":\"内容模块文本1\"},\"tag\":\"div\"},{\"content\":\"普通文本标准\\n/nemoji 😁😢🌞💼🏆❌✅*斜体***粗体**~~删除线~~\",\"textAlign\":\"left\",\"multiUrl\":{\"url\":\"https://www.baidu.com\",\"pcUrl\":\"https://www.4399.com\",\"androidUrl\":\"\",\"iosUrl\":\"https://www.4399.com\"},\"tag\":\"markdown\"},{\"text\":{\"tag\":\"hi_md\",\"content\":\"**加粗** *斜体* ***加粗斜体*** ~~删除线~~ **~~加粗删除线~~** ***~~加粗斜体删除线~~*** [测试链接](www.baidu.com)\"},\"tag\":\"div\"},{\"text\":{\"tag\":\"plain_text\",\"content\":\"内容模块文本2\"},\"fields\":[{\"text\":{\"tag\":\"plain_text\",\"content\":\"多文本1\"},\"needLayout\":true},{\"text\":{\"tag\":\"plain_text\",\"content\":\"多文本2\"},\"needLayout\":true},{\"text\":{\"tag\":\"plain_text\",\"content\":\"多文本3\"},\"needLayout\":true},{\"text\":{\"tag\":\"plain_text\",\"content\":\"多文本4\"},\"needLayout\":true}],\"extra\":{\"tag\":\"img\",\"imgKey\":\"4491ba5156d2c694jwFaTrfq3LOHdOfnIXEwYrmQzxtXN0CX5Azo6wTXz_Ws-sHsSAy7d5Css-Q1WMZjHlYqmxj8XyDw9vC1BpSzk8quAeWmMqfxTFuIDOZbYbd_umCelAQWTzPBwvBbnbrMVaSWZeSY_sl9Ws1HBA48A483dtyhGmtC6eBNTnI~\",\"alt\":{\"tag\":\"plain_text\",\"content\":\"提示hover\"},\"preview\":true},\"arrange\":\"bisected\",\"tag\":\"div\"},{\"actions\":[{\"text\":{\"tag\":\"plain_text\",\"content\":\"有回调的按钮\"},\"multiUrl\":{\"url\":\"https://www.baidu.com\",\"pcUrl\":\"https://www.4399.com\",\"androidUrl\":\"\",\"iosUrl\":\"\"},\"callBacks\":[{\"key\":\"click1\",\"value\":\"1\"}],\"confirm\":{\"title\":{\"tag\":\"plain_text\",\"content\":\"弹窗标题\"},\"text\":{\"tag\":\"plain_text\",\"content\":\"弹窗内容\"}},\"type\":\"primary\",\"tag\":\"button\",\"needLayout\":true},{\"tag\":\"list_selector\",\"placeholder\":{\"tag\":\"plain_text\",\"content\":\"默认文本\"},\"initialOption\":\"joy\",\"options\":[{\"text\":{\"tag\":\"plain_text\",\"content\":\"下拉选项文本1\"},\"value\":\"joy\"},{\"text\":{\"tag\":\"plain_text\",\"content\":\"下拉选项文本2\"},\"value\":\"2\"}],\"callBacks\":[{\"key\":\"click1\",\"value\":\"1\"}],\"needLayout\":true}],\"arrange\":\"bisected\",\"tag\":\"actions\"},{\"elements\":[{\"tag\":\"img\",\"imgKey\":\"ade4bab797daa516jwFaTrfq3LOHdOfnIXEwYrmQzxtXN0CX5Azo6wTXz_Ws-sHsSAy7d5Css-Q1WMZjHlYqmxj8XyDw9vC1BpSzi4CuAcemLJnxTFuJDOZbYbd_umWklAQWUCjV0vRbmtfMVaSTbeSY_sl9Ws1HGg48RowjcYOmGmVk6eBXUHDe\",\"preview\":true,\"alt\":{\"tag\":\"plain_text\",\"content\":\"备注图片1\"}},{\"tag\":\"plain_text\",\"content\":\"备注文本1\"},{\"tag\":\"plain_text\",\"content\":\"备注文本2\"}],\"tag\":\"note\"},{\"tag\":\"img\",\"imgKey\":\"cfa2705bf496b6ecjwFaTrfq3LOHdOfnIXEwYrmQzxtXN0CX5Azo6wTXz_Ws-sHsSAy7d5Css-Q1WMZjHlYqmxj8XyDw9vC1BpSzk8quAeWmNOLxTFucCOZbYbd_umfllAQWTzPBwvRbruHMVaSRHOSY_sl9Ws1HGA48A483dtmJGmRs6eBNTnI~\",\"title\":{\"content\":\"这是图片标题\",\"tag\":\"plain_text\"},\"alt\":{\"content\":\"hover 提示\",\"tag\":\"plain_text\"},\"preview\":true},{\"tag\":\"markdown\",\"content\":\"普通文本\\n标准emoji 😁😢🌞💼🏆❌✅\\n*斜体*\\n**粗体**\\n~~删除线~~\\n<u>下划线</u>\\n[直书链接](https://zhishu.zhipin.com/)\",\"textAlign\":\"left\"}]}",
"msg_type": "compressive_card",
"uuid":"a0d69e20-1dd1-458b-k525-dfeca4015204"
}
'
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# 卡片预览
