第三方应用开发 客户端API WECOM-JSSDK 企业通讯录 企业互联/上下游选人接口
企业互联/上下游选人接口
最后更新:2023/02/23
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
企业互联/上下游选人接口
最后更新:2023/02/23

ww.selectCorpGroupContact(params)

兼容性:企业微信 iOS、Android、PC 3.1.6 开始支持

功能描述

企业互联选人

ww.selectCorpGroupContact({
  fromDepartmentId: -1,
  mode: 'single',
  type: ['department', 'user'],
  selectedDepartmentIds: ['2','3'],
  selectedUserIds: ['lisi','lisi2'],
  selectedOpenUserIds: ['wabc3','wbcde'],
  selectedChainDepartmentIds: [
    {
      corpId: 'ww3333',
      departmentId: '2'
    },
    {
      corpId: 'ww4444',
      departmentId: '3'
    }
  ],
  selectedChainUserIds: [
    {
      corpId: 'ww3333',
      userId: 'userid123',
      openUserId: 'wx1111'
    },
    {
      corpId: 'ww4444',
      userId: 'userid123',
      openUserId: 'wx1111'
    }
  ],
  selectedCorpGroupDepartmentIds: [
    {
      corpId: 'ww3333',
      departmentId: '2'
    },
    {
      corpId: 'ww4444',
      departmentId: '3'
    }
  ],
  selectedCorpGroupUserIds: [
    {
      corpId: 'ww3333',
      userId: 'userid123',
      openUserId: 'wx1111'
    },
    {
      corpId: 'ww4444',
      userId: 'userid123',
      openUserId: 'wx1111'
    }
  ]
})

参数说明

params: Object

属性类型默认值必填说明最低版本
fromDepartmentIdnumber

从指定的部门开始展示

  • -1 表示从自己所在部门开始

  • 0 表示从最上层开始

移动端,当需要展开的部门不在应用可见范围内,则从应用的可见范围开始展开

modestring

选择模式

合法值说明
single

单选

multi

多选

typestring[]

选择限制类型

合法值说明
department
user
selectedDepartmentIdsstring[]

已选部门 ID 列表

仅自建应用使用,第三方应用会忽略该字段

selectedUserIdsstring[]

已选用户 ID 列表

仅自建应用使用,第三方应用会忽略该字段

selectedOpenUserIdsstring[]

已选用户 OpenUserID 列表

仅第三方应用使用,自建应用会忽略该字段

selectedChainDepartmentIdsObject[]

已选上下游部门列表

企业微信 3.1.20

属性类型默认值必填说明最低版本
corpIdstring

Corp ID

departmentIdstring

部门 ID

selectedChainUserIdsObject[]

已选上下游用户列表

企业微信 3.1.20

属性类型默认值必填说明最低版本
corpIdstring

Corp ID

userIdstring

成员 ID

openUserIdstring

成员 OpenUserID

selectedCorpGroupDepartmentIdsObject[]

已选企业互联部门列表

属性类型默认值必填说明最低版本
corpIdstring

Corp ID

departmentIdstring

部门 ID

selectedCorpGroupUserIdsObject[]

已选企业互联用户列表

属性类型默认值必填说明最低版本
corpIdstring

Corp ID

userIdstring

成员 ID

openUserIdstring

成员 OpenUserID

successFunction

成功回调

failFunction

失败回调

cancelFunction

取消回调

completeFunction

完成回调

返回说明

Promise<Object>

属性类型默认值必填说明最低版本
errMsgstring

通用错误信息

errCodenumber

通用错误码

resultObject
属性类型默认值必填说明最低版本
departmentListObject[]

已选的部门列表

属性类型默认值必填说明最低版本
idstring

部门 ID

userListObject[]

已选的成员列表

属性类型默认值必填说明最低版本
idstring

成员 ID,仅自建应用返回

openUserIdstring

成员 OpenUserID,仅第三方应用返回

corpGroupDepartmentListObject[]

已选企业互联部门列表

属性类型默认值必填说明最低版本
corpIdstring

Corp ID

idstring

部门 ID

corpGroupUserListObject[]

已选企业互联用户列表

属性类型默认值必填说明最低版本
corpIdstring

Corp ID

idstring

成员 ID,仅自建应用返回

openUserIdstring

成员 OpenUserID,仅第三方应用返回

chainDepartmentListObject[]

已选上下游部门列表

企业微信 3.1.20

属性类型默认值必填说明最低版本
corpIdstring

Corp ID

idstring

部门 ID

chainUserListObject[]

已选上下游用户列表

企业微信 3.1.20

属性类型默认值必填说明最低版本
corpIdstring

Corp ID

idstring

成员 ID,仅自建应用返回

openUserIdstring

成员 OpenUserID,仅第三方应用返回

使用限制

  • 该接口仅可选择应用可见范围内的成员和部门

上一篇
调起个人信息页面
下一篇
认领老师班级