Skip to content

Menu API

订阅号/服务号通用

方法

addConditionalMenu()

创建个性化菜单。 文档: 查看官方文档

签名

ts
addConditionalMenu(payload)

参数

参数类型必填默认值说明
payloadObject- 个性化菜单定义({ button: [...], matchrule: {...} })

返回值

类型:Promise<{errcode:number, errmsg:string, menuid?:string}>

说明:menuid)

示例

ts
// 用法示例
await client.addConditionalMenu(payload);

createCustomMenu()

创建自定义菜单。 文档: 查看官方文档

签名

ts
createCustomMenu(payload)

参数

参数类型必填默认值说明
payloadObject- 菜单定义({ button: [...] })

返回值

类型:Promise<{errcode:number, errmsg:string}>

示例

ts
// 用法示例
await client.createCustomMenu(payload);

deleteConditionalMenu()

删除个性化菜单。 文档: 查看官方文档

签名

ts
deleteConditionalMenu(params)

参数

参数类型必填默认值说明
params{menuid: string}- 必填,待删除的个性化菜单 ID

返回值

类型:Promise<{errcode:number, errmsg:string}>

示例

ts
// 用法示例
await client.deleteConditionalMenu(params);

deleteMenu()

删除自定义菜单(包含删除全部个性化菜单)。 文档: 查看官方文档

签名

ts
deleteMenu()

返回值

类型:Promise<{errcode:number, errmsg:string}>

示例

ts
// 用法示例
await client.deleteMenu();

getCurrentSelfMenuInfo()

获取自定义菜单配置(账号当前自定义菜单信息)。 文档: 查看官方文档

签名

ts
getCurrentSelfMenuInfo()

返回值

类型:Promise<Object>

示例

ts
// 用法示例
await client.getCurrentSelfMenuInfo();

getMenu()

获取自定义菜单(包含个性化菜单 if any)。 文档: 查看官方文档

签名

ts
getMenu()

返回值

类型:Promise<Object>

示例

ts
// 用法示例
await client.getMenu();

tryMatchMenu()

测试个性化菜单匹配结果。 文档: 查看官方文档

签名

ts
tryMatchMenu(params)

参数

参数类型必填默认值说明
params{user_id: string}- 必填,用户标识(可以是 openid 或者 微信号)

返回值

类型:Promise<Object>

示例

ts
// 用法示例
await client.tryMatchMenu(params);