## 系統回調
>[info] **功能說明**
> 業務系統可以根據話單(即通話記錄)制作各種統計報表,如座席工作量,電話接通率,計費,錄音文件及通話記錄綁定客戶,錄音文件及通話記錄綁定案件等。
> 話單可以通過以下形式獲取到;
> 1:接收CTI平臺的http回調(業務系統需要提供接收回調的http或https接口);
> 2:通過callid查詢(點擊外呼時會返回callid);
> 3:消費redis消息;
> 4:消費cdr日志文件;
> 5:查詢CTI系統數據庫(mysql);
* **回調請求地址**
```
提示:是CTI平臺POST請求callbackDomain這個URL地址,所以需要保證callbackDomain真實有效。
```
* **提交數據**
CTI平臺向callbackDomain提交的數據為json字符串格式,參數如下:
| 參數 | 類型 | 描述 |
| --- | --- | --- |
| callid | string | 本次通話的唯一uuid。|
| start_stamp | datetime | 通話開始時間。 |
| answer_stamp | datetime | 被叫應答時間。|
| end_stamp | datetime | 通話結束時間。|
| billsec | int | 呼叫時長。|
| ring_duration | int | 座席分機振鈴時長,呼入或API外呼有效(API外呼是系統撥打座席分機,分機振鈴,座席摘機,系統才撥打外線號碼)。|
| ext_duration | int | 座席分機通話時長。|
| callfrom | string | 主叫號碼。|
| callto | string | 被叫號碼。|
| type | string | 呼叫方向:inbound,outbound。|
| callroter | string | 表示本次呼叫是哪里發起的呼叫,如:API外呼,使用話機直接撥號,語音通知(api,dial,voc,auto)。|
| hangup_cause | string | 掛機原因。|
| recording | string | 錄音文件名。|
| trunk_name | string | 本次通話使用的中繼 |
| hangup_firstin | string | 座席和外線誰先掛機(agent/customer)。|
| rtp_use_codec | string | 本次通話使用的語音編碼,如G711,G729等。|
| data | obj | json對象,該值是API外呼或者語音通知提交的data參數值,原樣回調,方便開發者與業務數據匹配或者制作統計報表。|
* **響應參數**
| 參數 | 類型 | 描述 |
| --- | --- | --- |
| status | string | 請求結果:success:成功。failed:失敗。|
>[warning] **提示**
> 響應參數沒有格式要求,但響應參數會記錄到數據庫話單表中,長度不能超過200個字符。
* **響應示例**
```
{
"status": "success"
}
```