## 座席外呼
>[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": ""
}
```
