服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
微信客服
回调通知
回调通知
最后更新:2023/11/30

目录

  • 客服账号授权变更事件
  • 为了让实时获取企业的微信客服的状态,企业微信会将特定的事件推送给应用配置的回调URL

    接收并解析事件的方法见:接收事件

    应用类型权限要求接收事件开关
    自建应用配置到「微信客服- 可调用接口的应用」中微信客服消息和事件
    代开发应用具有「微信客服->管理账号、分配会话和收发消息」权限
    第三方应用具有「微信客服->管理账号、分配会话和收发消息」权限

    特别说明:

    • 对自建应用,配置到「微信客服- 可调用接口的应用」且授权了至少一个客服账号后,则自动获得「微信客服->管理账号、分配会话和收发消息」权限
    • 「取消客服账号的授权」事件,不需要有微信客服权限(如因权限被移除引起的客服账号取消授权)

     

    客服账号授权变更事件

    当应用授权的客服账号发生变化(新增/取消客服账号的授权),触发该回调。

    示例

    <xml>
       <ToUserName><![CDATA[toUser]]></ToUserName>
       <FromUserName><![CDATA[sys]]></FromUserName> 
       <CreateTime>1348831860</CreateTime>
       <MsgType><![CDATA[event]]></MsgType>
       <Event><![CDATA[kf_account_auth_change]]></Event>
       <AuthAddOpenKfId><![CDATA[wkxxxx1]]></AuthAddOpenKfId>
       <AuthDelOpenKfId><![CDATA[wkxxxx2]]></AuthDelOpenKfId>
    </xml>

     

    说明

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间,unix时间戳
    MsgType消息类型,此时固定为:event
    Event事件类型,此时固定为:kf_account_auth_change
    AuthAddOpenKfId新增授权的客服账号列表,多个AuthAddOpenKfId节点表示多个新增账号
    AuthDelOpenKfId取消授权的客服账号列表,多个AuthDelOpenKfId节点表示多个取消账号

     

    上一篇获取「客户数据统计」接待人员明细数据
    下一篇概述
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们