企业微信服务商代开发应用(多租户)
概述
代开发应用模版,是服务商向企业提供一类自建应用代开发的载体,与授权二维码(客户企业通过扫码,授权服务商进行企业自建应用代开发)一一对应。
一个代开发应用模版,可以被多个企业扫码授权。
每个模版仅可以被同一个企业授权安装一个代开发应用。
开发流程
一、服务商创建代开发模板
1.1、创建代开发模版
扫码登录服务商管理后台 hhttps://open.work.weixin.qq.com/wwopen/login ,服务商管理员进入服务商后台—>应用管理—>应用代开发 ,如下图所示:

点击"创建代开发应用模版",进行代开发应用模版基础信息和开发信息配置。
配置代开发模版信息填写标准

配置模板基础信息

配置模板开发信息
点击"下一步,配置开发信息",开始配置模板的开发信息,如下图:

获取代开发模板回调URL,服务商管理员可以登录"灵卯云租户管理后台"—>系统管理—>企业微信服务商,复制代开发应用回调URL即可。

继续创建代开发应用模板,将复制的回调URL写入"代开发模板回调URL"。分别点击"随机获取"Token和EncodingAESKey之后,保存开发信息,此时系统提示"验证CallbackUrl失败" (待配置完灵卯云租户管理后台信息后,再重新保存)。

灵卯云后台配置服务商信息
回调Token与回调Secret
代开发应用模板回调信息,将上图中生成的模板Token,EncodingAESKey分别填入回调Token和回调Secret。

服务商CorpId
在浏览器中重新打开一个页签,查看服务商信息如下图所示。并将服务商CorpID,粘贴到上图(瞬翕云租户管理后台信息)中的服务商CorpId。

服务商密钥
填写服务商密钥,可在服务商后台获取,企业微信服务商管理员登录后台—>应用管理—>通用开发参数,将ProviderSecret复制到服务商密钥。

填写完(服务商CorpId、服务商密钥、回调Token、回调Secret)后保存企业微信服务商信息,如图所示:

保存代开发应用模板
再次点击代开发应用模板"保存"按钮,代开发应用模板创建成功,如下图:

填写代建应用模板信息
将代建应用模板Id,代建应用密钥填写到租户管理端—企业微信服务商信息。

如上图所示,点击查看模板信息,粘贴模板ID到代建应用Id、粘贴模板Secret到代建应用密钥,如下图:

1.2、代开发应用模板上线
代开发模版创建成功后,仅保存了模版信息。需要进入 服务商后台-应用管理-代开发应用上线 提交模版上线审核,审核通过后手动提交上线。模版正式上线后才会生成对应的授权二维码。
1)点击提交上线按钮,选择需要提交上线审核的代开发模版。

2)点击"确定"后,查看代开发应用上线页面,查看模板状态"待审核":

3)审核通过后,审核状态将变为"待上线",进入审核详情页,点击"提交上线",进行代开发模版上线。
1.3、获取待开发模板授权二维码
1) 模版上线提交成功后,回到 服务商后台-应用管理-代开发应用,进入代开发模版详情页,可查看对应的授权二维码。

2) 若需要将多个代开发应用模版组合成一个授权二维码,让企业进行批量授权,可在代开发应用首页,点击右上角"批量授权"按钮,选择2-9个已上线的代开发应用模版,生成批量授权二维码。批量授权二维码有效期为10天,超过10天需要重新生成。

3)查看代开发模板详情,将模板ID和模板Secrect添加到租户关联—服务商信息,如下图所示:


二、客户企业授权企业自建应用代开发
2.1、扫码代建
平台租户管理员登录PC端管理后台,依次打开系统管理—>系统参数—>第三方集成—>企业微信,客户企业管理员扫码授权服务商代建应用,如下图所示:

企业客户管理员,将代开发模版对应的授权二维码,进行扫码授权,填写代开发自建应用信息,如下图所示。
应用名称:应用基本信息根据应用模板信息初始化,客户企业管理员需要修改应用名称,应用描述。

2.2、填写授权企业ID
平台租户管理员登录PC端管理后台,依次打开系统管理—>系统参数—>第三方集成—>企业微信,输入授权企业ID。

填写完授权企业ID后,点击"保存"按钮,系统会将上一步创建的代建应用系统信息自动绑定到页面。

授权企业ID
企业微信管理员可以进入企业微信管理后台,在企业信息页签处获取,如下图:

2.3、取消授权
企业扫描服务商代开发二维码,授权成功后,企业侧自动创建由该服务商代开发的自建应用,初始状态为开发中,不可正常使用。

客户企业管理员扫码后,进入企业微信管理后台,自建应用列表点击应用,开发中(未上线)之前的代自建应用可以取消授权。

取消授权后,平台租户管理员登录PC端管理后台,依次进入系统管理—>系统参数—>第三方集成—>企业微信,界面配置信息将会重置清空,如下图所示:

三、服务商应用代开发
3.1、开始应用代开发
1) 进入 服务商后台-应用管理-应用代开发 ,点击代建模版详情页,可以查看该代开发模版对应的企业授权列表。

2) 点击"开始代开发应用"为该企业代开发应用配置基础信息和开发信息。其中代开发应用logo、名称、介绍,回调URL信息,会默认填写代开发模版的信息,可以进行修改,提升填写效率。


应用主页:http://租户code.一级域名/mobile
可信域名:二级域名(http://租户code.一级域名)
3.2、配置自定义权限
自建应用代开发,应用权限分为基础权限和自定义权限
基础权限:为企业扫码授权服务商进行自建应用代开发,应用即可获取基础权限。
自定义权限:则需要企业再次确认后,代开发应用才可以获取具体自定义权限。
1) 进入服务商后台,代开发应用详情页,权限设置模块,点击右上角"编辑"按钮,可进行代开发应用自定义权限编辑。
2) 进入编辑状态后,可选择代开发应用所需要的自定义权限进行勾选。
注意:成员基本信息、敏感信息必须设置

代开发应用自定义权限可多次编辑,每次编辑保存后将立即向企业客户发送一条代开发应用权限变更推送消息 ,
客户企业管理员需要查看详情,并同意授权。

3) 代开发应用详情页,权限设置模块,非编辑状态:
● 当前申请的代开发自定义权限待企业侧确认的,会在权限后面展示"待企业客户确认"提示;
● 当企业同意授权后,权限设置模块将更新为企业确认后的权限状态,且没有"待企业客服确认"提示;
● 当企业暂不授权后,权限设置模块将回退为申请之前的权限状态,即服务商申请的没有成功。
4)设置企业微信授权登录
进入 服务商后台-应用管理-应用代开发 ,点击代建模版详情页,点击页面最后一个设置项 "企业微信授权登录" 设置按钮,如下图所示:


3.3、应用上线
1) 自行测试完毕后,进入服务商后台-应用管理-代开发应用上线,点击"提交上线"按钮,选择需要上线的代开发模版,和对应的企业代开发应用,提交上线审核。

● 提交上线页,左侧先选择需要上线代开发应用所属代开发模版,然后在右侧选择这个模版下,需要提交上线审核的企业代开发应用。

勾选后确定提交。则该企业代开发应用进入上线审核流程。

等待若干时间后,刷新代开发应用上线列表,审核中的应用状态由"审核中"变为"待上线":

2)测试应用
提交上线后,代开发应用状态由"审核中"变为"待上线",此时客户企业管理员可以设置代开发应用可见范围,见3.4,验证管理员可以在移动端授权登录成功,正常登录PC端后才能提交上线。
点击待上线应用,点击"提交上线"按钮即可。

3.4、接口调用许可
https://open.work.weixin.qq.com/wwopen/common/readDocument/38829 规定,自2022年5月16日起,企业微信将面向服务商进行收费模式的调整,调整后将按照接口调用许可进行收费,同时取消现有的按照收款资金固定比例收取的"技术服务费"。
当服务商还没有为客户企业开通"接口调用许可"时,客户企业人员进入代建应用时将会提示如下"应用无法使用"提示。

企业微信向服务商开放的接口包括基础接口和互通接口,服务商可在应用内(第三方应用或代开发自建应用)进行调用,以满足企业在各种场景下的使用需求。


定价规则
企业微信接口按照许可帐号定价,1个许可帐号可用于服务商调用1个open_userid下的企业微信接口;
许可帐号为服务商维度,服务商的所有应用可使用同一个许可帐号;
许可帐号分为两种类型,不同类型帐号单价不同,其中基础帐号可用于调用基础接口,互通帐号可用于调用基础接口和互通接口;
许可帐号按企业维度累进阶梯计费,不同帐号数区间的价格不同,其中对于购买帐号数在10001及以上的企业,服务商可点击页面中【客服】或联系企业微信渠道经理进行沟通。

1)测试企业接口调用许可
服务商可以配置10个测试企业,用以进行应用的安装测试,测试企业安装的当前服务商的所有应用在安装90天后会自动删除说明文档

2)开通接口调用许可
服务商登录企业微信服务商后台,在"购买接口许可"页面,点击"购买"按钮进入购买页,购买时需指定企业客户,服务商可根据接口调用情况选择购买的许可账号类型、个数、时长。
目前平台集成使用到的接口,仅包含基础接口,服务商和客户企业可以根据业务扩展选择合适的账号类型。
四、客户企业设置代开发应用可见范围
4.1 设置代开发应用可见范围
代开发应用上线后,代开发模板扫码授权客户企业登录企业微信管理后台,查看自建应用列表,代开发应用变为可用状态,如图所示:

点击如上图所示的代开发应用,管理员需要设置应用的可见范围,如图所示:

4.2 删除代开发应用应用
代开发应用上线后,企业微信管理员登录管理后台,在自建应用列表中点击将要删除的代建应用,页面会跳转到应用的详细信息界面,点击删除删除按钮即可,如下图所示:

删除应用后,应用关联的平台租户PC端后台的企业微信配置信息,将会被重置清空。
五、客户企业人员工作台应用登录
客户企业设置代开发应用可见范围后,客户企业用户即可在企业微信端的工作台界面授权登录到应用。
5.1 工作台用户登录
工作台用户登录,需要用户授权个人敏感信息,否则用户信息将无法同步到系统组织机构。
勾选手机号、邮箱
