概览
借助 Workplace 自定义集成，您现在可以构建强大的智能助手，在小组和聊天中与用户互动。
您可以构建智能助手，让该智能助手自动将内容发布到小组、用补充信息回复问题或者在被帖子评论提及时做出回应。您也可以构建能与 Workplace 聊天用户交流的智能助手，让该智能助手通过快速回复和固定菜单等结构化对话元素，做到实时提供信息或处理请求。
如要构建社群智能助手，您需要有“系统管理员”这一管理员身份。
如果您并非所在 Workplace 社群的管理员，则需要与管理员协作才能构建智能助手。
公共主页形式的智能助手
智能助手在 Workplace 上的表现形式与在 Messenger 开放平台上类似，均以公共主页的形式来表示。在您创建自定义集成应用时，系统会自动创建一个公共主页。您 Workplace 社群中的用户能够通过该公共主页发现您的智能助手，并与之互动
智能助手公共主页面向全公司开放，因此所有 Workplace 社群成员都能查看和标记智能助手，并向其发送消息。然而，智能助手可能无法查看 Workplace 中的所有内容以及与这些内容互动，具体取决于您创建智能助手时所选择的权限级别。
例如，如果智能助手拥有阅读小组内容权限，将可以查看小组中的内容。如果智能助手没有向小组发布内容的权限，那么将无法在任何小组中回复内容。
此外，用户仅可在智能助手拥有向任意成员发送消息的权限时，在 Workplace 聊天中找到该智能助手并向其发送消息。
小组智能助手
在小组中，智能助手可以做许多用户能做的事情。也就是说，您构建的智能助手可以发布新内容以及用新信息评论内容，并且可以点赞帖子，以表示认同或赞成。
智能助手还可以使用 @ 提及用户，从而引起对方的注意，而用户也能使用 @ 提及智能助手来发起特定工作流程或提问。
最后，智能助手可以订阅小组和 @ 提及 Webhooks，从而以灵活的方式监控内容并与用户开展互动。
聊天智能助手
在小组中，智能助手可以通过异步的方式从一大群用户那里获取信息，并与他们分享信息；而在聊天中，智能助手最适合用于与单一用户或特定群组用户开展直接实时互动。
例如，聊天智能助手可以用于根据近期活动（例如面试或会议）向用户发送重要提醒或通知。Workplace 聊天智能助手还可以用于在对话中与用户互动，并根据收到的反馈采取后续行动。
这种互动模式的原理与 Messenger 开放平台所采用的相同。因此，Workplace 聊天智能助手可以凭借固定菜单、快速回复以及模板等功能来丰富用户体验。
智能助手与用户聊天
如果智能助手拥有向任意成员发送消息的权限，将可以使用 Messenger 发送 API，通过 Workplace 用户的邮箱或 Workplace 编号向其发送私信。
拥有向任意成员发送消息的权限之后，智能助手还能显示在 Workplace 聊天界面的预输入中。
通过订阅公共主页消息 Webhooks，智能助手还可以在用户向其发送消息时收到通知。此外，您也可以将发送和接收消息的功能结合，以构建对话流。
智能助手与小组聊天
如果智能助手拥有向任意成员发送消息和小组聊天智能助手权限，便可创建及管理多用户小组聊天对话，同时您也能将其添加至对话。智能助手可以通过指定收信人名单来创建新的小组对话，同时还能重新命名对话以创建聊天讨论，以便与特定用户就具体主题进行交流。
启用小组聊天支持后，智能助手会显示在现有小组聊天对话的添加用户预输入中。之后，每当用户在对话中发送消息，智能助手都能收到 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}/participants 连线发送 POST 或 DELETE 请求，以将互动者加入对话，或从中移除，具体如下所示：
POST t_<thread_id>/participants
{
"to": [<user_ids>]
}
DELETE t_<thread_id>/participants
{
"to": [<user_ids>]
}请注意，您可以在 /{thread}/participants 连线上对由集成创建的对话进行操作。
在对话中提及智能助手
当用户在消息中提及智能助手时，我们的 Webhooks 会发送在该消息中被标记的成员的名单，具体如以下负载所示：
{
"object":"page",
"entry":[{
"id":"746230239054322",
"time":1539281406974,
"messaging":[{
...
"message":{
"mid":"<message id>",
"seq":2192,
"text":"@Edu Gomes @Example Bot What's 2+2?"
},
"mentions":[{
"offset":0,
"length":10,
"id":"100017376437045"
},
{
"offset":11,
"length":12,
"id":"746230239054322"
}]
}]
}]
} 智能助手开放平台合作伙伴
Workplace 拥有众多智能助手开放平台合作伙伴，他们都已在 Workplace 上为智能助手提供支持。您可以点击此处，查看这些合作伙伴的名单。凭借这些开放平台，您无需编写一行代码，就能构建强大的智能助手。
最佳实践
按需创建
在决定是否要为智能助手构建小组或聊天互动功能时，您需要考虑智能助手在哪方面能发挥出最大功效。
- 如果您想构建的智能助手可以与多人同时互动，或者能够向多位用户发布内容以供查阅，则您应该构建可以向小组发布内容以及回复评论和小组帖子提及的智能助手。
- 如果您想构建的智能助手需要提醒用户紧急事项、需要快速跟进的事项以及应该私下沟通的事项，则您应该构建可以支持 Workplace 聊天对话的智能助手。
一款应用就能满足以上全部需求。可能有时候，服务台智能助手会收到 Workplace 聊天消息；而有时候，智能助手又需要在小组中发布消息以及收集回复。
智能助手的深度链接
使用链接格式 https://w.m.me/{page-id} 直接链接至 Workplace 聊天智能助手。网页、Android 和 iOS 端的 Workplace 聊天均支持此功能。在已安装 Workplace 聊天应用的移动平台上，系统会直接在应用中打开链接。
转介参数
您可以使用转介参数，以便在链接中加入更多信息。例如，借助该功能，智能助手可根据用户通过点击哪位用户跳转至智能助手来执行自定义操作。
如要使用此功能，请使用链接格式 https://w.m.me/{page-id}?ref={referral_parameter}。此功能的实现方式与 Messenger 开放平台相同。详情请参阅 Messenger 文档。
相关的 Webhooks 字段是 messaging_referrals，而且该字段需要受到订阅。此前 Workplace 应用无法使用这个 Webhooks 字段，但是如今您可以正常订阅该字段。
Webhooks 负载的格式与 Messenger 相同，但是两者存在一些常见差异：Workplace 使用应用范围编号，而非公共主页范围编号。此外，Workplace 也会在 Webhooks 中提供社群字段，内含社群编号。
小组互动
订阅 Webhooks 之后，在收到小组发布的消息或评论提及时，智能助手会收到通知。智能助手务必需要及时回复提及消息。如果智能助手需要先处理请求然后再回复，则可以点赞评论，向用户表明已获悉该提及。
另外，如果您要在被评论提及之后提供信息，请添加对话回复，以确保后续小组对话可以流畅展开。
如果智能助手需要为初始发布人提供信息，请对发布的原始消息添加评论，这样初始发布人也会收到通知。
聊天互动
Workplace 聊天中的智能助手互动支持的功能与 Messenger 开放平台上的相似，包括快速回复按钮和模板，后者可以帮助您实现智能助手对话的决策树。
如此一来，构建实用工作流和减少用户所需输入量变得更加简单，不再需要处理复杂的自然语言，这可以在您为全球员工构建智能助手的过程中进一步简化国际化过程。