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