|
企业微信成员通知事件中有三个接口
一、 新增成员事件
二、 更新成员事件
三、 删除成员事件
本次我们主要说下 新增成员同通知事件 的用法
请求方式:POST(HTTPS)
请求地址: https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
xml请求示例:
[XML] 纯文本查看 复制代码
<xml>
<SuiteId><![CDATA[ww4asffe99e54c0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3axxxxxx]]></AuthCorpId>
<InfoType><![CDATA[change_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[create_user]]></ChangeType>
<UserID><![CDATA[zhangsan]]></UserID>
<OpenUserID><![CDATA[woxxx]]></OpenUserID>
<Name><![CDATA[张三]]></Name>
<Department><![CDATA[1,2,3]]></Department>
<MainDepartment>1</MainDepartment>
<IsLeaderInDept><![CDATA[1,0,0]]></IsLeaderInDept>
<Mobile><![CDATA[11111111111]]></Mobile>
<Position><![CDATA[产品经理]]></Position>
<Gender>1</Gender>
<Email><![CDATA[[url=mailto:zhangsan@xxx.com]zhangsan@xxx.com[/url]]]></Email>
<Avatar><![CDATA[[url=http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0]http://wx.qlogo.cn/mmopen/ajNVdq ... vDwklOpZeXYQQ2icg/0[/url]]]></Avatar>
<Alias><![CDATA[zhangsan]]></Alias>
<Telephone><![CDATA[020-111111]]></Telephone>
<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[[url=https://work.weixin.qq.com]https://work.weixin.qq.com[/url]]]></Url>
</Web>
</Item>
</ExtAttr>
</xml>
参数说明:
[XML] 纯文本查看 复制代码
参数 说明
1. SuiteId 第三方应用ID
2. AuthCorpId 授权企业的CorpID
3. InfoType 固定为change_contact
4. TimeStamp 时间戳
5. ChangeType 固定为create_user
6. UserID 成员UserID
7. OpenUserID 全局唯一。对于同一个服务商,不同应用获取到企业内同一个成员的OpenUserID是相同的,最多64个字节。
8. Name 成员名称,此字段从2019年12月30日起,对新创建第三方应用不再返回真实name,使用userid代替name,2020年6月30日起,对所有历史第三方应用不再返回真实name,使用userid代替name,后续第三方仅通讯录应用可获取,第三方页面需要通过通讯录展示组件来展示名字
9. Department 更新后成员所在部门列表,仅返回该应用有查看权限的部门id;成员授权模式下,仅返回根部门,即1
10. MainDepartment 主部门,成员授权模式下,仅返回根部门,即1
11. IsLeaderInDept 表示所在部门是否为上级,0-否,1-是,顺序与Department字段的部门逐一对应
12. Mobile 手机号码,仅通讯录管理应用可获取
13. Position 职位信息。长度为0~64个字节,仅通讯录应用可获取
14. Gender 性别。1表示男性,2表示女性
15. Email 邮箱,仅通讯录管理应用可获取
16. Status 激活状态: 1=已激活,2=已禁用,4=未激活,5=退出企业。已激活代表已激活企业微信或已关注微工作台(原企业号)。未激活代表既未激活企业微信又未关注微工作台(原企业号)。
17. Avatar 头像url。注:如果要获取小图将url最后的”/0”改成”/100”即可,仅通讯录管理应用可获取
18. Alias 成员别名
19. Telephone 座机,仅通讯录管理应用可获取
20. ExtAttr 扩展属性,仅通讯录管理应用可获取
21. Type 扩展属性类型: 0-文本 1-网页
22. Text 文本属性类型,扩展属性类型为0时填写
23. Value 文本属性内容
24. Web 网页类型属性,扩展属性类型为1时填写
25. Title 网页的展示标题
26. Url 网页的url
说明: 对用户具有通讯录基本信息只读权限的应用只返回基本字段。由通讯录应用发起的新增成员触发的事件不回调给通讯录应用。
|
|