由 Cisco 开发且正在使用的 bot 示例。

BotWebex 应用程序

Bot 可帮助扩展 Webex 应用程序以包含第三方应用程序。您可以将 bot 添加到Webex 应用程序空间,并直接从空间和第三方应用程序交互。 将 bot 添加到空间后,您可以 help 向 bot 发送消息,并且响应将包括 bot 所支持的命令。

您可以将 bot 添加到任何类型的空间;向包含其他人的项目空间添加 bot,并在空间中直接与第三方应用程序进行交互。 或者,您可以创建只包含您和 bot 的空间以与第三方应用程序进行交互。

Webex App Hub 包含由 Cisco 和第三方开发人员开发的 bot 和应用程序目录。

卡片Webex 应用程序

Bot 在中呈现信息Webex 应用程序以各种方式。 Bot 卡可以方便用户直接与 bot 对命令的响应交互。 您可以从下拉菜单中选择,使用按钮,甚至使用文本字段来更新和收集信息。

请参阅 应用程序应用程序的 按钮Webex卡。


 

您可以使用卡片向 devsupport@webex.com 报告有关 bot 的任何问题。

如果您的管理员为组织中非管理员启用了 bot,您可以在Webex 应用程序空间。

准备工作


 

您的 ServiceNow 管理员必须允许 bot 访问(如管理标签页中所述 )才能与 bot 交互。

1

在Webex 应用程序栏中,选择 >发送直接消息。

2

输入 @ServiceNow 以搜索 bot。

3

列表中选择 ServiceNow bot 来打开空间。

下一步

bot 会创建一个包含欢迎卡 和链接服务帐户按钮 的空间。 如果您是 ServiceNow 管理员,请单击 按钮并按管理标签页中的说明完成 bot 设置 过程。

如果您不是管理员,请要求您的 ServiceNow 管理员完成 bot 设置过程,以便非管理员用户与 bot 交互。

在 ServiceNow 中从空间创建事件。

1

在 ServiceNow bot 空间中,输入 help 并发送消息。

2

选择 报告事件 并输入报告问题的人的姓名,然后单击 搜索主叫方

3

输入描述、事件状态和通知,然后选择提交 事件

查找事件编号或创建日期的事件。

1

输入 help (在 ServiceNow bot 空间中)并选择 获取 卡上的事件。

  • 通过最近的 - 选择 按最近 访问来查看最近打开的事件列表。
  • 按事件编号 - 选择 搜索事件 以输入事件编号。
2

选择 再次获取 事件以查看事件详细信息。

使用 bot 卡更新或解决事件。

1

在 ServiceNow bot 空间中,输入 help 并发送消息。

2

搜索要管理的事件。

3

从事件 详细信息卡 中选择:

  • 更新- 要更改事件的描述和状态。 要更新其他详细信息,单击 ServiceNow 中的查看
  • 标记为已解决- 提供解析代码并添加解析笔记。
您的笔记在 ServiceNow 应用程序中可见。

连接Webex 应用程序使用 ServiceNow,然后配置 bot 设置和权限以允许对非管理员用户访问 bot。

首先,使用 ServiceNow bot 创建一个空间以关联您的帐户。 如果您使用防火墙或限制对域的访问,请 允许这些 IP 地址

1

在应用程序标题中,> 发送直接消息。

2

输入 bot 名称 ServiceNow.bot@webex.bot 并创建空间。

3

Enter help 并发送消息。

4

bot 卡中选择链接 ServiceNow 帐户。

5

在设置网页中,输入您的 ServiceNow 域(不包括: .service-now.com)

6

打开另一浏览器窗口以完成 服务管理 中的管理设置步骤。

在设置期间,始终打开这两个窗口。

创建集成用户档案

接下来,创建一个档案,它将与 bot 交互的权限应用于组织的所有非管理员用户。

  1. 登录您的 ServiceNow 管理员帐户,然后搜索 Users (在 过滤器导航器中)。

  2. 组织下,选择 用户> 新建。

  3. 添加 Integration_User 到用户标识字段,设置密码,然后选择内部 集成用户 框并 提交

  4. 从用户列表中选择 IUserntegration_档案 并选择 页面底部的角色标签页。

  5. 单击 编辑然后在收集 列表中选择管理员,然后单击 添加 保存

  6. 选择 更新”页用户档案更新。

  7. 在设置网页中,单击 Connect To ServiceNow页面底部的验证

设置域

注册 IUserntegration_档案 并应用 bot 设置。

  1. 从 ServiceNow 应用程序中注销管理帐户,然后以 Integration_User 使用您先前创建的密码。

  2. 在设置网页中, 选择登录到集成用户帐户,然后选择 继续管理设置

  3. 在添加客户端 标识密码之前,复制 重定向 URL,然后返回到您的 ServiceNow 应用程序。

  4. 搜索 application registry ,然后选择 应用程序注册表

  5. 单击 新建 > 为外部客户端创建 OAuth API 端点

  6. Enter webex service now App ,然后单击解锁 粘贴 设置窗口中复制的重定向 URL。

  7. 在设置网页中 ,单击如何找到我的服务客户端标识、密码和重定向 URL ,然后向下滚动至第 4 步并复制徽标 URL。

  8. 在 ServiceNow 应用程序中,单击 解锁 粘贴徽标 URL,然后单击 提交

  9. Webex 服务选择 立即使用应用程序,复制 客户端标识,然后单击 解锁以复制客户端 密码

  10. 在设置 窗口中 添加 客户端标识和客户端密码,然后单击继续和允许将 Webex 服务应用程序 连接到您的帐户。

  11. 选择引起事件所需的字段,然后单击继续

配置 bot 并应用权限

链接电子邮件标识和域名以允许所有非管理员用户访问。 然后,配置 bot 请求和响应参数,并应用数据访问权限。

  1. 从 ServiceNow 应用程序中搜索 scripted rest APIs ,然后选择 脚本REST API

  2. 单击 新建,添加 Webex scripted API 作为名称,然后将其复制并粘贴到 API 标识 字段中,然后单击 提交

  3. 在脚本 REST API 列表中 ,单击 Webex scripted API 并选择页面 底部的资源 标签页。

  4. 单击 新建,添加 Webex scripted API 作为资源名称,将 HTTP 方法更改为 POST

  5. 从如何找到 我的 ServiceNow 客户端标识、密码和重定向 URL说明复制脚本,向下滚动至第 6步,然后将脚本复制并粘贴到脚本 字段中。

    确保替换任何现有文本,然后单击提交

  6. 复制服务器 左上方 的“基本 API”用户档案,然后单击 更新

  7. 在设置网页中,添加您的 ServiceNow 管理员电子邮件标识并 粘贴基本 API 路径,然后单击保存 关闭窗口

完成设置

完成设置后 Integration_User 档案,限制对 Web 服务的访问,以防更改其设置。

  1. 在 ServiceNow 应用程序中,搜索 Users (在 过滤器导航器中)。

  2. 从用户列表中选择新用户用户档案编辑

  3. 选择仅 Web 服务访问 框,然后单击 更新 并注销服务管理。

错误消息: 无法执行请求的操作,指定的电子邮件标识未注册为 ServiceNow 实例中的用户。 请联系 ServiceNow 帐户管理员。

ServiceNow 管理修复: 将收到错误消息的用户添加到实例的用户列表中。