目录
「上下游」是企业微信针对企业间协作场景推出的解决方案。
企业可使用此功能,与自己的经销商、供应商、合作伙伴便捷沟通、共享应用,实现高效业务协同。
注意:
* 客户端需升级到 3.1.20 以上版本
* 行业为「教育-学前教育、初中等教育、教育行政单位」的企业成员,以及团队形态的成员暂不支持创建和加入上下游
上游企业将应用分享给下游企业后,需要使用特定的接口获取下游应用的身份和权限才能控制下游应用,因此需要做一定的适配。
对于自建应用,当上游企业将自建应用分享给下游企业后,企业微信会回调应用共享事件给上游企业,上游企业收到回调事件后,可以通过相应的API接口进行业务开发。需要特别注意的是企业微信帐号ID安全性已全面升级,上游企业获取到下游企业的账号ID规则与第三方服务商获取到的账号ID规则是一样的,详情可以参考企业微信帐号ID安全性全面升级。
对于第三方应用,当上游企业将第三方应用分享给下游企业后,企业微信会为每个下游企业分别安装授权该第三方应用,并回调授权通知给第三方,所以相当于是多了一种授权安装的渠道,不同的是,该情况下企业微信还会回调共享应用事件给第三方应用,之后第三方应用可获取应用共享信息,以及获取下游企业付费版本信息。
下面简要说明需要注意的地方。
上游企业的管理员在管理端/手机端分享应用给下游企业后,会收到共享应用事件回调,此时上游企业需要通过接口获取应用共享信息获取分享后的下游企业的corpid和应用id列表并保存起来,后面调接口的时候需要用到。
因为应用可以分享给多个下游企业,所以上游企业调用接口前,需要得知当前使用者到底属于哪个企业。
见身份验证相关接口。与普通应用使用方法的不同点在于:
appid
填上游企业的corpid (第三方应用无变化,参见构造第三方应用oauth2链接)appId
和agentId
参数,需要填下游企业的corpid和应用id。对于上下游的应用,因为应用统一由上游企业管理,所以相关事件和消息均回调给上游企业。需注意以下几点:
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[UserID]]></FromUserName>
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[subscribe]]></Event>
<AgentID>1</AgentID>
ToUserName
是下游企业corpid,FromUserName
是下游企业的密文userid