选择客户群 - 文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

登录

第三方应用开发

快速入门服务端API 客户端API 数据API

运营规范工具与资源附录更新日志

第三方应用开发

第三方应用开发

第三方应用开发

客户端API

JS-SDK

客户联系

选择客户群

选择客户群

最后更新：2025/11/17

ww.selectExternalChat([params])

兼容性：企业微信 iOS、Android、PC 5.0.2 开始支持

功能描述

唤起客户群列表，选择并返回客户群ID。

ww.selectExternalChat()

使用限制

本接口必须使用应用身份进行注册
仅支持「营销获客」分类的第三方应用调用
调用成员必须在应用的可见范围内

参数说明

params: Object

	属性	类型	必填	说明
	success	Function	否	成功回调
	fail	Function	否	失败回调
	cancel	Function	否	取消回调
	complete	Function	否	完成回调

返回说明

Promise<Object>

	属性	类型	必填	说明
	errMsg	string	是	通用错误信息
	errCode	number	是	通用错误码
	chatIdList	string[]	否	单次最多可选择 5 个

上一篇设置朋友圈封面与签名

下一篇聊天工具栏接口

关于腾讯用户协议帮助中心© 1998 - 2026 Tencent Inc. All Rights Reserved

粤公网安备 44030002000001号 ICP备案号粤B2-20090059 增值电信业务经营许可证粤B2-20090059

本节内容

快速入门

服务商注册应用

开发者注册应用

服务端API

开发指南

开发前必读

基本概念介绍

获取服务商凭证

基础

收银台

功能概述

商户号开通

定价策略配置

订单收款工具

企业客户购买

收款工具

创建收款订单

取消收款订单

获取收款订单列表

获取收款订单详情

发票管理

获取发票列表

标记开票状态

应用版本付费

获取订单列表

获取订单详情

获取企业永久授权码

获取企业授权信息

延长试用期

应用版本回调通知

下单成功通知

支付成功通知

应用版本变更通知

取消订单通知

推广二维码

调用接口

获取注册码

查询注册状态

设置授权应用可见范围

设置通讯录同步完成

回调通知

注册完成回调事件

扫描推广二维码事件

账号ID

安全性升级说明

企业微信账号ID安全性全面升级

代开发应用安全性升级

ID转换接口

corpid的转换

userid的转换

external_userid的转换

unionid与external_userid的关联

客户标签ID的转换

微信客服ID的转换

tmp_external_userid的转换

ID迁移完成状态的设置

获取接口大批量调用凭据

通讯录管理

成员管理

批量删除成员

获取部门成员

获取部门成员详情

userid与openid互换

手机号获取userid

邮箱获取userid

获取成员授权列表

查询成员用户是否已授权

获取选人ticket对应的用户

获取成员ID列表

部门管理

获取部门列表

获取子部门ID列表

获取单个部门详情

标签管理

更新标签名字

获取标签成员

增加标签成员

删除标签成员

获取标签列表

异步导入接口

增量更新成员

全量覆盖成员

全量覆盖部门

获取异步任务结果

异步导出接口

导出成员详情

导出标签成员

获取导出结果

导出任务完成通知

通讯录回调通知

成员通知事件

部门通知事件

标签通知事件

异步任务完成通知

通讯录展示组件

通讯录搜索

通讯录ID转译

异步通讯录id转译

获取异步任务结果

异步任务回调通知

通讯录userid排序

第三方通讯录编辑授权

身份验证

网页授权登录

构造网页授权链接

获取访问用户身份

获取访问用户敏感信息

企业微信Web登录

Web登录组件

获取登录用户身份

企业互联

获取应用共享信息

获取下级企业付费版本信息

上下游

获取应用共享信息

消息接收与发送

发送应用消息

发送应用模板消息

更新模版卡片消息

接收消息与事件

被动回复消息格式

撤回应用消息

应用管理

设置工作台自定义展示

素材管理

上传临时素材

获取临时素材

获取高清语音素材

异步上传临时素材

服务商上传临时素材

电子发票

查询电子发票

更新发票状态

批量更新发票状态

批量查询电子发票

数据与智能专区

基本概念介绍

专区程序开发指引

专区程序示例

专区程序SDK和示例下载

镜像文件配置指引

会话展示组件

基础接口

获取会话存档授权成员列表

设置专区接收回调事件

会话组件敏感信息隐藏设置

设置日志打印级别

上传临时文件到专区

获取数据与智能专区授权信息

获取数据与智能专区文档存档授权信息

获取文件内容存档授权成员列表

应用调用专区程序

应用同步调用专区程序

应用异步调用专区程序

专区程序接收事件通知

客户同意进行聊天内容存档事件回调

产生会话回调通知

命中关键词规则通知

知识集管理回调

会话内容导出完成通知

应用接收专区通知

应用接收专区通知

专区调试模式

开启专区调试模式

关闭专区调试模式

获取专区调试模式状态

订单管理接口

使用余额支付订单

获取订单列表

获取订单详情

获取企业已购信息

订单管理回调

支付成功通知

退款结果通知

取消订单通知

接口不足通知

接口购买到期通知

接口试用到期通知

连接微信

客户联系

成员对外信息

企业服务人员管理

获取配置了客户联系功能的成员列表

获取客户可建联成员

客户管理

获取客户列表

获取客户详情

批量获取客户详情

修改客户备注信息

unionid与external_userid的关联

代开发应用external_userid转换

客户联系规则组管理

客户标签管理

管理企业标签

编辑客户企业标签

管理企业规则组下的客户标签

在职继承

分配在职成员的客户

查询客户接替状态

分配在职成员的客户群

离职继承

获取待分配的离职成员列表

分配离职成员的客户

查询客户接替状态

分配离职成员的客户群

客户群管理

获取客户群列表

获取客户群详情

客户群opengid转换

联系我与客户入群方式

客户联系「联系我」管理

客户群「加入群聊」管理

客户朋友圈

企业发表内容到客户的朋友圈

停止发表企业朋友圈

获取客户朋友圈全部的发表记录

客户朋友圈规则组管理

获客助手

获客链接管理

获取由获客链接添加的客户信息

获客助手额度管理与使用统计

提升广告有效率

获取成员多次收消息详情

消息推送

创建企业群发

提醒成员群发

停止企业群发

获取企业的全部群发记录

发送新客户欢迎语

入群欢迎语素材管理

统计管理

获取「联系客户统计」数据

获取「群聊数据统计」数据

回调通知

获客助手事件通知

管理商品图册

管理聊天敏感词

上传附件资源

获客助手组件

获取获客转化数据指引

获取组件授权信息

获客链接管理

查询链接使用详情

生成代支付key

获取代支付流水

获客助手事件通知

授权通知事件

获取获客链接使用成员接受消息数据

微信客服

客服账号管理

添加客服账号

删除客服账号

修改客服账号

获取客服账号列表

获取客服账号链接

接待人员管理

添加接待人员

删除接待人员

获取接待人员列表

会话分配与消息收发

分配客服会话

接收消息和事件

发送欢迎语等事件响应消息

「升级服务」配置

其他基础信息获取

获取客户基础信息

获取企业状态信息

统计管理

获取「客户数据统计」企业汇总数据

获取「客户数据统计」接待人员明细数据

微信客服组件

获取客服账号列表

获取客服账号链接

获取客服数据统计

授权通知事件

企业支付

对外收款

获取对外收款记录

获取收款项目的商户单号

家校沟通

基础接口

获取「学校通知」二维码

管理「学校通知」的关注模式

发送「学校通知」

获取外部联系人详情

外部联系人openid转换

手机号转外部联系人ID

管理「老师可查看班级」模式

获取可使用的家长范围

网页授权登录

构造网页授权链接

获取访问用户身份

获取家校访问用户身份

学生与家长管理

批量创建学生

批量删除学生

批量更新学生

批量创建家长

批量删除家长

批量更新家长

读取学生或家长

获取部门学生详情

设置家校通讯录自动同步模式

获取部门家长详情

部门管理

获取部门列表

标准年级对照表

修改自动升年级的配置

家校通讯录变更回调

成员变更事件

部门变更事件

家校通讯录批量变更事件

家校应用

上课直播

获取老师直播ID列表

获取直播详情

获取观看直播统计

获取未观看直播统计

删除直播回放

获取观看直播统计V2

获取未观看直播统计V2

班级收款

获取学生付款结果

获取订单详情

办公

邮件

发送邮件

发送普通邮件

发送日程邮件

发送会议邮件

获取接收的邮件

获取收件箱邮件列表

获取邮件内容

文档

管理文档

重命名文档

获取文档基础信息

管理文档内容

编辑文档内容

获取文档数据

管理表格内容

编辑表格内容

获取表格行列信息

获取表格数据

管理智能文档内容

获取页面结构

添加内容块

更新内容块

删除内容块

获取内容块列表

导出内容块

获取数据源

添加数据表

删除数据表

更新数据表

发布智能文档

取消发布智能文档

修改发布页可查看范围

设置文档权限

获取文档权限信息

修改文档加入规则

修改文档成员与权限

修改文档安全设置

管理智能表格内容权限

管理收集表

创建收集表

编辑收集表

获取收集表信息

收集表的统计信息查询

读取收集表答案

回调通知

修改文档成员事件

删除文档事件

收集表完成事件

删除收集表事件

修改收集表设置事件

字段变更事件

记录变更事件

素材管理

上传文档图片

上传文档文件

分块上传文档文件

日程

管理日历

获取日历详情

管理日程

更新重复日程

新增日程参与者

删除日程参与者

获取日历下的日程列表

获取日程详情

回调通知

删除日历事件

修改日历事件

修改日程事件

删除日程事件

日程回执事件

会议

创建预约会议

修改预约会议

取消预约会议

获取成员会议ID列表

获取会议详情

直播

创建预约直播

修改预约直播

取消预约直播

删除直播回放

在微信中观看直播或直播回放

获取成员直播ID列表

获取直播详情

获取直播观看明细

直播回调事件

获取跳转小程序商城的直播观众信息

打卡

获取员工打卡规则

获取打卡记录数据

获取打卡日报数据

获取打卡月报数据

获取打卡人员排班信息

为打卡人员排班

获取设备打卡数据

审批

复制/更新模板到企业

获取审批模板详情

提交审批申请

审批申请状态变化回调通知

批量获取审批单号

获取审批申请详情

获取企业假期管理配置

获取成员假期余额

修改成员假期余额

审批流程引擎

智慧硬件

已支持设备

接口调用

获取硬件授权结果

获取考勤打卡原始数据

获取温度检测原始数据

获取门禁通行原始数据

读取门禁通行规则

写入门禁通行规则

修改门禁通行规则

删除门禁通行规则

回调通知

设备数据授权变更回调

考勤打卡原始数据回调

门禁通行原始数据回调

体温检测原始数据回调

小程序接入对外收款

客户端API

小程序

开发指南

开发前须知

开发者工具插件支持

小程序关联第三方应用

小程序体验版配置

微信小程序API支持情况

微信小程序组件支持情况

基础

登录

第三方小程序登录流程

wx.qy.checkSession

基础接口

wx.getSystemInfo

wx.getSystemInfoSync

wx.qy.getSystemInfo

wx.qy.getContext

企业通讯录

wx.qy.selectEnterpriseContact

wx.qy.openUserProfile

wx.qy.getEnterpriseUserInfo

wx.qy.getAvatar

wx.qy.getQrCode

wx.qy.selectCorpGroupContact

wx.qy.claimClassAdmin

wx.qy.selectPrivilegedContact

上下游

聊天工具栏接口

数据与智能专区

数据与智能专区文档选择

数据与智能专区文件选择

会话

wx.qy.openEnterpriseChat

wx.qy.updateEnterpriseChat

wx.qy.sendChatMessage

wx.qy.createCorpGroupChat

wx.qy.updateCorpGroupChat

NFC接口

wx.qy.getNFCReaderState

wx.qy.startNFCReader

wx.qy.stopNFCReader

onNFCReadMessage

更多

小程序发送通知

语音转文字接口

转发成功回调

从会话选择文件

连接微信

客户联系

wx.qy.selectExternalContact

wx.qy.openUserProfile

wx.qy.getCurExternalContact

wx.qy.getCurExternalChat

wx.qy.sendChatMessage

wx.qy.shareToExternalContact

wx.qy.shareToExternalChat

wx.qy.navigateToAddCustomer

「联系我」插件

wx.qy.shareToExternalMoments

wx.qy.updateMomentsSetting

wx.qy.selectExternalChat

微信客服

客服工具栏接口

微信小程序打开微信客服

wx.qy.navigateToKfChat

对外收款

发起对外收款

家校沟通

发起班级收款

微信小程序进入填写学生资料页面

政民沟通

微信进入居民上报小程序

办公

文档

日程

查看日程闲忙状态

会议

创建快速会议

微盘

选择目录位置

选择可下载的文件

直播

创建立即直播

观看直播回放

下载直播回放

第三方服务

进入应用客服会话

打开应用管理页面

打开应用评价页面

进入应用购买页面

智慧硬件

获取设备数据授权

JS-SDK

开发指南

基础

基础接口

ww.getSignature

ww.initOpenData

开放接口

创建企业微信登录面板

企业通讯录

选择通讯录成员

打开个人信息页接口

企业互联/上下游选人接口

返回ticket的选人接口

认领老师班级

聊天工具栏

获取当前客户ID

获取当前客户群的群ID

隐藏聊天附件栏的发送按钮

分享消息到当前会话

上下游

上下游聊天工具栏

获取上下游联系人ID

获取上下游互联群ID

数据与智能专区

数据与智能专区文档选择

数据与智能专区文件选择

会话

变更群成员

创建群聊并发送消息

打开已有群聊并发送消息

打开个人聊天窗口schema

创建企业互联/上下游会话

变更企业互联/上下游群成员

分享

监听「转发」按钮点击

监听「微信」按钮点击

监听「朋友圈」按钮点击

自定义转发到会话

自定义转发到微信

私密分享

设置私密消息

获取私密消息Ticket

获取私密消息信息

界面

监听页面返回

隐藏右上角菜单

显示右上角菜单

关闭当前窗口

批量隐藏功能按钮

批量显示功能按钮

隐藏非基础按钮

显示非基础按钮

打开默认浏览器

监听截屏事件

系统界面

调起扫一扫

跳转认证界面

调起电子发票

跳转到小程序

保持屏幕常亮

图像

获取本地图片

音频

监听录音自动停止

监听播放完毕

语音转文字

文件

从会话选择文件

获取本地临时文件

Wi-Fi

初始化 Wi-Fi 模块

关闭 Wi-Fi 模块

获取 Wi-Fi 列表

监听 Wi-Fi 列表更新

监听 Wi-Fi 连接成功

获取已连接中的 Wi-Fi 信息

蓝牙

初始化蓝牙模块

关闭蓝牙模块

获取本机蓝牙状态

监听蓝牙状态变化

开始搜寻附近的蓝牙外围设备

停止搜寻蓝牙外围设备

获取已发现的蓝牙设备

监听寻找到新设备

获取已连接状态的设备

蓝牙（BLE）

连接BLE设备

断开设备连接

监听BLE设备连接状态

获取BLE设备所有服务

获取BLE设备特征值

读取BLE设备特征值数据

写入BLE设备特征值数据

启用BLE设备特征值订阅

监听BLE设备特征值变化

iBeacon

搜索附近设备

停止搜索设备

获取已搜索到的设备

监听设备更新

监听设备服务状态

网络

获取网络状态

监听网络状态

剪贴板

获取剪贴板内容

设置剪贴板内容

地理位置

打开内置地图

获取地理位置

打开持续定位

停止持续定位

监听地理位置

连接微信

客户联系

外部联系人选人接口

打开个人信息页接口

聊天工具栏接口

群发消息给客户

群发消息到客户群

进入添加客户界面

发表内容到客户朋友圈

设置朋友圈封面与签名

选择客户群

微信客服

聊天工具栏接口

进入微信客服消息界面

对外收款

发起对外收款

家校沟通

发起班级收款

微信H5页面唤起填写学生资料页面

政民沟通

微信进入居民上报小程序

办公

文档

文件/文档标题展示组件

日程

查看日程闲忙状态

会议

创建快速会议

微盘

选择目录位置

选择可下载的文件

文件/文档标题展示组件

直播

创建立即直播

观看直播回放

下载直播回放

审批

应用发起审批

审批控件中的外部选项

保存选择的选项

获取已选择的选项

第三方服务

进入应用客服会话

打开应用管理页面

打开应用评价页面

进入应用购买页面

智慧硬件

获取设备数据授权

查询视频会议

加入视频会议

附录

JS-SDK 签名算法

所有菜单项列表

常见错误及解决方法

数据API

开发指南

获取数据权限接入指引

获客助手

获取由获客链接添加的客户信息

获取成员多次收消息详情

回调通知

获客助手事件通知

客户回调事件

数据与智能专区

基础接口

获取会话存档授权成员列表

设置专区接收回调事件

设置日志打印级别

上传临时文件到专区

获取数据与智能专区授权信息

应用调用专区程序

应用同步调用专区程序

应用异步调用专区程序

专区程序接收事件通知

客户同意进行聊天内容存档事件回调

产生会话回调通知

命中关键词规则通知

会话内容导出完成通知

应用接收专区通知

应用接收专区通知

专区调试模式

开启专区调试模式

关闭专区调试模式

获取专区调试模式状态

订单管理接口

使用余额支付订单

获取订单列表

获取订单详情

获取企业已购信息

订单管理回调

支付成功通知

退款结果通知

取消订单通知

接口不足通知

接口购买到期通知

接口试用到期通知

运营规范

企业微信应用接入指引

企业微信解决方案录入指引

应用推荐规范

企业微信第三方应用平台运营规则

工具与资源

开发者工具

样式库 WeUI for Work

设计资源下载

加解密库下载与返回码

接口代码参考示例

企业微信应用深色模式色值表

附录

加解密方案说明

访问频率限制

全局错误码

企业规模与行业信息

常见问题 - FAQ

通讯录展示控件 - FAQ

与企业号接口差异

深色模式适配指南

购买接口许可支持关联代开发应用订单

更新日志