开发者中心
首页
教程
接口
社区
工具
企业内部开发
快速入门 服务端API 客户端API 附录 更新日志 联系我们
企业内部开发 服务端API 家校沟通 家校通讯录变更回调 成员变更事件
成员变更事件
最后更新：2023/11/29
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
成员变更事件
最后更新：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
    上一篇
    修改自动升年级的配置
    下一篇
    部门变更事件