成员变更事件 - 文档 - 企业微信开发者中心

第三方应用开发

快速入门服务端API 客户端API 工具与资源运营规范附录更新日志联系我们

第三方应用开发

服务端API

家校沟通

家校通讯录变更回调

成员变更事件

最后更新：2020/01/12

新增学生事件

当学校在家校通讯录中新增学生时，回调此事件至第三方应用/套件的指令回调URL。

请求示例：

<xml>
    <SuiteId><![CDATA[wwSuiteId]]></SuiteId>
    <AuthCorpId><![CDATA[wxAuthCorpId]]></AuthCorpId>
    <InfoType><![CDATA[change_school_contact]]></InfoType>
    <TimeStamp>1403610513</TimeStamp>
    <ChangeType><![CDATA[create_student]]></ChangeType>
    <Id><![CDATA[zhangsan]]></Id>
</xml>

参数说明：

参数	说明
SuiteId	第三方应用ID
AuthCorpId	授权企业的CorpID
InfoType	固定为change_school_contact
TimeStamp	时间戳
ChangeType	此处固定为create_student
Id	新增学生的家校通讯录userid

编辑学生事件

当学校在家校通讯录中更新学生信息或与之相关联的家长信息时，回调此事件至第三方应用/套件的指令回调URL。

请求示例：

<xml>
    <SuiteId><![CDATA[wwSuiteId]]></SuiteId>
    <AuthCorpId><![CDATA[wxAuthCorpId]]></AuthCorpId>
    <InfoType><![CDATA[change_school_contact]]></InfoType>
    <TimeStamp>1403610513</TimeStamp>
    <ChangeType><![CDATA[update_student]]></ChangeType>
    <Id><![CDATA[zhangsan]]></Id>
	<NewId><![CDATA[zhangsan2]]></NewId>
</xml>

参数说明：

参数	说明
SuiteId	第三方应用ID
AuthCorpId	授权企业的CorpID
InfoType	固定为change_school_contact
TimeStamp	时间戳
ChangeType	此时固定为update_student
Id	更新学生的家校通讯录userid
NewId	新的学生userid，只在userid被修改时回调

删除学生事件

当学校在家校通讯录中删除学生时，回调此事件至第三方应用/套件的指令回调URL。

请求示例：

<xml>
	<SuiteId><![CDATA[wwSuiteId]]></SuiteId>
    <AuthCorpId><![CDATA[wxAuthCorpId]]></AuthCorpId>
    <InfoType><![CDATA[change_school_contact]]></InfoType>
    <TimeStamp>1403610513</TimeStamp>
    <ChangeType><![CDATA[delete_student]]></ChangeType>
    <Id><![CDATA[zhangsan]]></Id>
</xml>

参数说明：

参数	说明
SuiteId	第三方应用ID
AuthCorpId	授权企业的CorpID
InfoType	固定为change_school_contact
TimeStamp	时间戳
ChangeType	此时固定为delete_student
Id	删除学生的家校通讯录userid

新增家长事件

当学校在家校通讯录中新增家长时，回调此事件至第三方应用/套件的指令回调URL。

请求示例：

<xml>
    <SuiteId><![CDATA[wwSuiteId]]></SuiteId>
    <AuthCorpId><![CDATA[wxAuthCorpId]]></AuthCorpId>
    <InfoType><![CDATA[change_school_contact]]></InfoType>
    <TimeStamp>1403610513</TimeStamp>
    <ChangeType><![CDATA[create_parent]]></ChangeType>
    <Id><![CDATA[zhangsan]]></Id>
</xml>

参数说明：

参数	说明
SuiteId	第三方应用ID
AuthCorpId	授权企业的CorpID
InfoType	固定为change_school_contact
TimeStamp	时间戳
ChangeType	此时固定为create_parent
Id	新增家长的家校通讯录userid

编辑家长事件

当学校在家校通讯录中更新家长信息时，回调此事件至第三方应用/套件的指令回调URL。

请求示例：

<xml>
	<SuiteId><![CDATA[wwSuiteId]]></SuiteId>
    <AuthCorpId><![CDATA[wxAuthCorpId]]></AuthCorpId>
    <InfoType><![CDATA[change_school_contact]]></InfoType>
    <TimeStamp>1403610513</TimeStamp>
    <ChangeType><![CDATA[update_parent]]></ChangeType>
    <Id><![CDATA[zhangsan]]></Id>
	<NewId><![CDATA[zhangsan2]]></NewId>
</xml>

参数说明：

参数	说明
SuiteId	第三方应用ID
AuthCorpId	授权企业的CorpID
InfoType	固定为change_school_contact
TimeStamp	时间戳
ChangeType	此时固定为update_parent
Id	更新家长的家校通讯录userid
NewId	新的家长userid，只在userid被修改时回调

删除家长事件

当学校在家校通讯录中删除家长时，回调此事件至第三方应用/套件的指令回调URL。

请求示例：

<xml>
	<SuiteId><![CDATA[wwSuiteId]]></SuiteId>
    <AuthCorpId><![CDATA[wxAuthCorpId]]></AuthCorpId>
    <InfoType><![CDATA[change_school_contact]]></InfoType>
    <TimeStamp>1403610513</TimeStamp>
	<ChangeType><![CDATA[delete_parent]]></ChangeType>
	<Id><![CDATA[zhangsan]]></Id>
</xml>

参数说明：

参数	说明
SuiteId	第三方应用ID
AuthCorpId	授权企业的CorpID
InfoType	固定为change_school_contact
TimeStamp	时间戳
ChangeType	此时固定为delete_parent
Id	删除家长的家校通讯录userid

家长关注事件

当家长关注家校通知时，回调此事件至第三方应用/套件的指令回调URL。

请求示例：

<xml>
    <SuiteId><![CDATA[wwSuitieId]]></SuiteId>
    <AuthCorpId><![CDATA[wxAuthCorpId]]></AuthCorpId>
    <InfoType><![CDATA[change_school_contact]]></InfoType>
    <TimeStamp>1403610513</TimeStamp>
    <ChangeType><![CDATA[subscribe]]></ChangeType>
    <Id><![CDATA[zhangsan]]></Id>
</xml>

参数说明：

参数	说明
SuiteId	第三方应用ID
AuthCorpId	授权企业的CorpID
InfoType	固定为change_school_contact
TimeStamp	时间戳
ChangeType	此处固定为subscribe
Id	家长的userid

家长取消关注事件

当家长取消关注家校通知时，回调此事件至第三方应用/套件的指令回调URL。

请求示例：

<xml>
    <SuiteId><![CDATA[wwSuitieId]]></SuiteId>
    <AuthCorpId><![CDATA[wxAuthCorpId]]></AuthCorpId>
    <InfoType><![CDATA[change_school_contact]]></InfoType>
    <TimeStamp>1403610513</TimeStamp>
    <ChangeType><![CDATA[unsubscribe]]></ChangeType>
    <Id><![CDATA[zhangsan]]></Id>
</xml>

参数说明：

参数	说明
SuiteId	第三方应用ID
AuthCorpId	授权企业的CorpID
InfoType	固定为change_school_contact
TimeStamp	时间戳
ChangeType	此处固定为unsubscribe
Id	家长的userid