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