发起呼叫
通过本接口可以发起不同类型的呼叫。
通过该接口可以实现以下类型的呼叫:
- 分机呼叫
呼叫对象包括:分机、IVR、响铃组、队列、广播组(实时广播)、会议室、外部号码。
- IVR 外呼:IVR 作为主叫,呼叫外部号码。
- 响铃组外呼:响铃组作为主叫,呼叫外部号码。
- 队列外呼:队列作为主叫,呼叫外部号码。
- 外线外呼:外部号码作为主叫,呼叫另外一个外部号码。
请求地址
{base_url}/{api_path}/call/dial?token={token}
请求参数
参数 | 是否必选 | 类型 | 描述 |
---|---|---|---|
caller | 是 | Integer | 主叫号码。 |
callee | 是 | Integer | 被叫号码。 注: 被叫号码为外部号码时,需匹配呼出路由规则。 |
dialpermission | 否 | String | 设置使用哪个分机号的权限呼出外线号码。 注:
|
autoanswer | 否 | String | 当 caller
为分机号码时,可以通过本项控制话机自动应答。即话机无需响铃,自动接听电话。注: 该功能仅在 SIP
话机支持的情况下可用。 取值范围:
默认值:no。 |
响应参数
参数 | 类型 | 描述 |
---|---|---|
status | String | 请求结果。
|
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" }