1.2、点击事件

固定菜单、悬浮菜单、建议菜单
有三种菜单:建议菜单,悬浮菜单,固定菜单。菜单绑定点击事件。在消息中建议菜单、悬浮菜单、固定菜单的功能一样、位置不同有7种绑定的点击事件:上行回复、拨打电话、撰写消息、设置日历、打开链接、地理位置、分享设备信息。其中建议菜单只能是单卡片、多卡片才可设置。
1.2.1、上行回复
| 名称 | 数据类型 | 是否必有 | 描述 | ||
|---|---|---|---|---|---|
| reply | object | 是 | 点击事件对象 | ||
| displayText | string | 是 | 按钮名称 文字个数[1, 25] |
||
| postback | object | 否 | 回执对象 | ||
| data | string | 是 | 回执内容 文字个数[1, 2000] |
||
{
"reply": {
"displayText": "上行回复",
"postback": {
"data": "回执操作"
}
}
}1.2.2、拨打电话
| 名称 | 数据类型 | 是否必有 | 描述 | |||
|---|---|---|---|---|---|---|
| action | object | 是 | 点击事件对象 | |||
| displayText | string | 是 | 按钮名称 文字个数[1, 25] |
|||
| postback | object | 否 | 回执对象 | |||
| data | string | 是 | 回执内容 文字个数[1, 2000] |
|||
| dialerAction | object | 是 | 拨打电话对象 | |||
| dialPhoneNumber | object | 否 | 普通电话 | |||
| phoneNumber | string | 是 | 电话号码 | |||
{
"action": {
"displayText": "普通电话",
"postback": {
"data": "回执操作"
},
"dialerAction": {
"dialPhoneNumber": {
"phoneNumber": "15766666666"
}
}
}
}1.2.3、撰写消息
| 名称 | 数据类型 | 是否必有 | 描述 | |||
|---|---|---|---|---|---|---|
| action | object | 是 | 点击事件对象 | |||
| displayText | string | 是 | 按钮名称 文字个数[1, 25] |
|||
| postback | object | 否 | 回执对象 | |||
| data | string | 是 | 回执内容 文字个数[1, 2000] |
|||
| composeAction | object | 是 | 撰写消息 | |||
| composeTextMessage | object | 否 | 短信草稿 | |||
| phoneNumber | string | 是 | 电话号码 | |||
| text | string | 是 | 消息内容 文字个数[1, 100] |
|||
{
"action": {
"displayText": "短信草稿",
"postback": {
"data": "回执操作"
},
"composeAction": {
"composeTextMessage": {
"phoneNumber": "15766666666",
"text": "消息内容"
}
}
}
}1.2.4、设置日历
| 名称 | 数据类型 | 是否必有 | 描述 | |||
|---|---|---|---|---|---|---|
| action | object | 是 | 点击事件对象 | |||
| displayText | string | 是 | 按钮名称 文字个数[1, 25] |
|||
| postback | object | 否 | 回执对象 | |||
| data | string | 是 | 回执内容 文字个数[1, 2000] |
|||
| calendarAction | object | 是 | 设置日历 | |||
| createCalendarEvent | object | 是 | 日历创建事件 | |||
| startTime | date | 是 | 开始时间 格式:2022-12-28 12:20:25 |
|||
| endTime | date | 是 | 结束时间 格式:2022-12-29 12:20:25 |
|||
| title | string | 是 | 标题 文字个数[1, 100] |
|||
| description | string | 否 | 描述 文字个数[5, 100] |
|||
{
"action": {
"displayText": "设置日历",
"postback": {
"data": "回执操作"
},
"calendarAction": {
"createCalendarEvent": {
"startTime": "2022-12-28 12:20:25",
"endTime": "2022-12-29 12:20:25",
"title": "结婚纪念日",
"description": "5201314"
}
}
}
}1.2.5、打开链接
| 名称 | 数据类型 | 是否必有 | 描述 | |||
|---|---|---|---|---|---|---|
| action | object | 是 | 点击事件对象 | |||
| displayText | string | 是 | 按钮名称 文字个数[1, 25] |
|||
| postback | object | 否 | 回执对象 | |||
| data | string | 是 | 回执内容 文字个数[1, 2000] |
|||
| urlAction | object | 是 | 打开链接 | |||
| openUrl | object | 是 | 打开链接 | |||
| url | string | 是 | 链接地址 | |||
| application | string | 是 | 用什么应用打开链接 |
|||
| viewMode | string | 条件 | 显示模式 必需:application = webview |
|||
| parameters | string | 条件 | 参数 文字个数[1, 200] 必需:application = webview |
|||
{
"action": {
"displayText": "打开链接",
"postback": {
"data": "回执操作"
},
"urlAction": {
"openUrl": {
"url": "https://www.baidu.com",
"application": "browser"
}
}
}
}1.2.6、地理位置
| 名称 | 数据类型 | 是否必有 | 描述 | ||||
|---|---|---|---|---|---|---|---|
| action | object | 是 | 点击事件对象 | ||||
| displayText | string | 是 | 按钮名称 文字个数[1, 25] |
||||
| postback | object | 否 | 回执对象 | ||||
| data | string | 是 | 回执内容 文字个数[1, 2000] |
||||
| mapAction | object | 是 | 地理位置 | ||||
| showLocation | object | 是 | 展示地理位置 | ||||
| location | object | 是 | 地理位置 | ||||
| longitude | string | 条件 | 经度 格式:116.403978 不选字段query才可选此字段,要与latitude一起使用 |
||||
| latitude | string | 条件 | 纬度 格式:39.915031 不选字段query才可选此字段,要与latitude一起使用 |
||||
| label | string | 否 | 标签 文字个数[1, 100] |
||||
| query | string | 条件 | 查询地理位置 文字个数[1, 200] 不选latitude和longitude 才可选此字段 |
||||
{
"action": {
"displayText": "地理位置/展示位置",
"postback": {
"data": "回执操作"
},
"mapAction": {
"showLocation": {
"location": {
"longitude": "116.403978",
"latitude": "39.915031",
"label": "天安门"
}
}
}
}
}1.2.7、分享设备信息
| 名称 | 数据类型 | 是否必有 | 描述 | ||
|---|---|---|---|---|---|
| action | object | 是 | 点击事件对象 终端分享设备信息给运营商平台,在平台的“接收记录”可查看设备信息 |
||
| displayText | string | 是 | 按钮名称 文字个数[1, 25] |
||
| postback | object | 否 | 回执内容 | ||
| data | string | 是 | 回执内容 文字个数[1, 2000] |
||
| deviceAction | object | 是 | 对象 | ||
| requestDeviceSpecifics | object | 是 | 请求设备细节 无需内容 |
||
{
"action": {
"displayText": "分享设备信息",
"postback": {
"data": "上行消息"
},
"deviceAction": {
"requestDeviceSpecifics": {}
}
}
}文档更新时间: 2025-12-17 09:37 作者:王超