企业内部开发 服务端API 通讯录管理 通讯录回调通知 成员变更通知
成员变更通知

目录

  • 新增成员事件
  • 更新成员事件
  • 删除成员事件
  • 新增成员事件

    该事件会回调给通讯录同步助手,代开发自建应用以及上游企业共享的应用

    请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_contact]]></Event>
    	<ChangeType>create_user</ChangeType>
    	<UserID><![CDATA[zhangsan]]></UserID>
    	<Name><![CDATA[张三]]></Name>
    	<Department><![CDATA[1,2,3]]></Department>
    	<MainDepartment>1</MainDepartment>
    	<IsLeaderInDept><![CDATA[1,0,0]]></IsLeaderInDept>
    	<DirectLeader><![CDATA[lisi,wangwu]]></DirectLeader>
    	<Position><![CDATA[产品经理]]></Position>
    	<Mobile>13800000000</Mobile>
    	<Gender>1</Gender>
    	<Email><![CDATA[zhangsan@gzdev.com]]></Email>
    	<BizMail><![CDATA[zhangsan@qyycs2.wecom.work]]></BizMail>
    	<Status>1</Status>
    	<Avatar><![CDATA[http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0]]></Avatar>
    	<Alias><![CDATA[zhangsan]]></Alias>
    	<Telephone><![CDATA[020-123456]]></Telephone>
    	<Address><![CDATA[广州市]]></Address>
    	<ExtAttr>
    		<Item>
    		<Name><![CDATA[爱好]]></Name>
    		<Type>0</Type>
    		<Text>
    			<Value><![CDATA[旅游]]></Value>
    		</Text>
    		</Item>
    		<Item>
    		<Name><![CDATA[卡号]]></Name>
    		<Type>1</Type>
    		<Web>
    			<Title><![CDATA[企业微信]]></Title>
    			<Url><![CDATA[https://work.weixin.qq.com]]></Url>
    		</Web>
    		</Item>
    	</ExtAttr>
    </xml>

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_contact
    ChangeType此时固定为create_user
    UserID成员UserID
    Name成员名称;代开发自建应用需要管理员授权才返回
    Department成员部门列表,仅返回该应用有查看权限的部门id
    MainDepartment主部门
    IsLeaderInDept表示所在部门是否为部门负责人,0-否,1-是,顺序与Department字段的部门逐一对应。上游共享的应用不返回该字段
    DirectLeader直属上级UserID,最多5个。代开发的自建应用和上游共享的应用不返回该字段
    Mobile手机号码;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    Position职位信息。长度为0~64个字节;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    Gender性别,1表示男性,2表示女性。上游共享的应用不返回该字段
    Email邮箱;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    BizMail企业邮箱;代开发自建应用不返回该字段。上游共享的应用不返回该字段
    Status激活状态:1=已激活 2=已禁用 4=未激活 已激活代表已激活企业微信或已关注微信插件(原企业号)5=成员退出
    Avatar头像url。注:如果要获取小图将url最后的”/0”改成”/100”即可。上游共享的应用不返回该字段
    Alias成员别名。上游共享的应用不返回该字段
    Telephone座机;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    Address地址;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    ExtAttr扩展属性;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    Type扩展属性类型: 0-本文 1-网页
    Text文本属性类型,扩展属性类型为0时填写
    Value文本属性内容
    Web网页类型属性,扩展属性类型为1时填写
    Title网页的展示标题
    Url网页的url

    说明: 由通讯录同步助手通过api发起的新增成员触发的事件不回调给通讯录同步助手应用。

    更新成员事件

    该事件会回调给通讯录同步助手,代开发自建应用以及上游企业共享的应用

    请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_contact]]></Event>
    	<ChangeType>update_user</ChangeType>
    	<UserID><![CDATA[zhangsan]]></UserID>
    	<NewUserID><![CDATA[zhangsan001]]></NewUserID>
    	<Name><![CDATA[张三]]></Name>
    	<Department><![CDATA[1,2,3]]></Department>
    	<MainDepartment>1</MainDepartment>
    	<IsLeaderInDept><![CDATA[1,0,0]]></IsLeaderInDept>
    	<Position><![CDATA[产品经理]]></Position>
    	<Mobile>13800000000</Mobile>
    	<Gender>1</Gender>
    	<Email><![CDATA[zhangsan@gzdev.com]]></Email>
    	<Status>1</Status>
    	<Avatar><![CDATA[http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0]]></Avatar>
    	<Alias><![CDATA[zhangsan]]></Alias>
    	<Telephone><![CDATA[020-123456]]></Telephone>
    	<Address><![CDATA[广州市]]></Address>
    	<ExtAttr>
    		<Item>
    		<Name><![CDATA[爱好]]></Name>
    		<Type>0</Type>
    		<Text>
    			<Value><![CDATA[旅游]]></Value>
    		</Text>
    		</Item>
    		<Item>
    		<Name><![CDATA[卡号]]></Name>
    		<Type>1</Type>
    		<Web>
    			<Title><![CDATA[企业微信]]></Title>
    			<Url><![CDATA[https://work.weixin.qq.com]]></Url>
    		</Web>
    		</Item>
    	</ExtAttr>
    </xml>

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_contact
    ChangeType此时固定为update_user
    UserID变更信息的成员UserID
    NewUserID新的UserID,变更时推送(userid由系统生成时可更改一次)
    Name成员名称,变更时推送;代开发自建应用需要管理员授权才返回
    Department成员部门列表,变更时推送,仅返回该应用有查看权限的部门id
    MainDepartment主部门
    IsLeaderInDept表示所在部门是否为部门负责人,0-否,1-是,顺序与Department字段的部门逐一对应。上游共享的应用不返回该字段
    DirectLeader直属上级UserID,最多5个。代开发的自建应用和上游共享的应用不返回该字段
    Mobile手机号码,变更时推送;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    Position职位信息。长度为0~64个字节,变更时推送;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    Gender性别,变更时推送。1表示男性,2表示女性。上游共享的应用不返回该字段
    Email邮箱,变更时推送;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    BizMail企业邮箱,变更时推送;代开发自建应用不返回该字段。上游共享的应用不返回该字段
    Status激活状态:1=激活或关注, 2=禁用, 4=未激活(重新启用未激活用户或者退出企业并且取消关注时触发),5=成员退出
    Avatar头像url。注:如果要获取小图将url最后的”/0”改成”/100”即可。变更时推送。上游共享的应用不返回该字段
    Alias成员别名,变更时推送。上游共享的应用不返回该字段
    Telephone座机,变更时推送;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    Address地址;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    ExtAttr扩展属性,变更时推送;代开发自建应用需要管理员授权才返回。上游共享的应用不返回该字段
    Type扩展属性类型: 0-本文 1-网页
    Text文本属性类型,扩展属性类型为0时填写
    Value文本属性内容
    Web网页类型属性,扩展属性类型为1时填写
    Title网页的展示标题
    Url网页的url


    说明: 由通讯录同步助手通过api发起的更新成员触发的事件不回调给通讯录同步助手应用。

    删除成员事件

    该事件会回调给通讯录同步助手,代开发自建应用以及上游企业共享的应用。

    请求示例:

    <xml>
    	<ToUserName><![CDATA[toUser]]></ToUserName>
    	<FromUserName><![CDATA[sys]]></FromUserName> 
    	<CreateTime>1403610513</CreateTime>
    	<MsgType><![CDATA[event]]></MsgType>
    	<Event><![CDATA[change_contact]]></Event>
    	<ChangeType>delete_user</ChangeType>
    	<UserID><![CDATA[zhangsan]]></UserID>
    </xml>

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName此事件该值固定为sys,表示该消息由系统生成
    CreateTime消息创建时间 (整型)
    MsgType消息的类型,此时固定为event
    Event事件的类型,此时固定为change_contact
    ChangeType此时固定为delete_user
    UserID变更信息的成员UserID


    说明: 由通讯录同步助手通过api发起的删除成员触发的事件不回调给通讯录同步助手应用。

    上一篇
    概述
    下一篇
    部门变更通知