发起呼叫

通过本接口可以发起不同类型的呼叫。

通过该接口可以实现以下类型的呼叫：

  • 分机呼叫

    呼叫对象包括：分机、IVR、响铃组、队列、广播组（实时广播）、会议室、外部号码。

  • IVR 外呼：IVR 作为主叫，呼叫外部号码。
  • 响铃组外呼：响铃组作为主叫，呼叫外部号码。
  • 队列外呼：队列作为主叫，呼叫外部号码。
  • 外线外呼：外部号码作为主叫，呼叫另外一个外部号码。

请求地址

{base_url}/{api_path}/call/dial?token={token}

请求参数

参数 是否必选 类型 描述
caller 是 Integer 主叫号码。
callee 是 Integer 被叫号码。
注： 被叫号码为外部号码时，需匹配呼出路由规则。
dialpermission 否 String 设置使用哪个分机号的权限呼出外线号码。
注：
  • 当 caller 为分机号码时，无需设置 dialpermission 。可直接使用分机权限呼出。
  • 当 caller 不是分机号码时（例如响铃组或队列），必须设置 dialpermission 为具备外呼权限的分机号码，借助分机的权限呼出外部号码。
autoanswer 否 String 当 caller 为分机号码时，可以通过本项控制话机自动应答。即话机无需响铃，自动接听电话。
注： 该功能仅在 SIP 话机支持的情况下可用。
取值范围：
  • yes：启用自动应答。
  • no：禁用自动应答。

默认值：no。

响应参数

参数 类型 描述
status String 请求结果。
  • Success：成功。
  • Failed：失败。
callid String 每个通话的唯一 ID。

示例

请求示例

分机 1023 呼叫分机 2000。

POST /api/v2.0.0/call/dial?token=55e169f41421df602d41a08c441bc948 HTTP/1.1
Content-Type:application/json; charset=utf-8
Host: 192.168.5.150

{
	"caller": "1023",
	"callee": "2000",
	"autoanswer": "no"
}

响应示例 

HTTP/1.1 200 OK
Server: Boa/0.94.14rc21
Accept-Ranges: bytes
Connection: close
Content-Type: application/json
Access-control-allow-origin: *
Access-control-allow-methods: GET, POST, OPTIONS, PUT, DELETE

{
	"status": "Success",
	"callid": "1571620483.18"
}