服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
家校沟通
家校通讯录变更回调
成员变更事件
成员变更事件
最后更新:2023/11/29

目录

  • 接收回调权限说明
  • 新增学生事件
  • 编辑学生事件
  • 删除学生事件
  • 新增家长事件
  • 编辑家长事件
  • 删除家长事件
  • 家长关注事件
  • 家长取消关注事件
  • 接收回调权限说明

    需具备相应的权限以及打开对应的接收事件开关才能接收回调。

    应用类型权限要求接收事件开关
    自建应用配置到「家校沟通- 可调用接口的应用」中或者「家校沟通- 配置-家长可使用的应用」外部联系人变更回调
    代开发应用具有「家校沟通->家校通讯录读取权限”」权限
    第三方应用具有「家校沟通->「家校沟通」使用权限,包括读取家长信息(不含电话)和给家长发通知”」或者「「家校沟通」使用和编辑权限,包括编辑家校通讯录和给家长发通知」权限

    新增学生事件

    当学校在家校通讯录中新增学生时,回调此事件。

    xml请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_school_contact]]></Event>
    	<ChangeType><![CDATA[create_student]]></ChangeType>
    	<Id><![CDATA[xiaoming]]></Id>
    </xml>

     

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_school_contact
    ChangeType此时固定为create_student
    Id新增学生的家校通讯录userid

     

    编辑学生事件

    当学校在家校通讯录中更新学生信息或与之相关联的家长信息时,回调此事件。

     

    xml请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_school_contact]]></Event>
    	<ChangeType><![CDATA[update_student]]></ChangeType>
    	<Id><![CDATA[xiaoming]]></Id>
    	
    </xml>

     

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_school_contact
    ChangeType此时固定为update_student
    Id更新学生的家校通讯录userid

     

    删除学生事件

    当学校在家校通讯录中删除学生时,回调此事件。

    xml请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_school_contact]]></Event>
    	<ChangeType><![CDATA[delete_student]]></ChangeType>
    	<Id><![CDATA[xiaoming]]></Id>
    </xml>

     

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_school_contact
    ChangeType此时固定为delete_student
    Id删除学生的家校通讯录userid

     

    新增家长事件

    当学校在家校通讯录中新增家长时,回调此事件。

    xml请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_school_contact]]></Event>
    	<ChangeType><![CDATA[create_parent]]></ChangeType>
    	<Id><![CDATA[zhangsan]]></Id>
    </xml>

     

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_school_contact
    ChangeType此时固定为create_parent
    Id新增家长的家校通讯录userid

     

    编辑家长事件

    当学校在家校通讯录中更新家长信息时,回调此事件。

     

    xml请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_school_contact]]></Event>
    	<ChangeType><![CDATA[update_parent]]></ChangeType>
    	<Id><![CDATA[zhangsan]]></Id>
    	
    </xml>

     

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_school_contact
    ChangeType此时固定为update_parent
    Id更新家长的家校通讯录userid

     

    删除家长事件

    当学校在家校通讯录中删除家长时,回调此事件。

    xml请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_school_contact]]></Event>
    	<ChangeType><![CDATA[delete_parent]]></ChangeType>
    	<Id><![CDATA[zhangsan]]></Id>
    </xml>

     

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_school_contact
    ChangeType此时固定为delete_parent
    Id删除家长的家校通讯录userid

    家长关注事件

    当家长关注家校通知时,回调此事件。

    xml请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_school_contact]]></Event>
    	<ChangeType><![CDATA[subscribe]]></ChangeType>
    	<Id><![CDATA[xiaoming]]></Id>
    </xml>

     

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_school_contact
    ChangeType此时固定为subscribe
    Id家长的userid

    家长取消关注事件

    当家长取消关注家校通知时,回调此事件。

    xml请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_school_contact]]></Event>
    	<ChangeType><![CDATA[unsubscribe]]></ChangeType>
    	<Id><![CDATA[xiaoming]]></Id>
    </xml>

     

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_school_contact
    ChangeType此时固定为unsubscribe
    Id家长的userid
    上一篇修改自动升年级的配置
    下一篇部门变更事件
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们