1 message消息结构说明

1.1 message 卡片消息 数据结构

1.2 单卡片消息数据结构

1.2.1 generalPurposeCard数据结构

1.2.2 单卡片content数据结构

1.2.3 单卡片layout数据结构

1.2.4 media数据结构

1.2.5 数据示例

{
    "message": {
        "generalPurposeCard": {
            "content": {
                "description": "这是卡片正文",
                "media": {
                    "height": "MEDIUM_HEIGHT",
                    "mediaContentType": "image/png",
                    "mediaFileSize": "1259515",
                    "mediaUrl": "https://ftnj01.xnq.r.10086.cn:10099/s/003032024040311atT7rLLdSyn050FD.png"
                },
                "suggestions": [{
                        "action": {
                            "displayText": "打开链接(内置浏览器)",
                            "postback": {
                                "data": "open_url_internal"
                            },
                            "urlAction": {
                                "openUrl": {
                                    "application": "webview",
                                    "url": "https://rcs.10086.cn/"
                                }
                            }
                        }
                    },
                    {
                        "action": {
                            "displayText": "打开链接(默认浏览器)",
                            "postback": {
                                "data": "open_url_browser"
                            },
                            "urlAction": {
                                "openUrl": {
                                    "application": "browser",
                                    "url": "https://rcs.10086.cn/"
                                }
                            }
                        }
                    },
                    {
                        "action": {
                            "mapAction": {
                                "requestLocationPush": {}
                            },
                            "displayText": "上报当前位置",
                            "postback": {
                                "data": "set_by_chatbot_request_location_push"
                            }
                        }
                    }
                ],
                "title": "这是卡片标题"
            },
            "layout": {
                "cardOrientation": "VERTICAL",
                "imageAlignment": "LEFT"
            }
        }
    }
}

1.3 多卡片消息数据结构

1.3.1 generalPurposeCardCarousel多卡片消息结构

1.3.2 多卡片content数据结构

1.3.3 多卡片layout数据结构

1.3.4 数据示例

{
    "message": {
        "generalPurposeCardCarousel": {
            "layout": {
                "cardWidth": "MEDIUM_WIDTH"
            },
            "content": [{
                "media": {
                    "mediaUrl": "https://ftjn01.xnq.r.10086.cn:10099/s/0110120430804161p1FVZ0sZHk027FD.gif",
                    "mediaContentType": "image/gif",
                    "mediaFileSize": "209484",
                    "height": "MEDIUM_HEIGHT",
                    "thumbnailUrl": "https://ftjn01.xnq.r.10086.cn:10099/s/0110120430804161p1FVZ0sZHk027TD",
                    "thumbnailContentType": "image/jpeg",
                    "thumbnailFileSize": "9431"
                },
                "title": "这是卡片1标题",
                "description": "这是卡片1正文内容……",
                "suggestions": [{
                    "reply": {
                        "displayText": "上行YES",
                        "postback": {
                            "data": "YES"
                        }
                    }
                }, {
                    "action": {
                        "displayText": "打开链接",
                        "postback": {
                            "data": "1536309460312657920"
                        },
                        "urlAction": {
                            "openUrl": {
                                "url": "https://rcs.10086.cn/",
                                "application": "browser"
                            }
                        }
                    }
                }]
            }, {
                "media": {
                    "mediaUrl": "https://ftjn01.xnq.r.10086.cn:10099/s/0110120430804161p1FVZ0sZHk027FD.gif",
                    "mediaContentType": "image/gif",
                    "mediaFileSize": "209484",
                    "height": "MEDIUM_HEIGHT",
                    "thumbnailUrl": "https://ftjn01.xnq.r.10086.cn:10099/s/0110120430804161p1FVZ0sZHk027TD",
                    "thumbnailContentType": "image/jpeg",
                    "thumbnailFileSize": "9431"
                },
                "title": "这是卡片2标题",
                "description": "这是卡片2正文内容……",
                "suggestions": [{
                    "reply": {
                        "displayText": "上行NO",
                        "postback": {
                            "data": "1536309659126861824"
                        }
                    }
                }, {
                    "action": {
                        "displayText": "拨打10086",
                        "postback": {
                            "data": "1536309578193571840"
                        },
                        "dialerAction": {
                            "dialPhoneNumber": {
                                "phoneNumber": "10086"
                            }
                        }
                    }
                }]
            }]
        }
    }
}

1.4 suggestions数据结构

1.4.1 action数据结构

1.4.2 postback数据结构

1.4.3 数据示例

[{
  "reply": {
    "displayText": "上行NO",
    "postback": {
      "data": "1536309659126861824"
    }
  }
}, {
  "action": {
    "displayText": "拨打10086",
    "postback": {
      "data": "1536309578193571840"
    },
    "dialerAction": {
      "dialPhoneNumber": {
        "phoneNumber": "10086"
      }
    }
  }
}]

2 action 事件数据结构说明

2.1 urlAction 链接事件

2.1.1 openUrl数据结构

2.1.2 数据示例

{
  "openUrl": {
    "application": "webview",
    "url": "https://www.mysubmail.com",
    "viewMode": "full",
    "parameters": "visitorId=10001&code=123456"
  }
}

2.2 dialerAction 拨号事件

2.2.1 dialPhoneNumber数据结构

2.2.2 dialEnrichedCall数据结构

2.2.3 dialVideoCall数据结构

2.2.4 数据示例

{
  "dialPhoneNumber": {
    "phoneNumber": "15288888888"
  }
}

2.3 mapAction 地图事件

2.3.1 showLocation 数据结构

2.3.2 requestLocationPush 数据结构

2.3.3 location 数据结构

2.3.4 数据示例

{
  "showLocation": {
    "location": {
      "latitude": 23.170408552888855,
      "longitude": 113.40224851582335,
      "label": "中国移动南方基地智汇中心"
    },
    "fallbackUrl": "https://j.map.baidu.com/eb/XWkf"
  }
}

2.4 calendarAction 日历事件

2.4.1 createCalendarEvent数据结构

2.4.2 数据示例

{
  "createCalendarEvent": {
    "startTime": "2024-04-14T00:00:00Z",
    "endTime": "2024-04-14T23:59:59Z",
    "title": "会议提醒",
    "description": "下午3点公司会议"
  }
}

2.5 composeAction 编写消息草稿事件

2.5.1 composeTextMessage数据结构

2.5.2 composeRecordingMessage数据结构

2.5.3 数据示例

暂无

2.6 deviceAction 与设备交互事件

2.7 settingsAction 与应用设备进行交互的事件

附录：富媒体卡片支持的 CSS 属性说明

富媒体卡片的 CSS 控制元素包含以下四种：

1.整个富媒体卡片，与 CSS 中的消息选择器一起引用

2.富媒体卡片标题，与 CSS 中的 message.content.Title 选择器一起引用

3.富媒体卡片描述，与 CSS 中的 message.content.description 选择器一起引用

4.富媒体卡片建议，与 CSS 中的 message.content.suggestions 选择器一起引用

富媒体卡片支持的 CSS 选择器和属性如下表所示：

示例：

@charset "utf-8";
/* CSS Document */
Message {
 text-align:center;
 font-size:12px;
 color:#555;
 font-family:Verdana, Arial, Helvetica, sans-serif;
 background-color: green;
}
message.content.title {
 font-size:14px;
 font-weight:bold;
 color:#666699
}
message.content.description {
 color:#666699
}
message.content.suggestions {
 color:#669999
}