苏飞论坛

标题: Asp.net【企业微信开发】成员通知事件(一)新增成员 [打印本页]

作者: 范范    时间: 2021-8-20 16:06
标题: Asp.net【企业微信开发】成员通知事件(一)新增成员
企业微信成员通知事件中有三个接口
一、 新增成员事件
二、 更新成员事件
三、 删除成员事件
本次我们主要说下 新增成员同通知事件 的用法




请求方式: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[zhangsan@xxx.com]]></Email>
    <Avatar><![CDATA[http://wx.qlogo.cn/mmopen/ajNVdq ... vDwklOpZeXYQQ2icg/0]]></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[https://work.weixin.qq.com]]></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




说明: 对用户具有通讯录基本信息只读权限的应用只返回基本字段。由通讯录应用发起的新增成员触发的事件不回调给通讯录应用。












欢迎光临 苏飞论坛 (http://www.sufeinet.com/) Powered by Discuz! X3.4