# 应用机器人

应用机器人是WPS协作中重要的消息通知渠道，企业自研内部系统或外采三方系统，都可通过应用机器人的形式集成到WPS协作，进行重要消息或任务推送触达，提升业务处理效率。

## 创建应用

要使用应用机器人的能力，您必须先通过WPS开放平台创建应用。支持2种类型的应用机器人开发：
- 企业自建应用：详见[创建企业自建应用](https://open.wps.cn/documents/app-integration-dev/guide/self-app/create-app.html)
- 第三方企业应用：详见[创建第三方企业应用](https://open.wps.cn/documents/app-integration-dev/guide/isv-app/create-app.html)

## 设置应用的可见范围

应用机器人只能给应用可见范围内的用户发送消息。因此，应用需要预先设置好可见范围，才能正常使用发消息功能。不同类型的应用可见范围设置入口不一样。

### 自建应用设置可见范围

由应用开发者，在开放平台[开发者后台](https://open.wps.cn/developer/home)的 **应用发布-版本管理** 模块配置。开发者需创建应用版本，在版本详情页的 **可用范围** 入口进行配置。如下图：

![自建应用版本管理](https://cloudcdn.qwps.cn/open/_img/04d14a8d88.png)

![配置自建应用可见范围](https://cloudcdn.qwps.cn/open/_img/9610f1f676.png)

### 第三方企业应用设置可见范围

由**使用方**企业的企业管理员，在[企业管理后台](https://work.wps.cn/xz/app/manage)的 **应用市场-应用管理-第三方应用** 模块配置。管理员选择并进入应用详情页进行修改。如下图

![应用管理](https://cloudcdn.qwps.cn/open/_img/63fa454079.png)

![配置ISV应用可见范围](https://cloudcdn.qwps.cn/open/_img/7e5e801370.png)


## 推送消息

目前应用有2个渠道可以发送消息：
- 通过开发者后台的可视化功能界面发送消息，该方式适用于无代码能力的用户，例如企业内部的HR、行政、财务等，一般用于推送简单的新闻资讯类消息
- 通过消息开放接口发送消息，该方式适用于具备系统集成能力的开发者，例如企业内部的IT部门。一般用于对接推送内部系统（如OA、HR、CRM等）的任务通知类消息

### 通过可视化功能界面发送消息

适用范围：**仅企业自建应用**
应用开发者可使用 **应用能力-WPS协作机器人-消息群发/消息分发** 功能可视化编辑和发送消息。

![WPS协作机器人](https://cloudcdn.qwps.cn/open/_img/79c4c75249.png)

![消息群发和分发](https://cloudcdn.qwps.cn/open/_img/4597b67476.png)

#### 消息群发

将同一条消息内容批量推送给企业内的用户。常用于企业文化传播等推送场景。

1. 支持3种类型的消息：
- 图文混排
- 外链图文
- Markdown

2. 支持3种发送操作：
- 立即发送
- 定时发送
- 暂存草稿

3. 支持3种类型的发送对象：
- 按通讯录：支持选择部门和用户
- 按自定义标签：支持用户自定义创建和维护标签及标签内成员，并按标签进行发送。（不同应用的标签不可混用）
- 按群聊：支持按群聊给群聊内的用户群发单聊消息（<font color='red'>请注意：不是往群聊内发送消息，而是给群聊内的用户分别单发消息</font>）


**推送效果**
|  **消息类型**  |   **推送效果**   |  
| :--------------| :---------------- |
| 图文混排  |    ![图文混排](https://cloudcdn.qwps.cn/open/_img/209c990f38.png)      |
| 外链图文  |   ![外链图文](https://cloudcdn.qwps.cn/open/_img/6b7589764d.png) |
| Markdown  |  ![Markdown](https://cloudcdn.qwps.cn/open/_img/8d73b9c015.png) |

#### 消息分发

将同一消息模板的内容批量推送给企业内的用户，模版内指定的字段可通过 **“通配符+导入数据”** 的形式，实现差异化内容设置。常用于企业生日祝福、体检通知等场景

1. 支持2种类型的消息：
- 图文混排
- 外链图文

2. 支持2种发送操作：
- 立即发送
- 定时发送

3. 支持按导入的邮箱或手机号进行发送对象的匹配
4. 支持按导入的自定义字段进行通配符数据的匹配

![导入模版](https://cloudcdn.qwps.cn/open/_img/0b3e93577f.png)

![导入匹配](https://cloudcdn.qwps.cn/open/_img/4ed49bebb2.png)


**推送效果**
|  **消息类型**  |   **推送效果**   |  
| :--------------| :---------------- |
| 图文混排  |    ![图文混排](https://cloudcdn.qwps.cn/open/_img/254a52848c.png)      |
| 外链图文  |   ![外链图文](https://cloudcdn.qwps.cn/open/_img/fb2dac3b39.png)       |


### 通过开放接口发送消息

适用范围：企业自建应用、第三方企业应用

应用开发者可通过对接[发送消息](https://open.wps.cn/documents/app-integration-dev/wps365/server/im/message/single-create-msg.html)或[批量发送消息](https://open.wps.cn/documents/app-integration-dev/wps365/server/im/message/create-msg.html)接口实现消息推送

通过开放接口发送消息，应用将更灵活地把消息推送结合到自身的业务场景内，实现 “指定业务场景触发 → 推送业务消息” 的效果


## 推送审核

无论是通过功能界面推送的消息，还是通过接口推送的消息，都在一定程度上会受到企业的管控审核。企业管理员可在企业管理后台的[应用推送审批](https://work.wps.cn/xz/app/audit-message)处进行审核。

![消息审核](https://cloudcdn.qwps.cn/open/_img/192194e40a.png)


### 全员消息审核

当应用推送范围是企业全员时（企业根节点），将自动触发审核。企业管理员也可在[机器人设置-应用机器人推送审核](https://work.wps.cn/xz/app/audit-setting/push-review)设置白名单应用，白名单内应用无需进行审核。

![全员消息白名单](https://cloudcdn.qwps.cn/open/_img/d89e2d6778.png)

### 自定义超限审核

企业可手动设置触发审核的人数上限，当应用单次推送的推送人数超过上限时，将自动触发审核。

![消息人数上限](https://cloudcdn.qwps.cn/open/_img/fd003621fb.png)