本文内容

基本功能

应用主页

应用主页是在工作台点击应用后,进入的网页。桌面端和手机端的主页链接,可以分开配置,支持两端跳转不同的网页。

可见范围

企业自建应用在配置应用主页后,根据可见范围在客户端给对应用户展示应用主页。

可见范围支持选择单个联系人、整个部门以及标签。

发送消息

消息群发

应用管理员可在后台使用消息群发功能,以应用的名义向指定部门、成员、标签发送消息,实现不同业务类型在多种场景下进行消息发送的能力,使消息触达更高效,提高消息关注度;

  1. 支持文字、图片、外链图文、markdown 等多种消息类型;
  2. 支持暂存草稿、即时发送、定时发送;
  3. 已发送消息可撤回、重新编辑、导出、查看阅读人数和次数;
  4. 可调用接口发送;

(图1:开发者后台-消息群发)

应用管理员可在后台创建用户标签,通过指定的用户特征,如部门、群聊、性别、办公地点等,去圈定用户群体,提高管理员在添加应用可见范围、发送消息时,选定目标对象的效率,减少管理员维护应用的成本。

  1. 支持表格导入,组织架构、指定成员等多种添加方式
  2. 标签类型包括普通标签、群聊标签,未来将补充动态标签、共享标签等更多种类;

(图2:开发者后台-用户标签)

消息分发

消息分发是一个通过自建应用机器人为每个用户分发定制化消息的功能。

  • 通过上传表格批量获取发送对象名单,表中的表头被解析为通配符,在后续消息内容中被使用
  • 在消息体中使用通配符,如#姓名#,发送后通配符会自动替换成用户的真实信息,从而实现为每个用户发送定制化内容,如为每个用户发送不同的通知内容
  • 在消息体中支持使用智能制图美化图片,选择智能模板,插入通配符或添加自定义内容到模板中,为每个用户定制美图
  • 发送时机支持选择立即发送、定时发送和条件发送。条件发送包括日期当天、日期一周后、日期两周后等选项,系统根据表格获取到的时间数据,自动计算每个用户的发送时间,并在每个用户的发送时间当天自动分发消息,如在每个用户生日当天发送生日祝福

消息分发的流程:

  1. 上传数据

下载导入模板,详细阅读导入模板中的填写说明,按格式填写成员信息,表格中的内容将被系统识别,并在创建消息过程中作为通配符被使用

注意:表格中添加的人员需要在应用的可见范围内

  1. 编辑内容

支持图文混排和外链图文两种消息格式,与消息群发不同的是,消息分发支持使用通配符和智能制图丰富内容。以外链图文为例:

通配符:系统会根据上传的表格自动识别出可使用的通配符,如姓名、公司、部门、日期等,用户可在标题和摘要中插入通配符,通配符会自动转换为用户真实信息。用户也可插入通配符到智能制图的模板中,生成定制美化的图片

智能制图:提供了多种模板,可插入通配符或自定义内容,生成美化图片

  1. 选择发送时机

立即发送:立即发送给用户

定时发送:定时发送给用户

条件发送:根据上传表格中填写的日期,条件发送给用户

  • 日期当天:每年的该时间点发消息给用户,注意:选择日期当天后,消息将每年发送一次消息给用户,适用于生日祝福、公司周年庆、入职周年庆等场景
  • 日期 1 周后:该时间点的 1 周后发消息给用户,适用于入职通知场景
  • 日期 2 周后:该时间点的 2 周后发消息给用户,适用于入职通知场景
  • 日期 3 周后:该时间点的 3 周后发消息给用户,适用于入职通知场景
  • 日期 3 个月后:该时间点的 3 个月后发消息给用户,适用于转正通知场景
  1. 效果预览

预览发送效果,包括发送时间、发送对象、发送消息内容等信息

  1. 发送消息

可以存为草稿,或点击发送消息

消息分发

(图3:开发者后台-消息分发)

消息审核机制

怎样才会触发应用消息审核?

  • 消息审核是针对发送对象的人数限制的:
  1. 企业自建应用发送全员消息,将触发审核。
  2. 企业管理员可定义消息一次最多可发送的人数,超出该人数,也会触发审核。
  • 目前发送消息的途径有:消息群发、消息分发、API 发送,这三种途径都会审核发送对象的人数。

触发审核后怎么办?
审核人是该企业的超级管理员。触发审核后,管理员将在WPS协作收到一条推送,点击推送,管理员将在企业后台完成审核。
触发审核后,通知弹窗上会告诉你管理员是谁,可以联系管理员询问审核情况。

应用需要经常发送消息,可以申请免审吗?
可以。企业管理员可以在后台为应用添加白名单,白名单上的应用,不受以上规则限制。

接收消息

在客户端可以向企业自建应用的机器人对话,发送相关消息,应用的管理员可以在开发者后台看到所有通过机器人对话发送的消息,并在后台直接进行回复。

WOA20211221-205145

(图4:开发者后台-接收发给应用的消息)

自定义菜单

应用管理员可在后台配置应用机器人的会话窗口底部菜单,使企业成员在与应用机器人的会话过程中,通过点击底部菜单,跳转至指定页面或查看指定消息,实现应用的能力补充,企业成员可快速获取到应用的相关知识。

  • 支持配置多级菜单;
  • 菜单点击事件包括网页跳转、发送消息等多种形式。

(图5:开发者后台-自定义菜单)

自动回复

应用管理员可在后台配置应用机器人的自动回复规则,使机器人获得客服职能,以更标准的话术、更及时的效率回答企业成员常见疑问,节省人工成本,也缩短企业成员等待时间,提高企业运行效率。

  • 支持关键词回复、收到消息回复等多种形式的自动回复;
  • 支持设置同时多个回复规则;
  • 支持回复图文混排、外链图文等多种消息类型。

(图6:开发者后台-机器人自动回复)

群机器人

应用管理员可在后台设置群机器人的添加权限,可设置为不支持添加、仅应用负责人及管理员支持添加、仅可见范围支持添加(含应用负责人及管理员),设置后,对应范围的用户可在群中添加该机器人。

(图7:开发者后台-机器人添加入群权限设置)

安全设置

回调地址

回调地址用于 OAuth2.0 登录回调地址校验,具体可以查看调用文档。回调地址仅支持输入 http、https 协议的合法 URL,最多支持添加 20 个 URL。

IP 白名单

所有接口请求都会检查来源 IP,并限制白名单之外的请求,需要开发者在调用接口前配置好来源 IP。

H5 可信域名

仅可信域名内的 H5 可以访问 JSAPI。同时客户端对应内的跳转地址进行校验,与可信域名校验不一致将提示风险。了解 JSAPI

权限申请

为保护用户信息安全,协作开放平台提供的大部分服务端接口,在调用前需要先申请调用权限,并由所在企业的管理员审核通过后,才能调用成功。

具体接口所需要的权限,可以在接口文档上查看“调用权限”部分。比如创建WPS协作群聊 API,所需的调用权限是“群聊管理”。

那么就需要在权限申请中申请“群聊管理”的权限。

事件订阅

应用可通过订阅WPS协作开放平台提供的订阅事件,实时获取并响应WPS协作里的动作,充分利用WPS协作的协作能力,提升应用的业务协作能力。具体可查看事件订阅

例如,你的应用需要及时接收并处理用户发送给应用机器人的消息,那么就可以订阅接收消息事件。WPS协作会在应用机器人接收到用户发送的消息后触发此事件。触发事件消息推送至应用指定的消息接收地址,应用接收并解析消息后即可获取对应的消息内容,处理后续业务逻辑。

测试应用和人员

通过测试应用功能,开发者创建的应用将分为正式版和测试版。在开发阶段,开发者可以通过创建测试应用,进行功能试用和接口调用的测试。

创建测试应用

在开发者后台的应用详情页中,选择“测试应用和人员”模块,进入后即可创建测试应用。每个开发者最多可以创建 2 个测试应用。对应用修改也无需提交审核即可生效。开发者可以添加应用管理员作为测试人员,参与测试。每个测试应用可添加的管理员人为 5 个。

值得注意的是,测试应用申请接口权限,仍需要企业管理员审核,这点与正式应用一致。

使用测试应用

测试应用在创建后,可以在开发者后台中看到。测试应用的功能与正式应用的基本一致,但测试应用没有“群机器人”功能。但测试应用只允许添加 5 名应用管理员作为测试成员,同时没有正式应用的“可见范围”功能。也就是说,测试应用的使用人员范围最多只有应用创建者+管理员,共 6 名人员。

更多操作

转让应用负责人

应用负责人可以主动发起应用转让的操作,当应用负责人离职时,会把负责人身份自动顺延到第一位应用管理员,若没有管理员,则会自动顺延到企业超管。

删除应用

应用负责人和管理员可以发起删除应用的操作,应用一旦被删除则无法恢复。

需要先停用应用,才可以执行删除操作。

应用开关

应用负责人和应用管理员可以启用/停用应用。

本文内容