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

您可以将数据操作用作数字规则条件。 当您使用数据操作作为规则条件时，联系前规则可以评估来自Genesys Cloud Public API、Salesforce、Zendesk或REST API端点的响应数据。 此过程说明如何设置运行数据操作的规则，然后评估其返回的信息。

  1. 有关所有评估规则，请参阅安装中随后的以下说明并配置评估规则。
  2. 执行以下任务之一：
  3. 要使用操作，请按照配置规则操作中的说明进行操作。

  1. 单击 管理员。
  2. 在 “ 出站” 下，单击 “ 规则管理”。
  3. 在 “数字规则集” 选项卡上，单击 “新建”。 创建数字规则集页面打开。
  4. 在 “数字规则集名称” 框中，键入此规则集的名称。
  5. 如果您的数据操作需要联系人数据，请从 “联系人列表” 框中选择一个 联系人列表，以便以后可以选择其列。 “数字规则集名称” 页面
  6. 单击 保存并添加规则。 “添加数字规则” 页面打开。
    笔记: 如果该组已包含规则，请单击添加新规则反而。
  7. 在 “数字规则名称” 框中，键入名称。
  8. 在 “类别” 框中，选择 “预先联系”。
  9. 配置此规则的条件，然后保存该规则。

  1. 在 “条件” 下，在 “类型” 框内单击，然后选择 “数据操作”。
  2. 要显示可用数据操作列表，请单击 “数据操作” 框，然后从列表中选择一个数据操作。
    接下来，您可以输入所选数据操作的数据操作条件。
    注释：
    • 如果现有数据操作不相关，则创建新的数据操作。 请参阅为集成 创建自定义操作。 要创建数据操作，您必须知道数据操作的输入和输出 合约、端点和其他参数。 合约定义传递给数据操作或由数据操作返回的数据的格式。 终端节点是 API 调用的地址。 有关更多信息，请参阅 关于集成、 关于 Genesys Cloud 数据操作集成和 关于集成的自定义操作。
    • 如果您为活动配置数据操作，则此过程可能会影响（减慢）消息发送速度。 数据操作的效率很重要。 进行 API 调用或进行需要很长时间才能完成的数据库查询的数据操作可能会减慢消息发送速度。
    • 如果系统显示 “数据操作的输入合约必须是对象类型”，则所选数据操作与出站不兼容。 兼容的合约类似于以下模式： 兼容的合约架构
    • 要查看数据操作的输入合约，请从管理员菜单中选择操作。 要打开数据操作，请选择其名称。 然后，选择 “输入合约” 选项卡。 架构中的数据必须将值定义为属于某个对象。 请参阅为集成 创建自定义操作。
  3. 要将广告系列数据与数据操作的输入值相关联，请使用出站值 映射到数据操作输入下方的控件。 此映射告诉规则在运行数据操作之前要将哪些信息传递给数据操作。 
    1. 使用 “ 出站值” 列表选择要传递给数据操作的信息项。 您选择的出站值取决于所选的联系人列表。
    2. 使用 “ 数据操作输入” 列表选择数据操作的哪个输入值接收出站值。 例如，您可以将广告系列中的电话号码映射到数据操作的 “单元格” 值。 将出站值映射到数据操作输入
      提示： 如果系统显示验证警告，则数据操作未配置为符合 HIPAA/Secure Data 的数据操作。 在出站使用数据操作之前，请重新配置数据操作并确保其安全。 要重新配置操作，请单击 管理员。 在 集成下，单击 操作。 单击数据操作名称，然后启用 HIPAA/Secure Data 框。

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

    3. 要将更多出站值映射到数据操作输入，请单击加在最后配置的行下方。 重复此步骤，直到映射数据操作所需的所有输入。

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

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

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

    执行以下步骤之一：

    • 要在满足条件时执行规则操作，请将 反转条件设置为否。 此设置是默认设置。

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

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

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

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

      货币评估

      数据操作条件可以评估货币值，但前提是输出结果有两位或更少的小数位。

      如果结果小数点后两位以上，则规则无法对其进行评估。

      查看评估

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

      时间值设定

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

      时间偏移

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

      产出评估

      注意： 字符串比较区分大小写。
  6. （可选）要反转比较运算符，请启用反相比较器盒子。 例如，如果您反转开始于比较器，如果值不以指定值开头，则评估结果为 true。
  7. 如果数据操作输出字段没有值，则此评估将解析为： 如果输出不包含任何数据，则可以决定表达式返回 True 还是 False。 默认设置为 False。
  8. （可选）要评估其他输出值，请单击 “添加”。 重复步骤 1 到 7 以配置新的评估条件。
    注意： 条件与 AND 运算符相连接，因此调用必须满足所有规则条件才能使整个规则的计算结果为 True。
  9. （可选）如果数据操作未返回任何数据，要控制条件的计算结果是 True 还是 False，请单击 “未找到数据解决方案” 开关。 False 是默认值，这意味着当数据操作不返回任何数据时，条件返回 False。
    注意： 如果数据操作不返回任何数据，则 “未找到数据分辨率” 会覆盖 “反向条件” 设置。
  10. 要使用操作，请按照配置规则操作中的说明进行操作。

Note: A digital rule data action execution times out after 20 seconds, which causes the record to wrap up with the code OUTBOUND-RULE-ERROR-SKIPPED. An ERROR level event log is also submitted with the code DATA_ACTION_EXECUTION_FAILED.

合同中数据类型的限制

当管理员为集成 创建自定义操作时，他们会定义输入和输出合同。 在出站规则中使用的数据操作的一些限制包括以下参数：

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

将数据操作作为条件的局限性 

使用数据操作作为条件时，请注意，有几个限制会影响发送消息的速度。 为活动配置的数据操作可能会影响（减慢）消息发送速度。 数据操作服务限制了在一分钟和一小时内可以运行的并发数据操作的数量。

当出站消息操作检测到要发送消息的交互中正在使用的数据操作时，系统会检查有多少并行数据操作正在发生，并减慢相应操作的速度，以确保不符合数据操作方面的限制。 联系人发送消息的速度不如没有数据操作的联系人那么快。 

在评估规则中使用数据操作作为条件时，请记住以下限制：

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