自定义集成

借助 Workplace API 的强大功能将 Workplace 与现有流程集成。自定义集成适用于您组织开展的内部开发项目(或仅供单一 Workplace 客户使用的定制开发项目)。

概览

Workplace 的自定义集成服务使用图谱 API帐户管理 API 来扩展 Workplace 的功能。

通过构建自定义集成应用,您可以将员工资料同步至身份服务、自动添加小组成员、备份小组帖子,或者根据其他服务的活动自动向特定小组发布帖子。

您还可以使用自定义集成构建小组和聊天智能助手,让其在 Workplace 小组或 Work Chat 中与用户交流。

自定义集成适用于您组织开展的内部开发项目(或仅供单一 Workplace 客户使用的定制开发项目)。如果您有其他用途,例如为多位 Workplace 客户提供 SaaS 或 PaaS 集成,则建议您改用第三方应用。

为自定义集成生成的访问口令不会与生成该口令的用户相关联。因此,当移除或停用用户时,口令不会过期,也不会发生变换。访问口令会一直有效,直到 Workplace 管理员手动变换访问口令或自定义集成遭到禁用。

创建适用于 Workplace 的应用

适用于 Workplace 的图谱 API 及帐户管理 API 是公开提供的 API,开发者只需了解如何调用基于 REST 的 API,即可调用这两个 API。这些 API 的访问权限由应用控制,具有特定权限并受访问口令保护。

只有 Workplace 社群的系统管理员才能在该社群中建立应用及生成访问口令。

应用和公共主页

在您创建自定义集成后,系统会创建两个对象:

  • 应用,该应用拥有“编辑应用”画面中定义的特定权限。
  • “智能助手”类型的公共主页,该公共主页只会出现在您的 Workplace 社群中。公共主页名称会反映自订自定义集成的名称,而其头像将与创建自定义集成时所选的图标相符。

在您创建自定义集成时,系统会生成自定义集成口令并向您展示;使用此口令就能以您公共主页的身份读取和撰写帖子。

创建自定义集成

如要创建适用于 Workplace 的应用,请按照以下步骤操作:

  1. 打开管理面板集成选项卡。
  2. 点击创建应用按钮。
  3. 为应用选择相关的名称和描述。
  4. 为应用添加头像。每当应用需以视觉方式呈现时(例如应用在小组中发布帖子),系统便会展示此图片。
  5. 根据您需要的集成功能,为应用选择必要的权限
  6. 复制并妥善存储向您展示的访问口令。在发出 API 调用时,您会用到此访问口令。

阅读更多

如要进一步了解如何创建适用于 Workplace 的应用,或者找出自定义集成的使用案例,请参阅以下指南。