生成Scripts

衍生脚本可使您手动运行脚本。 它还用于从其他脚本或外部进程启动脚本。 您还可以使用它来测试脚本。 测试时，可将其与脚本跟踪一起使用。

要测试脚本，可以使用 Studiotrace option跟踪选项 生成脚本。

要从其他脚本或进程启动脚本：

  • 在调用脚本中使用 SPAWN action。
  • 使用 POST /scripts/start 一个正方形图标，箭头从中心指向右上角。 API。 这是从任何外部进程衍生脚本的推荐解决方案。

除非另有配置，否则业务单位最多可以运行 15,000 个脚本。 达到该限制时，将无法使用此页面上描述的任何方法启动或衍生其他脚本，直到一个或多个脚本停止运行。

脚本参数

脚本参数允许将数据传递到脚本中。 这些数据可能来自其他脚本，包括系统脚本，也可能来自外部源，例如 CRM关闭 管理联系人、销售信息、支持详细信息和案例历史记录等事项的第三方系统。 或 API。 它通过 pN 被传递到pX变量 p1 的脚本中，其中 N 是衍生方法支持的参数的最大数量。 您可以使用上一节中列出的任何选项指定在衍生脚本时要传递到脚本中的数据。

如果要更改这些参数变量的名称，则可以使用新名称在衍生脚本中配置 Begin 操作。 当脚本处理 BEGIN 操作时，pX 变量将被转换为新名称。 如果不指定新名称，这些变量将保留 pX 名称。

在将数据传递到脚本中时，您可以在trace中看到它。 选择 BEGIN 操作可查看跟踪输出变量列表中的参数变量。 如果您已使用新变量名称配置了 BEGIN 操作，请在脚本跟踪中选择 BEGIN 后面的操作来查看它们。 参数变量只有在具有值时才会存在。

自定义参数：

  • 最多支持： 
    • 使用 SPAWN 操作衍生时，每个值 32 KB。
    • 由 API 衍生时，对于所有参数（包括管道分隔符），总计 32 KB。
  • 支持变量替换。 在大括号 ( { } ) 中输入变量名称。
  • 通过 SPAWN 操作或 API 生成时，支持 1-20 个参数。
  • 不支持动态数据对象。 必须首先将对象转换为 JSON 字符串。

Studio 操作的比较

有三个 Studio 操作可以从当前脚本启动一个新脚本。 但它们之间存在一些差异：

  • Runscript：当 触发另一个脚本时，它不会从第二个脚本返回到第一个脚本。
  • Runsub：当 触发子脚本时，只要该子脚本有 操作，脚本就可以返回到第一个脚本。 当子脚本完成时， 操作会将一个值返回给 操作。
  • SPAWN：启动与第一个脚本并行运行的第二个脚本。 衍生脚本无法将数据传递回第一个脚本，除非您在衍生脚本中包含 action。

使用 SPAWN 操作从另一个脚本衍生

如果您不需要向子脚本传递参数值，则只需在父级脚本中添加并配置 SPAWN 操作即可。 如果需要传递参数，您需要进行以下配置：

  • 在父级脚本中进行以下更改：
    • 将 SPAWN 操作放置在您要衍生子脚本的位置。 使用需要传递给子脚本的任何值来配置 SPAWN 操作中的参数属性。 值在变量 p1 中被传递到 p9。
    • 配置 SPAWN 操作的other properties。

  • 在子脚本中进行以下更改：

    • 在 操作中配置参数属性，以更改自定义参数变量的名称。 如果您不执行任何操作，则自定义参数值将保留在 变量中。
    • 如果您需要将值传递回父级脚本或调用应用程序，则添加并配置 action。

通过 API 衍生脚本

使用 POST /scripts/start一个正方形图标，箭头从中心指向右上角。 API 衍生脚本。

使用该 API 时，务必注意：

  • 需要以下参数： 
    • skillId：当作为 JSON 发送时，该值必须是整数，但如果作为查询参数发送，则不是整数。 技能必须： 
        • 处于活动状态。
        • 匹配脚本媒体类型。 例如，电话脚本必须与电话技能相关联。 您可以在技能的“详细信息”选项卡上找到技能类型。 Generic 类型的脚本适用于任何活动技能。

    • scriptId 或 scriptPath：建议使用 scriptPath。 每次保存脚本更改时，脚本 ID 都会发生变化，因此必须在参数中更新它。

  • 您最多可以包含 20 个参数。
  • 参数必须以竖线分隔的列表的形式发送。
  • API 支持所有参数的最大大小为 32 KB，包括竖线分隔符。
  • 参数不能包含竖线字符，除非它们是分隔符。
  • 如果以 JSON 形式发送请求，则必须正确转义保留的字符。
  • 如果通过 URL 查询参数发送请求，则这些参数必须进行了 URL 编码。