🔥码云GVP开源项目 12k star Uniapp+ElementUI 功能强大 支持多语言、二开方便! 广告
## 点击外呼 >[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": "" } ```