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