# 接入流程

### **步骤 1: 开启应用能力并免费试用**

创建集成应用/企业自建应用后，开启“在线预览编辑”能力，即享免费试用额度。

![](https://cloud-pic.wpsgo.com/L1R0Q0xaMlJFRmx2aTE1TVoyalEvcGE0MzRIMU1saEliemIwNVFNQThrMGsxaGhrRTg4ek1xcml3R1hMWlNIZ2lxbU5ETlFsSmgyTU81Vy9EdGNha3h2UHI4REVYVVNxSHVHTDVvZGdMT01qd2hsZlRha1Ywc2QvSjJxZWgxZnNydzJ0M3pnRy9yRVowOGk2NTF4eS9qTHZsNm9PWjdRNzJDc242VU5JbVpjU0NZN24zMk9DRG9lL0R3RnZEeXQwVkl6ZVRqdURHcGJqdEFuRTcvNzRDQ2paU2s5aHZ2MHBCUHFQdm1Lbis5c3JnQngrUzUzOWJPUVJ1TFM3ait6UlY1bFFOOEIxVnlSby9ZTUFoL0NpUFE9PQ==/attach/object/Y2YCF5BGABQHK?)

具体额度上限如下：

![](https://cloud-pic.wpsgo.com/L1R0Q0xaMlJFRmx2aTE1TVoyalEvcGE0MzRIMU1saEliemIwNVFNQThrMGsxaGhrRTg4ek1xcml3R1hMWlNIZ2lxbU5ETlFsSmgyTU81Vy9EdGNha3h2UHI4REVYVVNxSHVHTDVvZGdMT01qd2hsZlRha1Ywc2QvSjJxZWgxZnNydzJ0M3pnRy9yRVowOGk2NTF4eS9qTHZsNm9PWjdRNzJDc242VU5JbVpjU0NZN24zMk9DRG9lL0R3RnZEeXQwVkl6ZVRqdURHcGJqdEFuRTcvNzRDQ2paU2s5aHZ2MHBCUHFQdm1Lbis5c3JnQngrUzUzOWJPUVJ1TFM3ait6UlY1bFFOOEIxVnlSby9ZTUFoL0NpUFE9PQ==/attach/object/HAYCR7JGACQFA?)

支持能力配置：

![](https://cloud-pic.wpsgo.com/L1R0Q0xaMlJFRmx2aTE1TVoyalEvcGE0MzRIMU1saEliemIwNVFNQThrMGsxaGhrRTg4ek1xcml3R1hMWlNIZ2lxbU5ETlFsSmgyTU81Vy9EdGNha3h2UHI4REVYVVNxSHVHTDVvZGdMT01qd2hsZlRha1Ywc2QvSjJxZWgxZnNydzJ0M3pnRy9yRVowOGk2NTF4eS9qTHZsNm9PWjdRNzJDc242VU5JbVpjU0NZN24zMk9DRG9lL0R3RnZEeXQwVkl6ZVRqdURHcGJqdEFuRTcvNzRDQ2paU2s5aHZ2MHBCUHFQdm1Lbis5c3JnQngrUzUzOWJPUVJ1TFM3ait6UlY1bFFOOEIxVnlSby9ZTUFoL0NpUFE9PQ==/attach/object/EHGSJ5BGACQEW?)

在应用信息 tab 下查看应用的 <span style="font-size: 16px;">`AppID `</span>和 <span style="font-size: 16px;">`AppSecret `</span>。

![](https://cloud-pic.wpsgo.com/L1R0Q0xaMlJFRmx2aTE1TVoyalEvcGE0MzRIMU1saEliemIwNVFNQThrMGsxaGhrRTg4ek1xcml3R1hMWlNIZ2lxbU5ETlFsSmgyTU81Vy9EdGNha3h2UHI4REVYVVNxSHVHTDVvZGdMT01qd2hsZlRha1Ywc2QvSjJxZWgxZnNydzJ0M3pnRy9yRVowOGk2NTF4eS9qTHZsNm9PWjdRNzJDc242VU5JbVpjU0NZN24zMk9DRG9lL0R3RnZEeXQwVkl6ZVRqdURHcGJqdEFuRTcvNzRDQ2paU2s5aHZ2MHBCUHFQdm1Lbis5c3JnQngrUzUzOWJPUVJ1TFM3ait6UlY1bFFOOEIxVnlSby9ZTUFoL0NpUFE9PQ==/attach/object/ZCNDD7JGABQCU?)

### 步骤 2: 服务端实现回调服务

回调服务的实现是接入 WebOffice 服务的关键点，为帮助您快速完成，我们为您准备了相关[开发DEMO](/app-integration-dev/docs-center/online-preview-edit/demo/public/intercept-link.html)以供您参考。同时，在[服务端回调](/app-integration-dev/docs-center/online-preview-edit/callback/summary.html)章节中，我们对该服务的实现细节进行了详细的说明，您可以先阅读一遍文档，然后再去看 DEMO 源码，以便更快的上手。

### 步骤 3: 回调服务配置

:::tip 提示
网关服务，需要有公网域名，或者ip，保证能正常被WebOffice服务访问到。
:::

在您的回调服务项目开发到一定程度后，就可以将其部署至公网，然后进入[**<u>开发者后台</u>**](https://365.kdocs.cn/3rd/open/developer/home)的回调配置栏下，首先配置好您的**回调网关**，然后就可以对您的接口进行在线调试，根据返回的错误信息来一步一步完善您的回调服务。

![](https://open-docs.wpscdn.cn/public/dms/prod-env/resource/1/7f/73/7f73bfb223060985c8038484f842a77fb2f6914b95b2638d96e4d6f928e3d5a3.png)

### 步骤 4: 集成 WebOffice SDK（JSSDK）

回调服务实现后，就可以开始在您的前端网页内集成 WebOffice SDK，然后通过 SDK 来完成 WebOffice 文档的初始化渲染。同时我们在 [前端 SDK](/app-integration-dev/docs-center/online-preview-edit/web/summary.html)这一章节对这个过程进行了详细的介绍，按照指引要求依次[下载版本](/app-integration-dev/docs-center/log/jssdk)、引用和初始化。

如下为前端通过 JSSDK 初始化 WebOffice 文档的最基础示例代码：
:::tip 提示

1. 如果是在线格式“智能文档”、“智能表格”，服务端用到的原始模板，前往[模板下载](../product/format.md#tpl-download)
2. 如果文档没有按照预期渲染或者页面出现报错，您可进入 WebOffice 控制台的[日志查询](/app-integration-dev/docs-center/console/app-management/log)模块，根据日志信息排查问题原因。
   :::

```html
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>WebOffice</title>
  </head>
  <script src="./web-office-sdk-solution.umd.js"></script>
  <body>
    <script>
      window.onload = () => {
        const instance = WebOfficeSDK.init({
          officeType: WebOfficeSDK.OfficeType.Writer,
          appId: 'xxxxx',
          fileId: 'xxxxx'
        })
      }
    </script>
  </body>
</html>
```

### 步骤 5: 对接API接口

您可以在[JSAPI文档](/app-integration-dev/docs-center/online-preview-edit/client/summary.html) 章节了解各类文档的能力并调用，通过实例上的**Application**属性获取到该文档应用的 API 对象，然后通过该对象对文档进行内容的更新、格式的设置和窗体的管理等一系列操作。API 风格与 VBA 一致，原则上是兼容 VBA 的接口和参数的。

### 步骤 6: 体验效果并购买

以上步骤完成后，说明您已成功将 WebOffice 文档渲染至业务前端，在相关功能符合预期且测试完成后，便可以着手进行申请发布正式。在发布正式前，您需要先进行[企业充值或购买应用套餐](https://solution.wps.cn/console/cost/balance) ：

* 企业充值为先充值，后按实际使用量扣费，为不影响服务正常使用，请确保账户余额 ≥ 1500元。
* 购买应用套餐为购买固定权益套餐包，购买任一应用套餐方可发布正式应用。

![](https://open-docs.wpscdn.cn/public/dms/prod-env/resource/1/e3/1e/e31edbda8e4f4c12d1494d4904f60f7deba3dd4d9c1d2d397485eb0a6c656646.png)

### 步骤 7: 申请发布正式

您需要并提交测试应用使用 WebOffice 的系统截图，等待官方审核通过后即可上线应用，审核结果将在 2 个工作日 内完成并通过邮件告知您。审核通过后，用户即可正式使用应用能力。

![](https://open-docs.wpscdn.cn/public/dms/prod-env/resource/1/fc/4a/fc4ab95d1aefb5451f89b4dc92386b8140f368edc54b8cb0d723bae75dea937b.png)

### 步骤 8: 出账开票

应用能力发布正式后，您可以在费用中心自助完成充值、查看每月各应用产生的**费用账单**、**申请发票**等操作。具体操作指南详见[充值计费](/app-integration-dev/docs-center/console/charge/balance)。

![](https://open-docs.wpscdn.cn/public/dms/prod-env/resource/1/c5/06/c5067e6c2c668bd2b7eb459a2c03071d52c377cc217f59d08561cb025e3c7c46.png)


