企业内部开发
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
企业内部开发
客户端API
JS-SDK
聊天工具栏
获取当前客户群的群ID
获取当前客户群的群ID
最后更新:2025/03/27

目录

  • ww.getCurExternalChat([params])
  • 功能描述
  • 使用限制
  • 参数说明
  • params: Object
  • 返回说明
  • 错误信息
  • 旧版jweixin调用
  • 示例代码
  • ww.getCurExternalChat([params])

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

    功能描述

    获取当前客户群的群 ID。

    ww.getCurExternalChat()

    使用限制

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

    • 从客户群或班级群的聊天工具栏进入页面时才可成功调用该接口

    • 不同的入口对应用及用户有相应的限制

      入口getContext 接口返回的 entry 值自建应用第三方应用用户兼容性
      外部群聊工具栏group_chat_tools需有客户联系功能权限需有“企业客户权限->客户基础信息”权限配置了客户联系功能企业微信 2.8.17
      班级群的聊天工具栏group_chat_tools所有需有「家校沟通」使用权限所有企业微信 3.0.36
      学生群的聊天工具栏group_chat_tools所有需有「家校沟通」使用权限所有企业微信 4.0.8

    参数说明

    params: Object

    属性类型必填说明
    successFunction

    成功回调

    failFunction

    失败回调

    cancelFunction

    取消回调

    completeFunction

    完成回调

    返回说明

    Promise<Object>

    属性类型必填说明
    errMsgstring

    通用错误信息

    errCodenumber

    通用错误码

    chatIdstring

    当前客户群的群 ID

    错误信息

    errMsg说明
    getCurExternalChat:ok执行成功
    getCurExternalChat:fail no permission应用签名校验失败,或签名所使用的应用不满足权限要求
    getCurExternalChat:fail without context of external contact当前页面入口不支持调用

    旧版jweixin调用

    示例代码

    wx.invoke('getCurExternalChat', {
            }, function(res){
            if(res.err_msg == "getCurExternalChat:ok"){
                chatId  = res.chatId ; //返回当前外部群的群聊ID
            }else {
                //错误处理
            }
        });
    上一篇获取当前客户ID
    下一篇隐藏聊天附件栏的发送按钮
      本节内容
    服务端API
    基础
    连接微信
    办公
    会议
    会议统计管理
    客户端API
    小程序
    基础
    连接微信
    办公
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们