Workplace 智能助手

概览

借助 Workplace 自定义集成，您现在可以构建强大的智能助手，在小组和聊天中与用户互动。

您可以构建智能助手，让该智能助手自动将内容发布到小组、用补充信息回复问题或者在被帖子评论提及时做出回应。您也可以构建能与 Workplace Chat 用户交流的智能助手，让该智能助手通过快速回复和固定菜单等结构化对话元素，做到实时提供信息或处理请求。

公共主页形式的智能助手

智能助手在 Workplace 上的表现形式与在 Messenger 开放平台上类似，均以公共主页的形式来表示。在您创建自定义集成应用时，系统会自动创建一个公共主页。您 Workplace 社群中的用户能够通过该公共主页发现您的智能助手，并与之互动

智能助手公共主页面向全公司开放，因此所有 Workplace 社群成员都能查看和标记智能助手，并向其发送消息。然而，智能助手可能无法查看 Workplace 中的所有内容，以及与这些内容互动，具体取决于您创建智能助手时所选择的权限级别。

例如，如果智能助手拥有阅读小组内容权限，它将可以查看小组中的内容。如果智能助手没有向小组发布内容的权限，那么它将无法在任何小组中回复内容。

此外，用户仅可在智能助手拥有向任意成员发送消息的权限的情况下，在 Workplace Chat 中找到该智能助手并向其发送消息。

小组智能助手

在小组中，智能助手可以做许多用户能做的事情。也就是说，您构建的智能助手可以发布新内容以及用新信息评论内容，并且可以点赞帖子，以表示认同或赞成。

智能助手还可以使用 @ 提及用户，从而引起对方的注意，而用户也能使用 @ 提及智能助手来发起特定工作流程或提问。

最后，智能助手可以订阅小组和 @ 提及 Webhooks，从而以灵活的方式监控内容并与用户开展互动。

聊天智能助手

在小组中，智能助手可以通过异步的方式从一大群用户那里获取信息，并与他们分享信息；而在聊天中，智能助手最适合用于与单一用户或特定群组用户开展直接实时互动。

例如，聊天智能助手可以用于根据近期活动（例如面试或会议）向用户发送重要提醒或通知。Workplace Chat 智能助手还可以用于在对话中与用户互动，并根据收到的反馈采取后续行动。

这种互动模式的原理与 Messenger 开放平台所采用的相同。因此，Workplace Chat 智能助手可以凭借固定菜单、快速回复以及模板等功能来丰富用户体验。

智能助手与用户聊天

如果智能助手拥有向任意成员发送消息的权限，则将可以使用 Messenger 发送 API，通过 Workplace 用户的邮箱或 Workplace 编号向其发送私信。

智能助手显示在新消息预输入中

拥有向任意成员发送消息的权限之后，智能助手还能显示在 Workplace 聊天界面的预输入中。

智能助手显示在新消息预输入中

通过订阅公共主页消息 Webhooks，智能助手还可以在用户向其发送消息时收到通知。此外，您也可以将发送和接收消息的功能结合，以构建对话流。

智能助手与用户对话

智能助手与小组聊天

智能助手还能够创建和管理多用户小组聊天对话，同时您也能向对话中添加智能助手。智能助手可以通过指定接收人名单来创建新的小组对话，同时还能重新命名对话以创建聊天讨论，以便与特定用户就具体主题进行交流。

由智能助手创建并包含特定用户的已命名对话。

启用小组聊天智能助手

要允许智能助手创建包含 Workplace 用户的小组聊天，请打开“编辑自定义集成”对话框的“权限”窗口，然后勾选标有允许此集成在小组聊天中运行的复选框。

启用支持小组聊天的自定义集成智能助手。

启用小组聊天支持后，智能助手会显示在现有小组聊天对话的添加用户预输入中。之后，每当用户在对话中发送消息，智能助手都能收到 Webhooks，并且可以使用其 thread ID 回复该对话。

将智能助手加入小组聊天，然后使用 @ 提及该智能助手

创建新的命名对话

要创建包含特定接收者的新对话，请向 /me/messages 端点发送 POST 请求，从而指定 recipient IDs 数组和初始 message 负载，具体如下所示：

POST /me/messages
{
  "recipient": {
    "ids": [<user_ids>]
  },
  "message": <message_payload>
}

您将收到包含 thread ID 的响应负载，并可在后续消息中使用该参数。

如果再次使用包含相同接收者名单的同一个端点，就会创建新的对话。要给已创建的对话发送后续消息，请使用 recipient 负载中的 thread_id 向 /me/messages 端点发送 POST 请求，具体如下所示：

POST /me/messages
{
  "recipient": {
    "thread_key": <thread_id>
  },
  "message": <message_payload>
}

要重命名智能助手创建的对话，请向 /{thread}/threadname 连线发送 POST 请求，具体如下所示：

POST /t_<thread_id>/threadname
{
  "name": "new name"
}

请注意，需要为连线路径的 thread_id 添加前缀 t_。

您也可以向 /{thread}/?fields=participants 连线发送 GET 请求，以获取对话互动者名单，具体如下所示：

GET /t_<thread_id>/?fields=participants

您还可以向 /{thread}/participants 连线发送 POST 或 DELETE 请求，以将互动者加入对话，或从中移除，具体如下所示：

POST t_<thread_id>/participants
{
  "to": [<user_ids>]
}

DELETE t_<thread_id>/participants
{
  "to": [<user_ids>]
}

智能助手开放平台合作伙伴

Workplace 拥有众多智能助手开放平台合作伙伴，他们都已在 Workplace 上为智能助手提供支持。您可以点击此处，查看这些合作伙伴的名单。凭借这些开放平台，您无需编写一行代码，就能构建强大的智能助手。

最佳实践

按需创建

在决定是否要为智能助手构建小组或聊天互动功能时，您需要考虑智能助手在哪方面能发挥出最大功效。

• 如果您想构建的智能助手可以与多人同时互动，或者能够向多位用户发布内容以供查阅，则您应该构建可以向小组发布内容以及回复评论和小组帖子提及的智能助手。
• 如果您想构建的智能助手需要提醒用户紧急事项、需要快速跟进的事项以及应该私下沟通的事项，则您应该构建可以支持 Workplace Chat 对话的智能助手。

一款应用就能满足以上全部需求。可能有时候，服务台智能助手会收到 Workplace Chat 消息；而有时候，智能助手又需要在小组中发布消息以及收集回复。

小组互动

订阅 Webhooks 之后，在收到小组发布的消息或评论提及时，智能助手会收到通知。智能助手务必需要及时回复提及消息。如果智能助手需要先处理请求然后再回复，则可以点赞评论，向用户表明已获悉该提及。

另外，如果您要在被评论提及之后提供信息，请添加对话回复，以确保后续小组对话可以流畅展开。

如果智能助手需要为初始发布人提供信息，请对发布的原始消息添加评论，这样初始发布人也会收到通知。

聊天互动

Workplace Chat 中的智能助手互动支持的功能与 Messenger 开放平台上的相似，包括快速回复按钮和模板，后者可以帮助您实现智能助手对话的决策树。

如此一来，构建实用工作流和减少用户所需输入量变得更加简单，不再需要处理复杂的自然语言，这可以在您为全球员工构建智能助手的过程中进一步简化国际化过程。