RobotCall - 发起机器人外呼

发起机器人外呼。支持根据配置好的机器人ID,即话术ID,通过外呼主叫号码呼叫被叫号码,可选择通话过程是否录音等功能。

接口说明

  • 此接口返回参数的 Data 为呼叫唯一 ID。
  • 呼叫的创建时间可从此接口调用后的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

外呼主叫号码。

0571****5678
CalledNumberstring

被叫号码。

131****2204
RobotIdlong

机器人 ID,即话术 ID。 您可以在智能联络中心控制台左侧导航栏的智能外呼机器人>话术管理中获取。

350000****
OutIdstring

预留给调用方使用的 ID。

最终会通过在回执消息中将此 ID 带回给调用方。字符串类型,长度为 1~15 个字节。

abcdefgh
RecordFlagboolean

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

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

是否启用号码状态(早媒体)识别标识。取值:

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

机器人的参数列表。JSON 格式。总长度不要超过 512 个字节。

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

返回参数

名称类型描述示例值
object

返回数据。

Messagestring

状态码的描述。

OK
RequestIdstring

请求 ID。

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

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

116012854210^10281427*****
Codestring

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

OK

示例

正常返回示例

JSON格式

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

错误码

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

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

变更历史

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