第三方应用开发
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
第三方应用开发
客户端API
JS-SDK
第三方服务
打开应用管理页面
打开应用管理页面
最后更新:2025/03/27

目录

  • ww.openAppManage([params])
  • 功能描述
  • 使用限制
  • 参数说明
  • params: Object
  • 返回说明
  • 调用场景
  • 跳转应用管理
  • 跳转应用权限详情页
  • 跳转数据与智能专区权限授权页
  • 旧版jweixin调用
  • 示例代码
  • ww.openAppManage([params])

    兼容性:企业微信 4.0.2 开始支持

    功能描述

    打开应用管理页面。

    应用可以使用该接口提供按钮,让企业管理员快速打开应用的管理页面。

    ww.openAppManage({
      page: "permission",
      suiteId: "wwabcdefghijk",
    })

    使用限制

    • 本接口必须使用应用身份进行注册

    • 当前用户需要是企业超级管理员,或具有应用管理权限

    参数说明

    params: Object

    属性类型必填说明
    pagestring

    指定跳转的页面地址,不指定时跳转至应用管理首页

    合法值说明
    permission

    应用权限详情页

    datazone_permission

    数据与智能专区权限授权页

    需要满足:

    • 企业访问者身份为超级管理员

    • 应用需要满足勾选了“数据与智能专区权限”(注:该权限目前灰度开放)

    • 应用类型为第三方应用/代开发应用(注:不支持上下游共享应用)

    suiteIdstring

    指定跳转的关联应用

    • 不指定时,表示为跳转到 agentConfig 注册应用的管理页

    • 指定时,表示为跳转的其他应用管理页,目前仅支持会话内容存档应用

    使用限制

    服务商应用调用时,指定的 suiteid 必须为同服务商的应用,应用与当前企业需要有授权关系,且当前用户必须是企业超级管理员。

    successFunction

    成功回调

    failFunction

    失败回调

    cancelFunction

    取消回调

    completeFunction

    完成回调

    返回说明

    Promise<Object>

    属性类型必填说明
    errMsgstring

    通用错误信息

    errCodenumber

    通用错误码

    调用场景

    跳转应用管理

    当需要应用信息查看或者修改(如:可见范围/购买付费/应用评价),可跳转至该管理页进行操作。
    ww.openAppManage();

    跳转应用权限详情页

    查看应用已授权权限项,及更新应用最新权限(如应用有权限变更时)。
    ww.openAppManage({
        page: "permission"
    });

    跳转数据与智能专区权限授权页

    授权数据与智能专区权限,若已授权则为修改授权内容。
    ww.openAppManage({
        page: "datazone_permission"
    });

    旧版jweixin调用

    示例代码

    wx.invoke('openAppManage', 
     	{
    		"page": "permission", // 非必填,指定跳转的页面地址
    		"suiteId": "wwabcdefghijk", // 非必填,指定跳转的关联应用
     	}, 
     	function(res){
      	 	if(res.err_msg == "openAppManage:ok") {
      		// 调用成功              
       	 	}
       	 	if(res.err_msg == "openAppManage:fail:no permission") {
      		// 调用人身份不符合                 
       	 	}
       	 	if(res.err_msg == "openAppManage:fail:unknown app") {
      		// 应用信息获取失败
       	 	}
       	 	if(res.err_msg == "openAppManage:fail:unsupported app type") {
      		// 应用类型不符合要求
       	 	}
       	 	if(res.err_msg == "openAppManage:fail") {
      		// 其它错误                  
     	}      
    })
    上一篇进入应用客服会话
    下一篇打开应用评价页面
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    小程序接入对外收款
    客户端API
    小程序
    基础
    连接微信
    办公
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们