售前電話
135-3656-7657
售前電話 : 135-3656-7657
這里我們主要以的接口使用方法來說明。Action URL是話機(jī)將當(dāng)前的狀態(tài)上報(bào)給遠(yuǎn)端控制臺。Active URI是遠(yuǎn)端控制臺控制話機(jī)進(jìn)行各種操作。Action URL和Active URI主要應(yīng)用于CTI(Computer Telephony Intergration)場景中。話機(jī)上報(bào)自身狀態(tài)給PC,PC控制話機(jī)各種操作。典型的應(yīng)用場景,比如:呼叫中心。話務(wù)員在PC上通過CTI應(yīng)用軟件,操作話機(jī)。如果是呼叫中心系統(tǒng)或網(wǎng)絡(luò)電話系統(tǒng)的API接口請聯(lián)系我公司。
一、目標(biāo)受眾
1、Fanvil話機(jī)測試人員,話機(jī)管理員。2、基于Fanvil話機(jī)開發(fā)CTI應(yīng)用軟件的技術(shù)人員
術(shù)語表
CTI計(jì)算機(jī)電話技術(shù)集成(Computer Telephony Integration) 通過軟硬件接口及控制設(shè)備把電話通信和計(jì)算機(jī)信息處理集成在一起,實(shí)現(xiàn)對話音、傳真和數(shù)據(jù)通信的控制和綜合應(yīng)用
事件話機(jī)的狀態(tài)改變后觸發(fā)的一個消息
二、Action URL介紹
Action URL是在話機(jī)自身狀態(tài)發(fā)生變化時,話機(jī)向遠(yuǎn)端控制臺發(fā)起HTTP Get請求,將這一事件發(fā)送給遠(yuǎn)端控制臺,控制臺可以根據(jù)該狀態(tài)變化,進(jìn)行相應(yīng)的話機(jī)操作。
協(xié)議說明
Ative URL的 HTTP URL格式由控制臺的HTTP Server端來定義,話機(jī)只負(fù)責(zé)當(dāng)相應(yīng)狀態(tài)變化時發(fā)起HTTP Get請求。一般情形下,Active URL的HTTP URL格式為:“ /newcall.xml?num=$call_id”
“192.168.1.100” 遠(yuǎn)端控制臺的IP地址;
“newcall.xml?” 遠(yuǎn)端控制臺HTTP Server定義的各個狀態(tài)對應(yīng)的處理方法;
“$call_id” 話機(jī)內(nèi)部支持的變量,在發(fā)起HTTP Get請求前,系統(tǒng)會自動將該變量替換為系統(tǒng)當(dāng)前的真實(shí)值。內(nèi)部變量以“$”開頭。
Action URL配置
登陸話機(jī)的Web管理頁面,進(jìn)入Phone -> Feature -> Action URL Settings,在每一個事件對應(yīng)的輸入框中,輸入相應(yīng)的URL。比如:Incoming Call事件后,輸入 /newcall.xml?num=$call_id配置后有新來電,來電號碼為1234,話機(jī)會發(fā)起HTTP Get /newcall.xml?num=1(第幾路通話)
事件列表
事件名稱 事件說明
Setup Completed 話機(jī)啟動完成
Registration Succeeded 帳號注冊成功
Registration Disabled 帳號取消注冊
Registration Failed 帳號注冊失敗
Phone Off Hooked 摘機(jī)
Phone On Hooked 掛機(jī)
Incoming call 有新呼叫進(jìn)來
Outgoing call 呼出電話
Call established 通話建立
Call terminated 通話結(jié)束
DND Enabled DND開啟
DND Disabled DND關(guān)閉
Unconditional Call Forward Enabled 無條件前轉(zhuǎn)打開
Unconditional Call Forward Disabled 無條件前轉(zhuǎn)關(guān)閉
Call Forward on Busy Enabled 遇忙前轉(zhuǎn)打開
Call Forward on Busy Disabled 遇忙前轉(zhuǎn)關(guān)閉
Call Forward on No Answer Enabled 無應(yīng)答前轉(zhuǎn)打開
Call Forward on No Answer Disabled 無應(yīng)答前轉(zhuǎn)關(guān)閉
Call transfer 呼叫轉(zhuǎn)移
Unattended Call Transfer 呼叫盲轉(zhuǎn)
Attended Call Transfer 呼叫出席轉(zhuǎn)移
Call hold 呼叫保持
Call resume 取消呼叫保持
Mute 靜音開啟
Unmute 靜音關(guān)閉
Missed calls 有未接來電
IP Changed 更換話機(jī)ip
Idle To Busy 話機(jī)從待機(jī)到其他界面
Busy To Idle
話機(jī)從其他界面到待機(jī)
MWI 留言
SMS 短信
Start reboot 重啟
變量列表
變量名 變量說明
$mac 設(shè)備MAC地址
$ip 當(dāng)前可用IP地址
$model 話機(jī)型號
$firmware 軟件版本號
$active_url 當(dāng)前活動帳號的SIP URI(僅在呼入、呼出、通話中生效)
$active_user 當(dāng)前活動帳號的SIP URI的用戶帳號部分(僅在呼入、呼出、通話中生效)
$active_host 當(dāng)前活動帳號的SIP URI的服務(wù)器部分(僅在呼入、呼出、通話中生效)
$local
X3/4系列:本機(jī)的SIP URI(呼出時生效)
本機(jī)的號碼(呼入,未接時生效)
X6:本機(jī)的SIP URI(呼入,呼出,通話中生效)