调用LlmSmartCall发起大模型智能外呼-智能联络中心-阿里云-智能联络中心(AICCS)-阿里云帮助中心

基于大模型的智能外呼。

接口说明

调用一次接口仅支持添加一个被叫号码。如果有多个被叫号码，可以多次调用。
在基于大模型发起智能呼叫之前，请确保您在大模型应用管理界面已创建大模型应用；在语音服务真实号管理界面已有申请成功的真实号码。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

aiccs:LlmSmartCall

none

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
CalledNumber	string	是	接收智能外呼的被叫号码。	137****0000
CallerNumber	string	否	主叫号码，为必填参数，仅支持中国内地号码。请前往语音服务真实号管理界面查看号码。说明若您使用的是自带线路，则需要传自带线路号码。	132****2054
ApplicationCode	string	是	大模型应用编码。在大模型应用管理界面查看。	F32******
StartWordParam	object	否	开场白变量。请前往大模型应用管理界面单击详情查看您创建的大模型开场白变量。	{ "name": "小明", "address": "浙江省杭州市" }
PromptParam	object	否	Prompt 提示词变量。请前往大模型应用管理界面单击详情查看您创建的 Prompt 提示词变量。	{ "style": "温柔" }
OutId	string	否	预留给调用方使用的 ID，最终会通过回执消息将此 ID 带回给调用方，同时大模型网关请求客户模型时会将此参数带给客户模型，长度为 1~15 个字节。	222356****
BizParam	object	否	自定义业务参数，客户调用此接口时可以将自定义参数传递给大模型网关，大模型网关请求客户模型时会将此参数带给客户模型。百炼工作流应用地址：参数传递。如：`biz_params = {"city": "杭州"}` 百炼智能体应用地址：传递自定义参数。如： `biz_params = { "user_prompt_params": "{\"city\":\"北京\"}" }`	biz_params = { "user_prompt_params": "{\"city\":\"北京\"}" }
Extension	string	否	X 号码的分机号码，不超过 5 位。重要仅在 AXN 分机号模式下需要填写，如果不存在分机号，请务必不要填写。	123
SessionTimeout	integer	否	最大通话时长，超时后自动挂断。单位：秒。说明最大取值：3600s。最小取值：600s。	1200
TtsVoiceCode	string	否	TTS 播放时的音色编码。说明不设置值时，默认取大模型应用配置的音色编码。支持通过 ListAvailableTts 接口查看全部音色编码。	V65******
TtsSpeed	integer	否	TTS 播放时的声音速度。说明取值范围：-200~200，默认值为 0。不设置值时，默认取大模型应用配置的声音速度。	50
TtsVolume	integer	否	TTS 播放的音量。说明取值范围：0~100，默认值为 0。不设置值时，默认取大模型应用配置的音量。	10
CustomerLineCode	string	否	用户自带线路编码。说明如果需要使用自带线路，请联系运营开通此功能；自带线路审核通过后会返回线路编码，若无，请不要设置值。	SELF_xxxxx_A_NET

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	D6A51251-F7C4-596A-9F45-3C3219A5450D
Code	string	请求状态码。返回 OK 代表请求成功。	OK
Message	string	状态码的描述。	OK
CallId	string	此次通话的唯一回执 ID。	125165515*^11195613**

示例

正常返回示例

JSON格式

{
  "RequestId": "D6A51251-F7C4-596A-9F45-3C3219A5450D",
  "Code": "OK",
  "Message": "OK",
  "CallId": "125165515***^11195613****"
}

错误码

HTTP status code	错误码	错误信息	描述
400	ModelStatus.Invalid	Model state invalid.	模型状态无效。
400	MissingParameter.CallerNumber	Parameter "CallerNumber" which is mandatory for the request is not provided.	没有提供请求必须的参数“CallerNumber”。
400	InvalidParameter.ApplicationCode	The specified parameter "ApplicationCode" is invalid.	参数ApplicationCode无效。
400	ModelNotExist	The model does not exist.	模型不存在。

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

变更历史

更多信息，参考变更详情。