企业微信服务商代开发应用（多租户）

# 企业微信服务商代开发应用（多租户）

## 概述

代开发应用模版，是服务商向企业提供一类自建应用代开发的载体，与授权二维码（客户企业通过扫码，授权服务商进行企业自建应用代开发）一一对应。

* 一个代开发应用模版，可以被多个企业扫码授权。

* 每个模版仅可以被同一个企业授权安装一个代开发应用。

### 开发流程

![](/media/202507//1751968271.0632432.png)

## 一、服务商创建代开发模板

### 1\.1、创建代开发模版

扫码登录服务商管理后台 [hhttps://open.work.weixin.qq.com/wwopen/login](https://open.work.weixin.qq.com/wwopen/login)，服务商管理员进入服务商后台—\>应用管理—\>应用代开发 ，如下图所示：

![](/media/202507//1751968271.0698621.png)

点击“创建代开发应用模版”，进行代开发应用模版基础信息和开发信息配置。

#### 配置代开发模版信息填写标准

| 填写项 | 填写标准 |
| --- | --- |
| 代开发应用模版logo | 必须为正方形，像素为750﹡750，1M以内的jpg、png图片，不可使用企业微信logo或进行二次修改 |
| 代开发应用模版名称 | 2\-10个字，建议包含品牌名，不可使用特殊字符及特殊词汇 （如：“微信”、“特卖”、“企业微信”、“企微”、“抽奖”、“免费”等） |
| 代开发应用模版介绍 | 4\-20个字，简单清晰描述应用功能和使用场景 |
| 分类 | 根据应用的功能及场景进行选择 |
| 目标行业 | 根据应用目标用户的行业进行选择 |
| 代开发模版回调URL | 填写带http(s):// 头的有效URL链接，填写URL时需要正确响应企业微信验证URL的请求，具体配置方法参见[回调配置](https://developer.work.weixin.qq.com/document/path/97112#14961/3-%E5%9B%9E%E8%B0%83%E6%9C%8D%E5%8A%A1%E9%9C%80%E8%A6%81%E5%AE%9E%E7%8E%B0%E5%93%AA%E4%BA%9B%E5%8A%9F%E8%83%BD)。用于接收企业用户授权成功信息 |

#### 配置模板基础信息

![](/media/202507//1751968271.0750825.png)

#### 配置模板开发信息

点击“下一步，配置开发信息”，开始配置模板的开发信息，如下图：

![](/media/202507//1751968271.0783114.png)

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

![](/media/202507//1751968271.081296.png)

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

![](/media/202507//1751968271.0845804.png)

#### 灵卯云后台配置服务商信息

* 回调Token与回调Secret

代开发应用模板回调信息，将上图中生成的模板Token，EncodingAESKey分别填入回调Token和回调Secret。

![](/media/202507//1751968271.0878546.png)

* 服务商CorpId

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

![](/media/202507//1751968271.0916636.png)

* 服务商密钥

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

![](/media/202507//1751968271.0952265.png)

填写完（服务商CorpId、服务商密钥、回调Token、回调Secret）后保存企业微信服务商信息，如图所示：

![](/media/202507//1751968271.0987532.png)

#### 保存代开发应用模板

再次点击代开发应用模板“保存“按钮，代开发应用模板创建成功，如下图：

![](/media/202507//1751968271.1018865.png)

#### 填写代建应用模板信息

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

![](/media/202507//1751968271.1051273.png)

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

![](/media/202507//1751968271.1082306.png)

### 1\.2、代开发应用模板上线

代开发模版创建成功后，仅保存了模版信息。需要进入 服务商后台\-应用管理\-代开发应用上线 提交模版上线审核，审核通过后手动提交上线。模版正式上线后才会生成对应的授权二维码。

1）点击提交上线按钮，选择需要提交上线审核的代开发模版。

![](/media/202507//1751968271.1113605.png)

2）点击“确定”后，查看代开发应用上线页面，查看模板状态“待审核”：

![](/media/202507//1751968271.1149576.png)

3）审核通过后，审核状态将变为“待上线”，进入审核详情页，点击“提交上线”，进行代开发模版上线。

### 1\.3、获取待开发模板授权二维码

1） 模版上线提交成功后，回到 服务商后台\-应用管理\-代开发应用，进入代开发模版详情页，可查看对应的授权二维码。

![](/media/202507//1751968271.1186285.png)

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

![](/media/202507//1751968271.121944.png)

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

![](/media/202507//1751968271.125259.png)

![](/media/202507//1751968271.1282933.png)

## 二、客户企业授权企业自建应用代开发

### 2\.1、扫码代建

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

![](/media/202507//1751968271.131784.png)

企业客户管理员，将代开发模版对应的授权二维码，进行扫码授权，填写代开发自建应用信息，如下图所示。

* 应用名称：应用基本信息根据应用模板信息初始化，客户企业管理员需要修改应用名称，应用描述。

![](/media/202507//1751968271.1349125.png)

### 2\.2、填写授权企业ID

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

![](/media/202507//1751968271.138791.png)

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

![](/media/202507//1751968271.1420052.png)

* 授权企业ID

企业微信管理员可以进入企业微信管理后台，在企业信息页签处获取，如下图：

![](/media/202507//1751968271.145352.png)

### 2\.3、取消授权

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

![](/media/202507//1751968271.1486151.png)

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

![](/media/202507//1751968271.1520698.png)

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

![](/media/202507//1751968271.155311.png)

## 三、服务商应用代开发

### 3\.1、开始应用代开发

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

![](/media/202507//1751968271.1586828.png)

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

| 填写项 | 填写标准 |
| --- | --- |
| 代开发应用logo | 必须为正方形，像素为750﹡750，1M以内的jpg、png图片，不可使用企业微信logo或进行二次修改 |
| 代开发应用名称 | 2\-10个字，建议包含品牌名，不可使用特殊字符及特殊词汇 （如：“微信”、“特卖”、“企业微信”、“企微”、“抽奖”、“免费”等） |
| 代开发应用介绍 | 4\-120个字，简单清晰描述应用功能和使用场景 |
| **应用主页** | 用户从企业微信工作台进入应用时将直接跳转到对应的主页URL |
| **可信域名** | 填写不带http:// 或https:// 头，可信域名必须通过ICP备案验证，设置可信域名后支持应用的OAuth2授权、JSSDK调用等 |
| IP白名单 | 选填。只有白名单内的IP才能正常调用企业微信API，若后续IP有修改，需要及时进行列表更新 |
| **代开发应用回调URL** | 填写带http(s):// 头的有效URL链接，填写URL时需要正确响应企业微信验证URL的请求。用于接收托管企业微信应用的用户消息、进入应用事件等事件 |

![](/media/202507//1751968271.163184.png)

* 应用主页：http://租户code.一级域名/mobile

* 可信域名：二级域名(http://租户code.一级域名)

### 3\.2 、配置自定义权限

自建应用代开发，应用权限分为基础权限和自定义权限，代开发权限明细可查看：[代开发权限说明](https://open.work.weixin.qq.com/api/doc/33971) 。

* 基础权限：为企业扫码授权服务商进行自建应用代开发，应用即可获取基础权限。

* 自定义权限：则需要企业再次确认后，代开发应用才可以获取具体自定义权限。

1） 进入服务商后台，代开发应用详情页，权限设置模块，点击右上角“编辑”按钮，可进行代开发应用自定义权限编辑。

2） 进入编辑状态后，可选择代开发应用所需要的自定义权限进行勾选。

注意：成员基本信息、敏感信息必须设置

![](/media/202507//1751968271.1667995.png)

代开发应用自定义权限可多次编辑，每次编辑保存后将立即**向企业客户发送一条代开发应用权限变更推送消息**，

客户企业管理员需要查看详情，并同意授权。

![](/media/202507//1751968271.1707275.png)

3） 代开发应用详情页，权限设置模块，非编辑状态：
● 当前申请的代开发自定义权限待企业侧确认的，会在权限后面展示“待企业客户确认”提示；
● 当企业同意授权后，权限设置模块将更新为企业确认后的权限状态，且没有“待企业客服确认”提示；
● 当企业暂不授权后，权限设置模块将回退为申请之前的权限状态，即服务商申请的没有成功。

![](/media/202507//1751968271.1740208.png)

4）设置企业微信授权登录

进入 服务商后台\-应用管理\-应用代开发 ，点击代建模版详情页，点击页面最后一个设置项 “企业微信授权登录” 设置按钮，如下图所示：

![](/media/202507//1751968271.1771817.png)

![](/media/202507//1751968271.1800702.png)

### 3\.3、应用上线

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

![](/media/202507//1751968271.183073.png)

● 提交上线页，左侧先选择需要上线代开发应用所属代开发模版，然后在右侧选择这个模版下，需要提交上线审核的企业代开发应用。![](/media/202507//1751968271.1865785.png)

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

![](/media/202507//1751968271.1901453.png)

等待若干时间后，刷新代开发应用上线列表，审核中的应用状态由“审核中”变为“待上线”：

![](/media/202507//1751968271.1931798.png)

2\) 测试应用

提交上线后，代开发应用状态由“审核中”变为“待上线”，此时客户企业管理员可以设置代开发应用可见范围，见3\.4，验证管理员可以在移动端授权登录成功，正常登录PC端后才能提交上线。

点击待上线应用，点击“提交上线”按钮即可。

![](/media/202507//1751968271.1962402.png)

### 3\.4、接口调用许可

<https://open.work.weixin.qq.com/wwopen/common/readDocument/38829>规定，自2022年5月16日起，企业微信将面向服务商进行收费模式的调整，调整后将按照接口调用许可进行收费，同时取消现有的按照收款资金固定比例收取的“技术服务费”。

当服务商还没有为客户企业开通“接口调用许可”时，客户企业人员进入代建应用时将会提示如下“应用无法使用”提示。

![](/media/202507//1751968271.19938.png)

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

![](/media/202507//1751968271.2072923.png)

![](/media/202507//1751968271.2115893.png)

**定价规则**

企业微信接口按照许可帐号定价，1个许可帐号可用于服务商调用1个open\_userid下的企业微信接口；

许可帐号为服务商维度，服务商的所有应用可使用同一个许可帐号；

许可帐号分为两种类型，不同类型帐号单价不同，其中基础帐号可用于调用基础接口，互通帐号可用于调用基础接口和互通接口；

许可帐号按企业维度累进阶梯计费，不同帐号数区间的价格不同，其中对于购买帐号数在10001及以上的企业，服务商可点击页面中【客服】或联系企业微信渠道经理进行沟通。

![](/media/202507//1751968271.2157314.png)

1）测试企业接口调用许可

服务商可以配置10个测试企业，用以进行应用的安装测试，测试企业安装的当前服务商的所有应用在安装90天后会自动删除 [说明文档](https://open.work.weixin.qq.com/wwopen/common/readDocument/38729)

![](/media/202507//1751968271.218668.png)

2）开通接口调用许可

服务商登录企业微信服务商后台，在“购买接口许可”页面，点击“购买”按钮进入购买页，购买时需指定企业客户，服务商可根据接口调用情况选择购买的许可账号类型、个数、时长。

目前平台集成使用到的接口，仅包含基础接口，服务商和客户企业可以根据业务扩展选择合适的账号类型。

## 四、客户企业设置代开发应用可见范围

### 4\.1 设置代开发应用可见范围

代开发应用上线后，代开发模板扫码授权客户企业登录企业微信管理后台，查看自建应用列表，代开发应用变为可用状态，如图所示：

![](/media/202507//1751968271.2237005.png)

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

![](/media/202507//1751968271.226492.png)

### 4\.2 删除代开发应用应用

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

![](/media/202507//1751968271.2293096.png)

删除应用后，应用关联的平台租户PC端后台的企业微信配置信息，将会被重置清空。

![](/media/202507//1751968271.2318804.png)

## 五、客户企业人员工作台应用登录

客户企业设置代开发应用可见范围后，客户企业用户即可在企业微信端的工作台界面授权登录到应用。

### 5\.1、工作台用户登录

工作台用户登录，需要用户授权个人敏感信息，否则用户信息将无法同步到系统组织机构。

**勾选手机号、邮箱**

![](/media/202507//1751968271.2353067.png)