登录
基础
连接微信
办公
企业内部开发 服务端API 通讯录管理 通讯录回调通知 部门变更通知
部门变更通知
最后更新：2022/08/04
目录
新增部门事件
该事件会回调给通讯录同步助手，代开发自建应用以及上游企业共享的应用。
【重要】对于2022年8月15号后通讯录助手新配置或修改的回调url，部门属性只回调Id/ParentId两个字段
xml请求示例：
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[sys]]></FromUserName>
<CreateTime>1403610513</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[change_contact]]></Event>
<ChangeType>create_party</ChangeType>
<Id>2</Id>
<Name><![CDATA[张三]]></Name>
<ParentId><![CDATA[1]]></ParentId>
<Order>1</Order>
</xml>
参数说明：
| 参数 | 说明 |
|---|---|
| ToUserName | 企业微信CorpID |
| FromUserName | 此事件该值固定为sys，表示该消息由系统生成 |
| CreateTime | 消息创建时间 （整型） |
| MsgType | 消息的类型，此时固定为event |
| Event | 事件的类型，此时固定为change_contact |
| ChangeType | 此时固定为create_party |
| Id | 部门Id |
| Name | 部门名称;代开发自建应用需要管理员授权才返回 |
| ParentId | 父部门id |
| Order | 部门排序 |
说明： 由通讯录同步助手通过api发起的新增部门触发的事件不回调给通讯录同步助手应用。
更新部门事件
该事件会回调给通讯录同步助手，代开发自建应用以及上游企业共享的应用
【重要】对于2022年8月15号后通讯录助手新配置或修改的回调url，该事件只会在ParentId变更时触发，并且部门属性只回调Id/ParentId两个字段
xml请求示例：
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[sys]]></FromUserName>
<CreateTime>1403610513</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[change_contact]]></Event>
<ChangeType>update_party</ChangeType>
<Id>2</Id>
<Name><![CDATA[张三]]></Name>
<ParentId><![CDATA[1]]></ParentId>
</xml>参数说明：
| 参数 | 说明 |
|---|---|
| ToUserName | 企业微信CorpID |
| FromUserName | 此事件该值固定为sys，表示该消息由系统生成 |
| CreateTime | 消息创建时间 （整型） |
| MsgType | 消息的类型，此时固定为event |
| Event | 事件的类型，此时固定为change_contact |
| ChangeType | 此时固定为update_party |
| Id | 部门Id |
| Name | 部门名称，仅当该字段发生变更时传递;代开发自建应用需要管理员授权才返回 |
| ParentId | 父部门id，仅当该字段发生变更时传递 |
说明： 由通讯录同步助手通过api发起的更新部门触发的事件不回调给通讯录同步助手应用。
删除部门事件
该事件会回调给通讯录同步助手，代开发自建应用以及上游企业共享的应用。
xml请求示例：
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[sys]]></FromUserName>
<CreateTime>1403610513</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[change_contact]]></Event>
<ChangeType>delete_party</ChangeType>
<Id>2</Id>
</xml>参数说明：
| 参数 | 说明 |
|---|---|
| ToUserName | 企业微信CorpID |
| FromUserName | 此事件该值固定为sys，表示该消息由系统生成 |
| CreateTime | 消息创建时间 （整型） |
| MsgType | 消息的类型，此时固定为event |
| Event | 事件的类型，此时固定为change_contact |
| ChangeType | 此时固定为delete_party |
| Id | 部门Id |
说明： 由通讯录同步助手通过api发起的删除部门触发的事件不回调给通讯录同步助手应用。
