API 操作

本帮助页面上的信息同时适用于 StudioDesktop Studio

API作是允许您在脚本中使用Studio API 的CXone Mpower作。 您可以使用该操作,而不是使用传统集成方法调用 API,例如使用代码片段或 RestAPI 操作。 API 操作均位于 Desktop Studio 中的框架选项卡上。Studio中,它们位于API作选项板上

API 操作与标准 Studio 操作不同。 目前,联机帮助中尚未记录此类操作。 不过,与 API 操作相对应的 API 在 CXone Mpower 开发者门户 一个方块,箭头从中心指向右上角。中有文档说明。 在脚本中使用 API 操作时,您可以使用此文档。

并非每个 CXone Mpower API 在Studio 中均有相对应的 API 操作。

在脚本中设置安全用户

所有API作和许多框架作都需要安全用户才能正常运行。 安全用户是一个 CXone Mpower 员工配置文件,具有允许其访问 CXone Mpower 并与之交互的权限。 在脚本中使用时,安全用户可使 Framework 或 API 操作访问 CXone Mpower。 其应为仅用于此目的的专用帐户。 您必须使用有效、活跃的CXone Mpower员工配置文件。

安全用户需要有允许其访问 CXone Mpower 并执行必要操作的权限。 没有一组权限列表,因为要求因所使用的操作而异。

  1. 创建 CXone Mpower 员工配置文件。 对于该用户: 
    • 为其提供一个将其标识为安全用户的名称。
    • 将“创建新员工”页面的“安全”选项卡上的登录身份验证程序设置为无已选。 没有登录身份验证程序意味着无法使用该帐户登录 CXone Mpower。 没关系,因为您不需要使用该帐户登录。 它仅用于通过 Studio 脚本提供访问。
    • 为其分配具有适当权限的角色。 最佳做法是专门为安全用户创建一个角色。
    • 保存新员工配置文件后,转到 ACD > ACD 用户,然后搜索新配置文件。 记下 ID 列中的编号。 这是用户的坐席 ID。 您可以在配置脚本时使用它来查找用户。
  2. Studio 脚本中,添加 SetSecurityUser 操作。 此操作位于 Desktop Studio 的“框架”选项卡Studio 的“API 操作”选项卡中。 将此操作放在任何其他 Framework 或 API 操作之前。 Studio 中,SetSecurityUser 操作位于“API 操作”选项板中。
  3. SetSecurityUser坐席属性中,输入安全用户的名称或坐席 ID,然后选择匹配的记录。 如果您使用多个安全用户,则可以在此字段中使用变量替换。
  4. 将输出变量保留为默认 SecurityUser。 这是在 ScriptVar (out) 属性 中定义的(在 Studio 中:脚本变量。 如果更改它,则必须使用新变量配置脚本中的每个 Framework 或 API 操作。 具有此变量的属性有不同的名称,具体取决于所使用的 Framework 或 API 操作。 两个常见的名称为 Security UserAuthContext

API 操作版本

随着 CXone Mpower API 的新版本的发布,Studio 中可能会发布相对应操作的新版本。 一般来说,最好使用最新版本的操作。 旧版本在大多数情况下仍然有效。 您可以尝试不同的版本,看看哪些版本有效并提供您需要的功能。

某些 API 操作的操作名称中包含版本号。 查看“框架”选项卡上的操作树结构时,即可看到它。 并非所有 API 操作均包含版本号。 对于这些操作,您可以在其扩展属性中找到版本号。 仅当在“框架”选项卡中选择操作时,您才能在“属性”选项卡上看到扩展属性。

并非每个 API 的每个版本在Studio 中都有相对应的操作。

查看 API 操作扩展属性

此任务只能在 Desktop Studio 中完成。

  1. Studio 中,重新排列选项卡,这样您就可以同时看到“属性”选项卡和“框架”选项卡。
  2. 在“框架”选项卡上,单击 API 操作。
  3. 在“属性”选项卡上,现在即可看到该操作的扩展属性。 在了解 API 操作时,以下属性尤其有用:
    • 其他 > 参数 > 动词:该属性显示与操作相关联的方法或动词。
    • 其他 > 参数 > 版本:该属性显示 API 的版本。
    • 其他 > Web > URI:在开发者门户中查找 API 文档时,该属性很有用。
    • 其他 > 参数:在“参数”部分,您可以展开属性,查看有关每个操作属性的附加信息。

查找 API 文档

此任务只能使用 Desktop Studio 完成。

CXone Mpower API 记录在 CXone Mpower 开发者门户中。 Studio 中的 API操作没有与其 API 相对应文档的直接链接。 不过,您可以使用该操作的扩展属性中提供的信息来帮助您查找文档。

使用此 URI 需要大致熟悉整个 CXone Mpower 系统以及不同的 CXone Mpower API。 这是因为确定哪个 API 与 Studio 中的操作相匹配并不总是很简单。 了解联系人通过 CXone Mpower 的一般流程有助于您正确解释操作的 URI,以及将在那里找到的线索应用于开发者门户中的 API 文档结构。 本部分中的示例演示了可能需要的解释。

开发者门户 API 部分的主页提供了每个 CXone Mpower API 的概述

示例 1

有时,操作与其 API 之间存在直接关联:

根据操作的名称和 URI,首先要考虑的两个 API 是 Agent APIAdmin API。 通过查看每个 API 的调用列表,您可以排除 Agent API。 其描述表明它用于管理坐席会话,但似乎没有任何与技能相关的调用,如下图所示。

Admin API 表明它与技能等系统对象一起使用。 该 API 可用的 API 调用列表包括技能,如下图所示。

展开“技能”部分时,端点之一为 GET /skills/agents。 该端点的简短描述称其“返回技能分配”。

示例 2

有时,相关性并不明显,如下例所示。 在这种情况下,您需要应用 CXone Mpower API 和平台本身的知识来查找相应的 API 端点。 -

根据该操作的名称和 URI,并不能立即看出首先要查看哪个 API。 如果您不确定从哪里开始,可以查看每个 API 的文档并检查与联系人相关的任何部分。 Admin API 是唯一具有顶层联系人部分的 API。 遗憾的是,该 API 不包含与活动联系人相关联的端点。

此时,您可以在操作名称和 URI 中键入单词 active。 根据您对 CXone Mpower 的了解,您知道活动表示当前正在处理的联系人。 这会让您更仔细地研究“实时数据 API”。 该 API 只有一个部分,将其展开时,您会看到其中一个端点为 GET /contacts/active。 该端点的简短描述称其“返回活动联系人”。