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