AI 助理
备案控制台
文档
输入文档关键字查找
首页 智能外呼机器人 开发参考 API参考（新） API目录 话术管理 ModifyScript - 修改话术信息

ModifyScript - 修改话术信息

更新时间：
产品详情
我的收藏

修改话术信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用前面加 * 表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
outboundbot:ModifyScriptupdate
*Instance
acs:outboundbot:{#regionId}:{#accountId}:instance/{#InstanceId}
    无
无

请求参数

名称类型必填描述示例值
InstanceIdstring是

实例 ID

c6320d3c-fa45-4011-b3b1-acdfabe3a8c6
ScriptIdstring是

话术 ID

c153d0d8-ba04-41c0-8632-453944c9dd0b
ScriptNamestring是

话术名字

续费提醒
ScriptDescriptionstring否

话术描述

返工回访话术
Industrystring是

行业

电商
Scenestring是

场景信息

回访
ChatbotIdstring否

机器人 ID

chatbot-cn-iFZfi7eq6e
AsrConfigstring否

ASR 配置，参数定义

  • appKey：阿里云账号 appKey。
  • maxEndSilence：语音端点检测时长。
  • silenceTimeout：静默超时，单位秒，用户静默 N 秒后超时。
  • globalMaxEndSilence：静音检测时长
  • vocabularyId：热词表 id
{"appKey":"","engine":"ali","engineXunfei":"","globalMaxEndSilence":701,"globalMaxEndSilenceEnable":true,"maxEndSilence":"500","nlsServiceType":"Managed","recognizeTimeout":"60000","silenceTimeout":"5000","speechNoiseThreshold":"0.18","vocabularyId":"xxxx"}
TtsConfigstring否

TTS 配置，参数定义

  • appKey：阿里云账号 appKey。
  • voice：发音人。
  • volume：音量，取值范围：0～100。默认值：50。
  • speechRate：语速，取值范围：-500～500，默认值：0。
  • pitchRate：语调，取值范围：-500～500，默认值：0。
  • globalInterruptible：语音打断配置
{"appKey":"","engine":"ali","engineXunfei":"","globalInterruptible":true,"nlsServiceType":"Managed","pitchRate":0,"speechRate":99,"voice":"zhiyuan","volume":99}
ScriptContentarray否

通知类实例，传入话术列表。 已作废。

string否

通知类实例，传入话术列表。 已作废。

您好，您昨晚在李佳琦直播间下单的娜薇诗椰子水二代精华2支装还未付款，超时未支付会自动关闭订单，活动错过不再有奥。
ScriptWaveformarray否

通知类实例，传入话术声音列表。 已作废。

string否

通知类实例，传入话术声音列表。 已作废。

无
NewBargeInEnableboolean否

优雅打断配置开关

true
LongWaitEnableboolean否

智能断句配置开关

true
MiniPlaybackEnableboolean否

承接语配置开关

true
MiniPlaybackConfigListJsonStringstring否

语气承接配置，暂时不支持自定义，默认无需传递该参数。（已作废）

无
NlsConfigstring否

已作废

无
EmotionEnableboolean否

情绪识别配置开关

true
AgentKeystring否

机器人业务空间访问 Key

9137ab9c27044921860030adf8590ec4_p_outbound_public
AgentLlmboolean否

机器人业务空间是否大模型业务空间

false
AgentIdlong否

机器人业务空间 ID

1198938
NluEnginestring否

Nlu 引擎（仅大模型场景适用）

枚举：

  • Prompts：大模型场景。
  • 非大模型场景则为空。
Prompts
NluAccessTypestring否

Nlu 访问方式（仅大模型场景适用）

枚举：

  • Managed：使用阿里公共账号访问。
  • 非大模型场景则为空。
Managed
ChatConfigstring否

通话配置

  • silenceConfig ：静默配置
    • silenceReplyTimeout:静默回复超时时间，毫秒级
    • silenceTimeoutMaxCount：静默超时几轮后挂机。
    • silenceTimeoutMaxCountEnable：静默是否挂机
  • hangupConfig：挂机配置
    • aiHangupEnable：ai 挂机。true，false
    • delayHangup：延迟挂机 ，最大为 10
    • hangupMaxRounds：交互轮次：最大 100
    • hangupMaxRoundsBroadcast：挂机播报话术
    • hangupMaxRoundsEnable：最多交互轮次判断 true/false
  • securityInterceptConfig：安全拦截配置
    • broadcast：拦截播报话术
  • specialInterceptConfig：特色情况拦截
    • specialInterceptEnable：特殊情况拦截开关
    • specialIntercepts：特殊情况
      • voiceAssistant：语音助手
      • extensionNumberTransfer：分机号转接
  • transitionConfig：承接语模型配置
    • transitionSwitch：承接语模型开关
{"silenceConfig":{"silenceReplyTimeout":499,"silenceTimeoutMaxCount":10,"silenceTimeoutMaxCountEnable":true},"hangupConfig":{"aiHangupEnable":false,"delayHangup":0,"hangupMaxRounds":20,"hangupMaxRoundsBroadcast":"感谢您的接听，祝您生活愉快，再见!","hangupMaxRoundsEnable":false},"securityInterceptConfig":{"broadcast":"您说的这个问题我不能回答您，您可以尝试询问其他问题。"},"specialInterceptConfig":{"specialInterceptEnable":false,"specialIntercepts":[{"code":"voiceAssistant"},{"code":"extensionNumberTransfer"}]},"transitionConfig":{"transitionSwitch":false}}

返回参数

名称类型描述示例值
object
HttpStatusCodeinteger

HTTP 状态码

200
RequestIdstring

请求 ID

254EB995-DEDF-48A4-9101-9CA5B72FFBCC
Successboolean

是否成功

true
Codestring

接口状态

OK
Messagestring

响应信息

Success
Scriptobject

话术信息

Statusstring

话术状态

PUBLISHED
UpdateTimelong

更新时间

1578881227000
Industrystring

行业

政务
ScriptDescriptionstring

话术描述

返工回访话术
IsDraftedboolean

是否是草稿

true
DebugStatusstring

话术调试状态

DRAFTED
ScriptIdstring

话术 ID

c153d0d8-ba04-41c0-8632-453944c9dd0b
IsDebugDraftedboolean

是否是调试的草稿

true
ScriptNamestring

话术名字

回访话术
Scenestring

场景

回访

示例

正常返回示例

JSON格式

{
  "HttpStatusCode": 200,
  "RequestId": "254EB995-DEDF-48A4-9101-9CA5B72FFBCC",
  "Success": true,
  "Code": "OK",
  "Message": "Success",
  "Script": {
    "Status": "PUBLISHED",
    "UpdateTime": 1578881227000,
    "Industry": "政务",
    "ScriptDescription": "返工回访话术",
    "IsDrafted": true,
    "DebugStatus": "DRAFTED",
    "ScriptId": "c153d0d8-ba04-41c0-8632-453944c9dd0b",
    "IsDebugDrafted": true,
    "ScriptName": "回访话术",
    "Scene": "回访"
  }
}

错误码

HTTP status code错误码错误信息描述
400InvalidScriptName.DuplicatedThe specified ScriptName already exists.话术名称已经存在。请您更换一个名字。
404NotExist.InstanceThe specified Instance does not exist.指定的实例不存在。
404NotExist.ScriptThe specified Script does not exist.指定的话术不存在。
500InternalErrorAn error occurred while processing your request. Please try again later. Submit a ticket if the error still exists.内部错误。建议重试，如果多次重试报错请提交工单。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-08-06OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
2024-04-25OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
2022-06-21OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
上一篇：ModifyGlobalQuestion - 修改全局引用话术下一篇：ModifyScriptVoiceConfig - 修改话术配置