这里我们主要以的接口使用方法来说明。Action URL是话机将当前的状态上报给远端控制台。Active URI是远端控制台控制话机进行各种操作。Action URL和Active URI主要应用于CTI（Computer Telephony Intergration）场景中。话机上报自身状态给PC，PC控制话机各种操作。典型的应用场景，比如：呼叫中心。话务员在PC上通过CTI应用软件，操作话机。如果是呼叫中心系统或网络电话系统的API接口请联系我公司。

一、目标受众

1、Fanvil话机测试人员，话机管理员。2、基于Fanvil话机开发CTI应用软件的技术人员

术语表

CTI计算机电话技术集成（Computer Telephony Integration）      通过软硬件接口及控制设备把电话通信和计算机信息处理集成在一起,实现对话音、传真和数据通信的控制和综合应用

事件话机的状态改变后触发的一个消息

二、Action URL介绍

Action URL是在话机自身状态发生变化时，话机向远端控制台发起HTTP Get请求，将这一事件发送给远端控制台，控制台可以根据该状态变化，进行相应的话机操作。

协议说明

Ative URL的 HTTP URL格式由控制台的HTTP Server端来定义，话机只负责当相应状态变化时发起HTTP Get请求。一般情形下，Active URL的HTTP URL格式为：“ /newcall.xml?num=$call_id”

“192.168.1.100” 远端控制台的IP地址；

“newcall.xml?”  远端控制台HTTP Server定义的各个状态对应的处理方法；

“$call_id” 话机内部支持的变量，在发起HTTP Get请求前，系统会自动将该变量替换为系统当前的真实值。内部变量以“$”开头。

Action URL配置

登陆话机的Web管理页面，进入Phone -> Feature -> Action URL Settings，在每一个事件对应的输入框中，输入相应的URL。比如：Incoming Call事件后，输入 /newcall.xml?num=$call_id配置后有新来电，来电号码为1234，话机会发起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（呼入，呼出，通话中生效）