## 點擊外呼
>[info] **功能說明**
>在業務系統中,直接點擊客戶電話號碼,或者點擊按鈕,系統自動會撥打被叫電話,同時可以隱藏被叫號碼。
> 幫助坐席實現點擊外呼,提升呼叫效率。
> 同時也可以實現隱藏客戶號碼,話單表中記錄客戶信息等功能。
* **調用示例**
~~~
$fsapi = new Fsapi();
$res=$fsapi->apiCall('863000000','18600118300');
~~~
* **請求參數**
| 參數 | 是否必選 | 類型 | 描述 |
| --- | --- | --- | --- |
| ext | 是 | string | 分機號碼,即入網企業的SIP號碼 |
| phone | 是 | string | 被叫號碼,即客戶電話號碼 |
| customerId | 否 | string | 客戶ID |
| UID | 否 | string | 案件ID |
| relationID | 否 | string | 案件ID |
| callbackDomain | 否 | string | 回調地址,http或https開頭的完整url地址,通話結束后,系統會將本次通話結果,以post的方式提交到該地址。 回調數據包含:呼叫開始時間,呼叫結束時間,通話時長,錄音文件播放下載的URL,外呼透傳的號碼;客戶ID,案件ID,關系人ID,等數據。 |
>[danger] 提示:customerId,UID,relationID業務系統傳給CTI系統的參數,CTI系統并不使用該參數,僅記錄到話單及回調給業務系統。所以這三個參數,業務系統可以自由使用,如可以將customerId用作座席工號,用作座席ID等等,都是可以的,主要是回調給業務系統時,業務系統用于和自己的數據做匹配,如果不需要回調,這三個參數可以不用傳。
> 外呼時是否需要對座席的分機顯示隱藏被叫號碼,應登錄后臺,在:應用管理--入網企業中設置是否脫敏,如果脫敏則隱藏被叫號碼。
* **響應參數**
| 參數 | 類型 | 描述 |
| --- | --- | --- |
| status | string | 請求結果:success:成功。failure:失敗,注意,此處的成功僅僅表示系統收到了呼叫請求,因為通話是異步的,系統此時并不能知道外呼是否會成功,被叫是否會摘機,通話時長等數據,等本次通話結束后,本次通話的結果會記錄到話單表,如果有回調地址,也會實時回調。|
| callid | string | 本次通話的唯一編號。 |
| msg | string | 如果返回failure,對失敗原因的描述。|
* **響應示例**
```
{
"status": "success",
"callid": "49b98696-2451-437f-b1bd-abf29a6f8302",
"msg": ""
}
```