wx.qy.getContext

wx.qy.getContext(Object object)

调用前提:

  1. 此接口仅在企业微信3.0.24及以后版本支持,微信端不支持(微信开发者工具也不支持)
  2. 必须先调用过wx.qy.login,且session_key未过期,开发者可调用checkSession 检查当前登录态
  3. 当前成员必须在应用的可见范围
  4. 从企业微信3.1.6版本开始,所有应用皆可调用,包括自建应用与第三方应用

调用该接口可以获得用户是从哪个入口打开页面,从而决定是否可以调用工具栏相关的接口

参数

Object object
参数名 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)
object.success 回调函数

参数

Object res

参数 类型 说明
entry String 返回进入小程序的入口类型,目前有normal、contact_profile、single_chat_tools、group_chat_tools、chat_attachment

entry 说明

说明
contact_profile 从联系人详情进入
single_chat_tools 从单聊会话的工具栏进入
group_chat_tools 从群聊会话的工具栏进入
chat_attachment 从聊天附件栏进入
normal 除以上场景之外进入,例如工作台,聊天会话等

示例代码:


wx.qy.getContext ({
  success: function(res) {
    var entry = res.entry //返回进入小程序的入口类型
  }
})

附:entry截图说明
1. 联系人详情的入口(注意配置入口是在企业管理端—外部沟通管理—自定义详情页)

配置之后,用户在终端查看外部联系人详情时,入口如下图:

2. 工具栏的入口(单聊或群聊)

3. 聊天附件栏的入口

特别注意:成员自定义对外信息的入口进入的,调用getContext返回的是normal(为什么呢?因为这里不涉及客户管理功能,并不能调用客户联系的相关接口),设置入口如下图:

© 1998 - 2021 Tencent Inc. All Rights Reserved