## 座席外呼
>[info] **功能说明**
>在业务系统中，直接点击客户电话号码，或者点击按钮，系统自动会拨打被叫电话，同时可以隐藏被叫号码。
> 帮助坐席实现点击外呼，提升呼叫效率。
> 同时也可以实现隐藏客户号码，话单表中记录客户信息等功能。
* **请求地址**
```
{base_url}/{api_version}/callout
```
* **请求参数**
| 参数 | 是否必选 | 类型 | 描述 |
| --- | --- | --- | --- |
| ext | 是 | string | 分机号码 |
| phone | 是 | string | 被叫号码 |
| customerNum | 否 | string | 客户编号。 |
| trunkName | 否 | string | 中继名称，如果服务器上接入了多个运营商的中继，可以选择使用哪个运营商的中继线路拨打电话。 |
| trunkNumber | 否 | string | 出局号码，即透传号码，但改功能必须运营商支持透传号码才能生效。 |
| hide | 否 | string | 是否对座席隐藏被叫号码，y隐藏，n不隐藏，默认为n。 |
| agentNum | 否 | string | 座席工号。 |
| agentName | 否 | string | 座席姓名。 |
| groupNum | 否 | string | 座席组号。 |
| data | 否 | string | json字符串格式，本次通话的客户数据，如客户ID,案件ID等等，在通话完毕回调时会原样回调。 |
| logFileName | 否 | string | 日志文件名，通话结束后，服务器可以将话单记录为日志文件，开发人员可以去消费日志进行统计分析。 |
| callbackDomain | 否 | string | 回调地址，http或https开头的完整url地址，通话结束后，系统会将本次通话结果，包括data数据，以post的方式提交到该地址。 |
* **响应参数**
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| status | string | 请求结果：success：成功。failed：失败，注意，此处的成功仅仅表示系统收到了呼叫请求，因为通话是异步的，系统此时并不能知道外呼是否会成功，被叫是否会摘机，通话时长等数据，等本次通话结束后，本次通话的结果会实时回调的。|
| callid | string | 本次通话的唯一编号，业务系统可以记录该值，可以通过该编号调用其他接口，进行录音查询，话单信息查询等操作（无需记录也可以，获取本次通话的话单信息有多种方式，见“获取话单”文件介绍）。 |
| msg | string | 如果返回failed，对失败原因的描述。|
* **响应示例**
```
{
"status": "success",
"callid": "49b98696-2451-437f-b1bd-abf29a6f8302",
"msg": ""
}
```
