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 用什么应用打开链接
  • browser 外置浏览器
  • webview 网页视图(终端内置)
  • viewMode string 条件 显示模式
  • full 全屏
  • half 半屏
  • tall 高
    必需: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   作者:王超