## 座席外呼
>[info] **功能說明**
> 系統自動撥打被叫號碼，被叫號碼摘機后，系統自動播放錄制好的語音文件，播放完畢后系統掛機，播放完畢后也可以接收用戶電話按鍵。
> 語音文件可以是單個語音文件，也可以是多個語音文件拼接，多個語音文件使用符號“!”分割，如：1.wav!2.wav!3.wav，多系統會依次播放多個語音文件，用會員體驗是一段完整的語音。
> 撥打完畢后，回調通話結果，如：用戶是否接聽，用戶接聽時長等信息。
* **請求地址**
```
{base_url}/{api_version}/vocMessage
```
* **請求參數**
| 參數 | 是否必選 | 類型 | 描述 |
| --- | --- | --- | --- |
| phone | 是 | string | 被叫號碼 |
| vocFile | 是 | string | 語音文件，可以是一個語音文件，或者多個語音文件。 |
| demandDtmf | 是 | string | 是否要求用戶電話按鍵，y需要接收用戶電話按鍵，n不需要接收用戶電話按鍵。如果需要接收用戶電話按鍵，那么語音文件中需要有有引導用戶按鍵的語音提示，如：確認請按1，取消請按2.....。 |
| trunkName | 是 | 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": ""
}
```
