RobotCall - 智能联络机器人呼出

发起智能联络机器人呼出。

接口说明

  • 在发起智能联络机器人呼出之前,请先确保您在话术管理界面已有审核通过的话术;在语音服务真实号管理界面已有申请成功的真实号码。

  • 呼叫的创建时间可从此接口调用后的Response Header中的 date 参数获取。

说明 例如,date 参数为:"date": "Mon, 24 Jun 2024 03:40:31 GMT",则呼叫的创建时间为:"2024-06-24 03:40:31"。

QPS 限制

  • 单用户调用频率:不限流。
  • API 频率:1000 次/秒。
说明 如果多个用户的总调用超过 API 频率也会触发流控。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
CalledShowNumberstring

呼出主叫号码。在语音服务真实号管理界面查看。

132****0849
CalledNumberstring

被叫号码。

131****2204
RobotIdlong

机器人 ID,即话术 ID。在话术管理界面查看审核通过的话术 ID。

1000035******
OutIdstring

预留给调用方使用的 ID,最终会通过回执消息将此 ID 带回给调用方,长度为 1~15 个字节。

222356****
RecordFlagboolean

通话过程是否录音。取值:

  • false(默认值):不录音。
  • true:录音。
true
EarlyMediaAsrboolean

是否启用号码状态识别标识。取值:

  • false(默认值):不启用。
  • true:启用。
说明 启用后会记录通话未接听的原因。
false
Paramsstring

机器人的参数列表。JSON 格式。总长度不要超过 512 个字节。在话术管理>详情>输出输入参数中查看或通过 ListRobotParams 接口查看。

{ "name": "张三", "age": "25" }

返回参数

名称类型描述示例值
object

返回数据。

Messagestring

状态码的描述。

OK
RequestIdstring

请求 ID。

A90E4451-FED7-49D2-87C8-00700A8C4D0D
Datastring

此次通话的唯一回执 ID,即呼叫唯一 ID。

1160128*****^10281427*****
Codestring

请求状态码。返回 OK 代表请求成功。

OK

示例

正常返回示例

JSON格式

{
  "Message": "OK",
  "RequestId": "A90E4451-FED7-49D2-87C8-00700A8C4D0D",
  "Data": "1160128*****^10281427*****",
  "Code": "OK"
}

错误码

HTTP status code错误码错误信息描述
400Permission.NotAuthorizedInsufficient permissions. Please contact the primary account administrator.权限不足,请联系主账号管理员
400Parameter.ErrorParameter error.参数错误

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

变更历史

变更时间变更内容概要操作
2021-05-19新增 OpenAPI查看变更详情