登录
第三方应用开发 客户端API 小程序 微信客服 wx.qy.navigateToKfChat
wx.qy.navigateToKfChat
最后更新：2021/09/29
接口说明：在企业微信内快速跳转到微信客服消息的界面
调用前提：
必须先调用过wx.qy.login，且session_key未过期，开发者可调用checkSession 检查当前登录态。
当前企业已开启「微信客服」应用。
当前成员指定客服账号的坐席，且必须在应用的可见范围之内。
wx.qy.navigateToKfChat(Object object)
参数
Object object
| 参数名 | 类型 | 必填 | 说明 | 企业微信版本要求 |
|---|---|---|---|---|
| openKfId | String | 是 | 客服账号ID | ≥3.1.12 |
| externalUserId | String | 否 | 微信客户ID，若没指定，则跳转到客服账号的消息列表界面 | ≥3.1.18 |
| success | Function | 否 | 接口调用成功的回调函数 | |
| fail | Function | 否 | 接口调用失败的回调函数 | |
| complete | Function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
示例代码：
wx.qy.navigateToKfChat({
openKfId: "wkAJ2GCAAAZSfhHCt7IFSvLKtMPxyAAA",
externalUserId: "wmAJ2GCAAAZSfhHCt7IFSvLKtMPxyBBB",
success: function(res) {
// 回调
}
});
平台版本说明
| 平台 | 企业微信版本要求 |
|---|---|
| ios | ≥3.1.12 |
| android | ≥3.1.12 |
| win | ≥3.1.12 |
| mac | 暂不支持 |
应用权限说明
| 应用类型 | 可调用的应用 |
|---|---|
| 自建应用 | 所有 |
| 第三方应用 | 需具有“微信客服->获取基础信息”权限 |
