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