StartPredictiveCall_云联络中心_API文档-阿里云OpenAPI开发者门户

接口说明

云呼叫中心除了支持客服从坐席工作台发起外呼外，还支持从自有业务系统后台发起外呼，待接通后转给坐席。以支持把云呼叫中心功能无缝嵌入您的业务流程。比如，您的客户可以在您的微信公众号上，输入自己的号码，并点击咨询产品的按钮，由您的后台系统调用本接口，实现呼叫客户手机，接通后播放“我们收到您在公众号上对我们产品的咨询，现在给您转接顾问，请稍等”，并转给合适的客服接听通话。相较于 1.0 的 DialEX 接口，用户使用该接口可以更加灵活的进行配置。除了可以自定义外呼转入的 IVR 外，还可以传入自定义的参数，在 IVR 中对参数进行语音播报，实现通知的场景。

流控信息

请求速率为1100/1(s)。更多流控信息，请前往配额中心查看

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称	字段详情
InstanceIdstring	实例 ID。示例值:ccc-test参考取值来源: ListInstances
Callerstring	主叫号码，需要是实例下可用的外呼号码。示例值:0109810****
Calleestring	被叫号码。示例值:1312353****
TimeoutSecondsinteger<int32>	超时时间，呼叫在经过该参数指定的时间仍然未接通的情况下，则主动挂断，单位秒。示例值:10取值 <= 3600
ContactFlowIdstring	IVR 联系流 ID，被叫接通后，通话将自动转入此 IVR 流程。示例值:9774c36c-12fe-4e37-adce-89bc77ce****参考取值来源: ListContactFlows
Tagsstring	随路数据，主要用于扩展需求，普通用户无需关心。示例值:无参考取值来源: ListCallTags
ContactFlowVariablesstring	传入的联系流变量，格式为 JSON 数组的字符串，数组元素是一个键值对，Key 为变量名，Value 为变量值。在联系流 ID 对应的 IVR 的开始节点中新建同名的自定义参数，即可在 IVR 流程中使用该参数。示例值:{"name":"王先生","time":"19点20分","address":"某某中心"}
MaskedCalleestring	脱敏后的被叫号码，如果该字段不为空，表示需要对被叫号码脱敏，脱敏规则由客户自行定义，只需将脱敏后的被叫号码填入即可，使用脱敏被叫会导致某些场景下看到的是脱敏后的被叫号码，无法查看真实被叫号码。示例值:1312353****
SkillGroupIdstring	技能组 ID，非必填，如果该参数有值，则外呼号码仅从该参数指定的技能组的关联号码中选取。示例值:skillgroup@ccc-test参考取值来源: ListSkillGroups CreateSkillGroup SignInGroup AddUsersToSkillGroup

返回参数

字段名称	字段详情
Codestring	响应码。示例值:OK
HttpStatusCodeinteger<int32>	HTTP 状态码。示例值:200
Messagestring	响应信息。示例值:无
RequestIdstring	请求 ID。示例值:26A34338-5CD9-4C95-A7A6-5BDCE76C6B94
Paramsarray<string>	响应参数列表。
Dataobject	数据。

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	Parameter.Blank	The parameter %s may not be null or blank.	诊断
404	NotExists.Number	The specified number %s does not exist in instance %s.	诊断
404	NotExists.InstanceId	The specified instance %s does not exist.	诊断

变更历史

	变更时间	变更内容概要	操作
	2021-11-29	新增请求参数SkillGroupId
	2021-08-20	新增OpenAPI，发起预测式外呼