Workplace from Meta 即将停用。您可以继续使用 Workplace,直到 2025 年 8 月 31 日为止。详情请访问我们的帮助中心

自定义集成工具

借助 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 的应用,或者如要查找自定义集成工具使用案例,请参阅下方指南。