使用规则评估来自数据操作的信息

您可以将数据操作用作调用规则条件或操作,或两者兼而有之。 使用数据操作规则条件,预呼叫或总结规则可以评估来自 Genesys Cloud Public API、Salesforce、Zendesk 或 REST API 端点的响应数据。 此过程说明如何设置运行数据操作的规则,然后评估其返回的信息。

  1. 有关所有评估规则,请参阅以下 设置和配置评估规则中的说明
  2. 执行以下操作之一:
  3. 执行以下操作之一:
注意: 您可以在同一规则中将数据操作用作条件和操作。 如果仅将数据操作用作为操作,则仍必须为规则配置条件。

  1. 单击 管理员
  2. 在 “ 出站” 下,单击 “ 规则管理”
  3. 在 “呼叫规则集” 选项卡上,单击 “新 建”
  4. 在 “创建呼叫规则集” 页面上,在 “呼 叫规则集名称” 框中键入此规则集的名称。
  5. 如果您的数据操作需要联系人数据,请从 “联系人列表” 框中选择一个 联系人列表,以便以后可以选择其列。 您不需要选择队列。
  6. 单击 保存并添加规则。 
    注意: 如果更新已包含规则的集合,请改为单击 添加新呼叫规 则。
  7. 在 “添加呼叫规则” 页面上,在 “ 呼叫规则名称 ” 框中键入名称。
  8. 根据您是希望在 拨出呼 叫之前 还是在呼叫结束后评估规则, 从 “类别” 框中选择 “呼叫前” 或 “话后结束”。
  9. 配置此规则的条件和操作,然后保存规则。

  1. 在 “条件” 下方,在 “ 类型” 框内单击。 选择数据操作
  2. 要显示可用数据操作的列表,请单击 “数 据操作” 框。 然后从列表中选择一个数据操作。
    您可以为各个类别输入以下数据操作条件:
    • 预定呼叫 联系人 ID 和所有联系人列表列
    • 小结 座席总结、呼叫分析结果、联系人 ID 和所有联系人列表列
    注释:
    • 如果没有适合的现有数据操作,请创建一个新的数据操作。 请参阅为集成 创建自定义操作。 要创建数据操作,您必须知道数据操作的输入和输出 合约、端点和其他参数。 合约定义传递给数据操作或由数据操作返回的数据的格式。 终端节点是 API 调用的地址。 有关更多信息,请参阅 关于集成关于 Genesys Cloud 数据操作集成和 关于集成的自定义操作
    • 数据操作的效率很重要。 如果数据操作发出 API 调用或执行需要很长时间才能完成的数据库查找,则可能会减慢出站拨号速度。
    • 如果系统显示 “数据操作的输入合同必须为 “对象” 类型,则选定的数据操作与出站不兼容。 兼容的合约类似于以下模式:
    • 要查看数据操作的输入合约,请从管理员菜单中选择操作。 要打开数据操作,请选择其名称。 然后选择其输入合约选项卡。 架构中的数据必须将值定义为属于对象。 请参阅为集成 创建自定义操作
  3. 要将广告系列数据与数据操作的输入值相关联,请使用出站值 映射到数据操作输入下方的控件。 此映射告诉规则在运行数据操作之前要将哪些信息传递给数据操作。 
    注意: 对于运行数据操作条件,座席话后和呼叫分析结果输入字段可以保持未填充状态。 对于没有到达座席的呼叫,不会显示座席话后工作。 预览呼叫不会返回呼叫分析结果。 作为此字符串的一部分返回的呼叫分析有时可能为空。 当媒体服务器能够在不使用音频分析(SIP 或 ISDN 断开信号、SIT 和其他原因)的情况下确定如何处置呼叫时,就会出现这种情况。
    1. 使用 “ 出站值” 列表选择要传递给数据操作的信息项。 您选择的出站值取决于所选的联系人列表。
    2. 使用 “ 数据操作输入” 列表选择数据操作的哪个输入值接收出站值。 例如,您可以将广告系列中的电话号码映射到数据操作的 “单元格” 值。
      提示: 如果系统显示验证警告,则数据操作未配置为符合 HIPAA/Secure Data 的数据操作。 在出站使用数据操作之前,请重新配置数据操作并使其安全。 要重新配置操作,请单击 管理员。 在 集成下,单击 操作。 单击数据操作名称,然后启用 HIPAA/Secure Data

      数据操作的输入基于其合约。 合约是 JSON 模式语句(在有人创建数据操作时指定),用于定义传递给函数的数据或函数返回的内容。

    3. 要将更多出站值映射到数据操作输入,请单击最后一个配置行 下方的 +。 重复上述步骤,直到映射了数据操作所需的所有输入。

      使用出站值和数据操作输入之间的这种关联,您的规则会将所需的任何数据传递给数据操作。 例如,数据操作可以使用联系人列表中的列从 CRM 检索信息。

  4. 控制是否满足条件时执行规则操作。

    在某些情况下,您可能希望反转条件,以便在条件相反的情况为 true 时系统执行其数据操作。 此反转可通过将 “ 反转条件” 开关设置为 “是” 来完成。 当条件不满足时,倒置的条件会执行规则操作。

    执行以下操作之一:
    • 要在满足条件时执行规则操作,请将 反转条件设置为否。 此设置是默认设置。

    • 要在条件不满足时执行规则操作,请将 “ 反转条件” 设置为 “是”

  5. 定义了数据操作的输入后,下一步是配置规则以评估数据操作返回的信息。 使用 “ 输出评估 ” 部分可以设置用于计算数据操作的输出合约中任何返回值的表达式。

    1. 从 “ 数据操作输出” 框中选择一个返回值。

    2. 从 “ 比较器” 框中选择一个运算符。

      货币评估

      数据操作条件可以计算货币值,但前提是输出结果的小数位数不超过 2 位。

      如果结果的小数位数超过两位,则规则无法对其进行评估。

      查看评估

      字符串、布尔值和数字比较器非常直观。 您可以将日期字符串与相对时间或特定时间进行比较。 两种类型的时间比较器都提供 “早于” 和 “晚于” 比较器。 区别在于该值是与过去或将来的确切数据和时间进行比较,还是与当前时间进行比较。 通过配置以下内容来设置特定的时间值:

      但是相对时间值是通过配置时间偏移来设置的:

    3. 在 “值 ” 框中键入一个 值。 使用选定的比较器将此值与数据操作返回的值进行比较。 例如,您可以检查邮政编码是否以数字 5 开头:

      注意: 字符串比较区分大小写。
  6. (可选)要反转比较运算符,请启用 反转比较器 框。 例如,如果反转 “开始于” 比较器,则如果值不是以指定值开头,则评估将解析为 true。
  7. 如果数据操作输出字段没有值,则此评估将解析为: 如果输出不包含任何数据,则可以决定表达式返回 True 还是 False。 默认设置为 False。
  8. (可选)要计算另一个输出值,请单击 。 重复步骤 13-15 以配置新的评估条件。
    注意: 条件与 AND 运算符联接,因此调用必须满足所有规则条件,整个规则才能评估 True。
  9. (可选)如果数据操作未返回任何数据,则可以通过单击未找到数 据解决方案 开关来控制条件的计算结果是 True 还是 False。 False 是默认值,表示当数据操作不返回任何数据时,条件返回 False。
  10. 执行以下操作之一:

注意: 调用规则数据操作执行将在 20 秒后超时,这将导致记录被代码 INININ-OUTBOUN-RULE-ERRORLE-SKIPED 包裹起来。 还将提交一个错误级别的事件日志,代码为 DATA_ACTION_EXECUTION_FAILED。

将数据操作配置为规则操作与将其配置为条件非常相似。

  1. 配置规则条件后,在操作下方,单击 类型 框内的。 选择数据操作
  2. 要显示可用数据操作的列表,请单击 “数 据操作” 框。 然后从列表中选择一个数据操作。
    您可以为各个类别输入以下数据操作条件:
    • 预定呼叫 联系人 ID 和所有联系人列表列
    • 小结 座席总结、呼叫分析结果、联系人 ID 和所有联系人列表列
    注释:
    • 如果没有适合的现有数据操作,请创建一个新的数据操作。 请参阅为集成 创建自定义操作。 要创建数据操作,您必须知道数据操作的输入和输出 合约、端点和其他参数。 合约定义传递给数据操作或由数据操作返回的数据的格式。 终端节点是 API 调用的地址。 有关更多信息,请参阅 关于集成关于 Genesys Cloud 数据操作集成和 关于集成的自定义操作
    • 数据操作的效率很重要。 如果数据操作发出 API 调用或执行需要很长时间才能完成的数据库查找,则可能会减慢出站拨号速度。
    • 如果系统显示 “数据操作的输入合同必须为 “对象” 类型,则选定的数据操作与出站不兼容。 兼容的合约类似于以下模式:
    • 要查看数据操作的输入合约,请从管理员菜单中选择操作。 要打开数据操作,请选择其名称。 然后选择其输入合约选项卡。 架构中的数据必须将值定义为属于对象。 请参阅为集成 创建自定义操作
  3. 出站值” 和 “ 数据操作输入 ” 选项将促销活动数据与数据操作的输入值相关联。 此映射告诉规则在运行数据操作之前要将哪些信息传递给数据操作。 
    注意: 对于运行数据操作条件,座席话后和呼叫分析结果输入字段可以保持未填充状态。 对于没有到达座席的呼叫,不会显示座席话后工作。 预览呼叫不会返回呼叫分析结果。 作为此字符串的一部分返回的呼叫分析有时可能为空。 当媒体服务器能够在不使用音频分析(SIP 或 ISDN 断开信号、SIT 和其他原因)的情况下确定如何处置呼叫时,就会出现这种情况。
    1. 使用 “ 出站值” 列表选择要传递给数据操作的信息项。 您选择的出站值取决于所选的联系人列表。
    2. 使用 “ 数据操作输入” 列表选择数据操作的哪个输入值接收出站值。 例如,您可以将广告系列中的电话号码映射到数据操作的 “单元格” 值。
      提示: 如果系统显示验证警告,则数据操作未配置为符合 HIPAA/Secure Data 的数据操作。 在出站使用数据操作之前,请重新配置数据操作并使其安全。 要重新配置操作,请单击 管理员。 在 集成下,单击 操作。 单击数据操作名称,然后启用 HIPAA/Secure Data

      数据操作的输入基于其合约。 合约是 JSON 模式语句(在有人创建数据操作时指定),用于定义传递给函数的数据或函数返回的内容。

    3. 要将更多出站值映射到数据操作输入,请单击最后一个配置行 下方的 +。 重复上述步骤,直到映射了数据操作所需的所有输入。

      使用出站值和数据操作输入之间的这种关联,您的规则会将所需的任何数据传递给数据操作。 例如,数据操作可以使用联系人列表中的列从 CRM 检索信息。

  4. 为此规则配置条件和操作后,单击 “ 保存”。

注意: 调用规则数据操作执行将在 20 秒后超时,这将导致记录被代码 INININ-OUTBOUN-RULE-ERRORLE-SKIPED 包裹起来。 还将提交一个错误级别的事件日志,代码为 DATA_ACTION_EXECUTION_FAILED。

合同中数据类型的限制

当管理员为集成 创建自定义操作时,他们会定义输入和输出合同。 对出站规则使用的数据操作的一些限制包括:

  • 对于输入和输出合约,顶层类型必须是对象。 输入合约不能将数组传递到远程端点。 除非数据操作的输出合约使用翻译映射将数组转换为对象,否则出站合约不能使用响应数据数组。
  • 输出合约可以允许复杂的对象或数组,但 Outbound 不允许在规则条件中使用这些数据类型。 规则条件只能对布尔型、整数、数字和字符串数据类型进行操作。
  • 如果终端节点返回非 JSON 响应,则必须提供将响应转换为 JSON 的中间件服务。 对数据操作的响应必须是有效的 JSON。 否则,数据操作将失败。
  • 切勿尝试拼合数据操作的输出架构中的字段。 请参阅与出站拨号规则一起使用的操作 指南
  • 单个广告活动可以拥有的最大数据操作规则条件数为两个。

数据操作作为条件或操作的限制

当您使用数据操作作为条件或操作时,请注意,有几个限制会影响拨号程序操作的速度。 数据操作服务限制了可以运行的并发数据操作的数量,以及在一分钟和一小时内可以运行的数据操作数量。

当拨号程序操作检测到要拨打的交互或待处理的总结上正在使用的数据操作时,我们会检查发生了多少并发数据操作并减慢这些操作的速度,以确保不会达到数据操作方面的限制。  拨打联系人的速度可能不如没有数据操作的联系人那么快。 在总结方面,我们可能会将总结的处理延迟一小段时间(几毫秒到几秒钟)。

在评估规则中将数据操作用作条件或操作时,请记住以下限制:

  • 用作条件的数据操作的最大数量为 个规则、规则集和正在运行的广告系列两个。
  • 用作操作的最大数据操作数为个规则、规则集和正在运行的广告系列十个。
    注意: 如果您尝试向规则、规则集或营销活动添加的数据操作数量超出允许的数据操作,则保存将失败。 您会看到一条消息,指出发生了拨号错误。