MVB2000融合通信平台-呼叫中心平台接口培训.ppt

1、MVB2000平台开发接口,青岛畅信达通信有限公司,MVB2000平台支持的接口,MVB2000 智能通信平台,IAX2协议 软电话控件,WEBCTI接口,MVBCT I控件,数据库及其它 接口,MVB2000平台支持的接口,IAX2协议 软电话控件,IAXOCX 是什么 ?,是基于微软activex技术的标准ocx控件，可以在任何支持OCX控件的编程语言中使用。 和其它数字话机或网关一样，IAXOCX是一个运行在电脑上，采用IAX2协议，没有界面的电话控件，可使用耳麦进行通话。 可用于浏览器、Delphi、VB、VC、PowerBuilder、CBuilder、C#等各类支持Activex控

2、件的编程环境。用户只绘制一个图形界面，调用控件的方法、响应控件的事件，即可开发出专业的、与自己项目无缝集成的软件电话终端,可使用耳麦进行通话。如Xlite、Zoiper等。,IAXOCX IAX2协议的软电话控件,MVB2000,WAN/LAN网络 UDP端口4569,用于windows系统。 用户可以免费使用，无任何功能限制，只在开发环境中弹出畅信达网页。 提供开发文档（MVBPHONE.HLP）。 向畅信达客户提供HTML、VB6、VC6、C#中使用IAXOCX控件的demo代码。 如需技术支持，另行收费。,UDP端口,简单易用，无需特殊安装 多线路、多帐户注册 呼叫转接 呼叫保持 语音信

3、箱状态通知 DTMF发送 电平指示 点对点拨号 GSM、G711A、G711U语音编码 主叫号码设置 来电号码显示 未注册拨号,支持明文和MD5验证 麦克音量控制 扬声器音量控制 在多路通话之间切换 登录、注销 音频设备设置 音频设备获取 使用单一UDP端口，防火墙穿透能力强。 您可以在支持Activx的各种开发工具中使用此控件，轻松定制您自己的软件电话或坐席软件。,IAXOCX IAX2协议的软电话控件特点,IAXOCX 代码示例,在浏览器中调用 在VB中调用 在VC中调用 在C#中调用,在浏览器中调用IACOCX,IAXOCX 浏览器代码示例, onRegistration(RegID,

4、Reply, msgCount, ReplyText); onStateEvents( CallNo, State, AudioFormat, VideoFormat, RemoteNumber, RemoteName, LocalNumber, LocalContext); , var is_initOk=false; function Init() try var retvalue; if (is_initOk) alert(Already inited!); return; retvalue=MVBPhone.InitIax(1); if (retvalue=0) is_initOk=t

5、rue; alert(init ok!); catch(e) return; ,拨号 function Dial() try if (!is_initOk) alert(Please init firstly!); else MVBPhone.Dial(dialnumber.value); catch(e) return; ,注册到平台 function Register() try if (!is_initOk) alert(Please init it!); MVBPhone.HostName=HostName.value; MVBPhone.Port=Port.value; MVBPho

6、ne.UserID=UserID.value; MVBPhone.Password=Password.value; MVBPhone.Register(); catch(e) return; ,在VB中调用IAXOCX,IAXOCX VB代码示例,初始化 Private Sub Form_Load() is_InitOk = False MVBphone1.InitIAX (1) MVBphone1.GetAudioDevice ShapeInput.Width = 0 ShapeOutput.Width = 0 VScrollMIC.Value = MVBphone1.GetMicVolum

7、e VScrollSPEAKER.Value = MVBphone1.GetSpeakerVolume MVBphone1.ApplyFilter 0, 0, 0, 0, 0 Check_AGC.Value = MVBphone1.GetFilterAGC Check_AAGC.Value = MVBphone1.GetFilterAAGC Check_CN.Value = MVBphone1.GetFilterCN Check_RN.Value = MVBphone1.GetFilterNoiseReduce Check_EC.Value = MVBphone1.GetFilterEchoC

8、ancel is_InitOk = True End Sub,拨号 Private Sub Command2_Click() Dim num As String num = callnumber.Text If (Len(num) 0) Then MVBphone1.Dial (num) last_dialout = num Else If (Len(last_dialout) 0) Then MVBphone1.Dial (last_dialout) End If End If End Sub,注册到平台 Private Sub Command8_Click() MVBphone1.Host

9、Name = 6 MVBphone1.Port = 4569 MVBphone1.UserID = 7101 MVBphone1.Password = 7101 MVBphone1.Codec = 4 GSM-2,G711U-4,G711A-8 MVBphone1.PhoneNumber = 7101 MVBphone1.Register End Sub,卸载 Private Sub Form_Unload(Cancel As Integer) MVBphone1.Shutdown End Sub,在VC中调用IAXOCX,IAXOCX VB代码示例,初始化 void C

10、Iaxphonevc6Dlg:OnInit() if (!m_initphone) m_mvbphone.SetHostName(_T(); m_mvbphone.SetPort(7569); m_mvbphone.SetUserID(_T(6201); m_mvbphone.SetPassword(_T(6201); m_mvbphone.SetCodec(2); m_mvbphone.InitIAX(1); m_initphone=true; ,卸载 void CIaxphonevc6Dlg:OnUnregister() m_mvbphone.UnRegister(); void CIax

11、phonevc6Dlg:OnShutdown() if (m_initphone) m_mvbphone.Shutdown(); ,注册到平台 void CIaxphonevc6Dlg:OnRegister() if (m_initphone) m_mvbphone.Register(); else AfxMessageBox(_T(请先开始服务!); ,拨号 void CIaxphonevc6Dlg:OnDial() UpdateData(true); if (!m_PhoneNumber.IsEmpty() m_mvbphone.Dial(m_PhoneNumber); else CWnd

12、* pwnd=GetDlgItem(IDC_NUM); pwnd-SetFocus(); AfxMessageBox(_T(请输入电话号码!); ,在C#中调用IAXOCX,IAXOCX C#代码示例,初始化 private void Form1_Load(object sender, EventArgs e) axMVBphone1.InitIAX(1); ,卸载 private void Form1_FormClosed(object sender, FormClosedEventArgs e) axMVBphone1.UnRegister(); axMVBphone1.Shutdown(

13、); ,注册到平台 private void button4_Click(object sender, EventArgs e) axMVBphone1.HostName = tb_host.Text; axMVBphone1.Port =Convert.ToInt32(tb_port.Text); axMVBphone1.UserID = tb_user.Text; axMVBphone1.Password = tb_pass.Text; axMVBphone1.Register(); ,拨号 private void button1_Click(object sender, EventAr

14、gs e) if (tb_number.Text.Length 0) axMVBphone1.Dial (tb_number.Text ); ,概念与术语,用户：待分配的电话号码。 设备：指物理存在的终端设备。通过电话线或网络连接到mvb2000平台。 分机：通常指分配了号码的终端设备。是用户和设备的结合。 绑定：为设备指定一个关联的用户（号码）。只有类型为“临时”的设备允许此操作。 分离：取消与设备关联的用户。是绑定的反操作。只有类型为“临时”的设备允许此操作。 拨号接口：指明与终端进行通信的协议和编号。如:SIP/7001,IAX2/6001,ZAP/2。“/”前的是协议类型，后面的是唯一

15、编号。 活动通道：活动通道用于唯一标识参与通话的通道。每路通话由2个活动通道组成，每个终端设备允许发起多路通话，每路通话都有自己独立的活动通道。转接、拆线等操作都以“活动通道”作为目标。如： IAX2/fax2-1807、SIP/627003-b7265460、SIP/-b77044b8等。 坐席：登录到队列上的设备。通常用设备的拨号接口标识。如SIP/7001,IAX2/6001等。 工号：与“用户”相同，登录到队列时设备所绑定的用户号作为坐席工作编号使用。 队列：用于自动分配呼叫、并提供等待排队功能的模块。以队列编号标识。每个坐席可以登录多个队列。队列可以包含固定坐席

16、（开机就存在，不能登出）和动态坐席。 会议：实现多方同时进行语音互动、并提供发言管理功能的模块。以会议编号标识，分动态建立和固定号码两种。,设备与用户关系,MVB2000默认配置将设备与用户设置为固定关联关系，因此不允许动态绑定和分离。 如果您的每个坐席工位都只有一个固定的坐席使用，则不需要进行设备与用户设置为分离操作，也不需要进行动态绑定和分离。只需要操作登入和登出队列即可。 如果您的坐席工位由多个坐席轮流使用，需要修改配置，将设备与用户设置为分离状态，然后使用CTI接口进行动态绑定和分离。 如何设置设备与用户分离： 在MVB2000设置-基本设置界面：选择“设备与分机分离”,提交后，刷新配

17、置。在左边的菜单列表中会出现设备和用户。 使用分离方式时，用户号和设备号最好不要重复。比如设备号使用5000号段，用户号使用6000号段。,MVB2000平台支持的接口,MVBCT I控件,CTI 是什么 ?,CTI技术是指计算机和通信技术的集成技术，它传统的定义是“计算机电话集成” (Computer Telephony Integration)，随着电信通信技术的发展， 现在有更多的人将之定义为“计算机电信集成”技术(Computer Telecommunication Integration)。 利用CTI技术座席可以通过管理界面对呼叫进行有效管理，实现上线、下线、示忙、示闲、转移呼叫、

18、强拆、点击拨号、来电弹屏、自动外呼等计算机与电信技术结合的功能。,MVBCTI 控件是什么 ?,基于微软activex技术的标准ocx控件，可以在任何支持OCX控件的编程语言中使用。如可用于浏览器、Delphi、VB、VC、PowerBuilder、CBuilder、C#等。 在一个控件中实现了CTI、IVR SERVER、FAX Client和DB Client四个接口。 使用CTI接口实现弹屏、点击拨号、监听、强插、会议、质检、上线、下线、示忙、示闲、拆线、转接，等功能并可以控制和监视MVB2000的运行。 使用FAX接口实现发送、群发、查看、删除、管理传真。 使用DB接口查询话单和各种状

19、态数据，更新数据库数据。 开发者可以使用MVBCTI控件的IVR SERVER接口在Windows平台上开发基于MVB2000的IVR和拨号计划，结 合数据库实现复杂的IVR应用。 开发者可以单独启动或终止其中的任何一个接口。控件提供完善的初始化和终止方法。 MVBCTI控件分普及版和专业版。普及版免费，专业版在开发环境需要授权。使用手册中带*的功能需要专业版支持。,MVBCTI 控件应用框图,Windows应用程序或浏览器,MVB2000 核心,数据库,TCP 5038端口连接,TCP,MVB2000平台,TCP 3306端口连接,CTI客户端,传真客户端,MySQL客户端,IVR服务器,传

20、真服务器,TCP 4573端口连接,TCP 4559端口连接,MVBCTI控件技术架构,4合1的ACTIVEX控件,MVBCTI 控件版本,MVBCTI.ocx 普及版 普及版为免费版本，可以在开发环境和运行环境免费使用。开发环境中初始化控件时会弹出我公司网页，但不影响使用。 MVBCTI.ocx 专业版 专业版在开发环境中使用需要购买授权。在运行环境使用不需要授权。 区别 CTI部分普及版和专业版事件数量和方法数量不同。普及版支持最基本的应用，如弹屏，点击拨号，拆线，获取变量，获取设备状态等。普及版不支持传真客户端和数据库客户端。IVR SERVER部分除并最大发数不同，普及版和专业版功能完

21、全一样。,MVBCTI 控件-设置开发环境,使用安装包安装完控件以后，在开发环境中将名称为：MVBCTI ActiveX Professional Edition或者MVBCTI ActiveX Free Edition的控件添加到控件工具箱，即可拖放到窗口界面使用。,MVBCTI 控件-CTI客户端,通过TCP5038端口与MVB2000连接。 实时接收MVB2000发送的各类事件，如拨号、挂机、登入队列、呼叫进入队列、呼叫分配到座席等事件后，在WINDOWS程序中触发事件，程序员只要在事件响应代码中填写少量代码即可实现来电弹屏、排队状态显示、队列状态显示、座席状态显示等功能。 通过调用控件

22、提供的方法，实现点击拨号、转接电话、座席上线下线、示忙示闲、驻留电话、代接电话、发起会议、获取队列和所有分机状态等功能。 与IAXOCX完全不同，CTI客户端实现对MVB2000进行监控、调度和管理的功能。,MVBCTI 控件-传真客户端,通过TCP4559端口与MVB2000连接。 通过传真客户端通过MVB2000发送传真。 管理MVB2000上的传真收件箱、发件箱。 开发者不需要关心传真协议的细节，使用几行代码就可以使自己的应用程序具备传真发送功能，并可在windows系统管理、查看MVB2000平台的传真文件。,MVBCTI 控件-MYSQL数据库客户端,通过TCP3306端口与MVB2

23、000连接。 无需安装MYSQL数据库客户端，使用控件提供的函数可以直接访问MySQL数据库，查询或更新MVB2000平台的接口数据库。 通过操作MVB2000的接口数据库实现短信发送和接收、批量自动外呼、计划任务管理、数据统计、查看呼叫状态和分机状态等信息。,MVBCTI 控件-IVR/AGI服务器,呼叫进入MVB2000平台后，平台通过TCP4573端口与IVR服务器建立连接。 IVR服务器接收到MVB2000的连接请求后建立新的线程，并根据业务需要查询数据库数据，控制MVB2000播放语音、接收用户按键。 使用控件的IVR服务器功能可以开发运行在windows系统的IVR服务。,MVB2

24、000支持IVR实现方式 在MVB2000的拨号脚本中运行，与核心直接交互的本地IVR(如客户应用)。 在MVB2000上通过STDIN和STDOUT实现的本地IVR(如PHP实现的AGI)。 运行在MVB2000之外的电脑上通过网络交互的远程IVR。,MVBCTI控件 代码示例,CTI客户端样例(以VB6为例) 传真客户端样例(以VB6为例) 数据库客户端样例(以VB6为例) IVR服务器样例(以VB6为例),CTI客户端样例(以VB6为例),初始化 MVBCTI1.CTI_HostName = 18 MVBCTI1.CTI_Port = 5038 MVBCTI1.CT

25、I_ThreadType = 1 Res=MVBCTI1.CTI_Init() If Res 0 Then MsgBox CTI Init Failed End If,登录 s_msg = MVBCTI1.CTI_Login(tapi, tapi, , , , ) res = MVBCTI1.CTI_GetResSuccess(s_msg) If res = 0 Then MsgBox CTI Login Failed + Chr(10) + Chr(13) + MVBCTI1.CTI_GetResResult(s_msg, Message) End If 使用方法：设置只接收与设备SIP/7

26、001有关的事件 s_msg = MVBCTI1. CTI_Filters(SIP/7001, ) res = MVBCTI1.CTI_GetResSuccess(s_msg) If res = 0 Then MsgBox MVBCTI1.CTI_GetResResult(s_msg, Message) End If,终止 MVBCTI1.CTI_Free Private Sub Form_Unload(Cancel As Integer) MVBCTI1.CTI_Free End Sub,响应事件 *直接拨打设备SIP/7001 Private Sub MVBCTI1_OnDial(ByVa

27、l id As Long, ByVal mvb_Source As String, ByVal MVB_Destination As String, ByVal MVB_Callerid As String, ByVal MVB_CalleridName As String, ByVal MVB_SrcUniqueID As String, ByVal MVB_DestUniqueID As String) s_dev = Left(MVB_Destination, Len(SIP/7001) If s_dev = SIP/7001 Then MsgBox Call from + MVB_Ca

28、llerid End If 通过队列呼叫设备SIP/7001 Private Sub MVBCTI1_OnAgentCalled(ByVal id As Long, ByVal MVB_QueueName As String, ByVal MVB_AgentCalled As String, ByVal MVB_AgentName As String, ByVal MVB_ChannelCalling As String, ByVal MVB_UniqueidCalling As String, ByVal MVB_Callerid As String, ByVal MVB_CalleridN

29、ame As String, ByVal mvb_context As String, ByVal mvb_extension As String, ByVal mvb_priority As String, ByVal mvb_channel As String, ByVal MVB_Uniqueid As String) s_dev1 = Left(MVB_AgentCalled, Len(SIP/7001) s_dev2 = Left(MVB_AgentCalled, Len(Local/7001) If s_dev = SIP/7001 Or s_dev2 = Local/7001 T

30、hen MsgBox Agent Call from + MVB_Callerid End If End Sub,传真客户端样例(以VB6为例),MVBCTI1.FAX_HostName = 18 MVBCTI1.FAX_Port = 4559 MVBCTI1.FAX_DebugLevel = 3 MVBCTI1.FAX_KillTime = 0 MVBCTI1.FAX_Init MVBCTI1.FAX_Login faxuser, MVBCTI1.FAX_Send 7033, d:fax000002256.tif, 0 MVBCTI1.Free,数据库客户端样例(以VB

31、6为例),MVBCTI1.DB_IP = 18 MVBCTI1.DB_Port = 3306 MVBCTI1.MySQL_Init res = MVBCTI1.MySQL_Connect(extradbuser_4fad, b592cc059576, mvb2000extra) if (res 0)MsgBox MVBCTI1.MySQL_GetErrorText MsgBox MVBCTI1.MySQL_SetCharSet(GBK) MVBCTI1.MySQL_SelectDB mvb2000cdrdb res = MVBCTI1.MySQL_Query(select

32、 * from cdr order by calldate desc limit 1,5, 0) res = MVBCTI1.MySQL_FetchRow() Do While (res 0) res = MVBCTI1.MySQL_FetchRow() For i = 1 To res Text2.Text = Text2.Text + Str(i) + + MVBCTI1.MySQL_GetFeild(i) + Chr(13) + Chr(10) Next Loop MVBCTI1.MySQL_FreeResult MVBCTI1.MySQL_Free,IVR服务器样例(以VB6为例),初

33、始化： MVBCTI1.FAGI_IP = MVBCTI1.FAGI_Port = 4573 MVBCTI1.FAGI_ThreadType = 1 Res=MVBCTI1.FAGI_Init(10) If Res 0 Then MsgBox FAGI Init Failed End If 终止 MVBCTI1.FAGI_Free Private Sub Form_Unload(Cancel As Integer) MVBCTI1. FAGI_Free End Sub,在MVB2000加入客户应用 名称：MVBCTITEST 内容： exten=s,1,DeadAGI(agi:/192.168

34、.0.120:4573/test.agi?mvbvar=ipxchina) exten=s,2,Hangup exten=h,1,Hangup test.agi?mvbvar=ipxchina 只是为了演示而设置，OnFAGINewCall事件产生后， 可以获取test.agi和mvbvar=ipxchina部分，开发人员可以据此调用不同的IVR处理流程。 然后在呼入路由里设置使用此客户应用。来电后MVB2000将呼叫送给20处理。MVBCTI控件运行在20上，来电后会触发OnFAGINewCall事件。,响应事件 *编写来电IVR流程。由于VB6不

35、支持多线程，此处代码只作为演示AGI的原理，只支持单路呼叫。要实现同时处理多路并发呼叫，应使用VC等开发工具，在OnFAGINewCall事件中为每个呼叫建立线程。 Private Sub MVBCTI1_OnFAGINewCall(ByVal id As Long, ByVal MVB_CallInfo As String, ByVal MVB_Network As String, ByVal MVB_NetworkScript As String, ByVal MVB_Request As String, ByVal mvb_channel As String, ByVal MVB_Lan

36、guage As String, ByVal MVB_Type As String, ByVal MVB_Uniqueid As String, ByVal MVB_Callerid As String, ByVal MVB_CalleridName As String, ByVal MVB_CallingPres As String, ByVal MVB_CallingANI2 As String, ByVal MVB_CallingTON As String, ByVal MVB_CallingTNS As String, ByVal MVB_DNID As String, ByVal M

37、VB_RDNIS As String, ByVal mvb_context As String, ByVal mvb_extension As String, ByVal mvb_priority As String, ByVal MVB_Enhanced As String, ByVal mvb_accountcode As String) 从数据头获取字段值 result = MVBCTI1.FAGI_GetResFeild(MVB_CallInfo, agi_callerid) result = MVBCTI1.FAGI_Wait(id, 2) 函数返回结果处理,根据情况调用一下函数解析

38、结果 result = MVBCTI1.FAGI_GetResMessage(result) result = MVBCTI1.FAGI_GetResAttribute(result, endpos) result = MVBCTI1.FAGI_GetResResult(result) result = MVBCTI1.FAGI_GetResStatus(result) 播放彩铃10秒 result = MVBCTI1.FAGI_WaitMusicOnHold(id, 10) 播报日期时间 result = MVBCTI1.FAGI_SayDateTime(id, 2010-07-30 12:

39、01:30, 123, YbdHMS, 12345) 播报日期 result = MVBCTI1.FAGI_SayDate(id, 2010-07-30, 12345) 播报余额 result = MVBCTI1.FAGI_SayBalance(id, 12.8, 12345) 拆线 result = MVBCTI1.FAGI_Hangup(id, ) End Sub,VB不支持多线程，此示例只做演示用，产品环境需使用支持多线程的编程语言。,MVBCTI控件 在C#中使用,MVBCTI控件 在Delphi中使用,MVBCTI 控件文档,MVBCTI_ActiveX_控件用户手册 mvbcti_

40、ocx_白皮书,MVB2000平台支持的接口,WEBCT I接口,WEBCTI 是什么 ?,随MVB2000平台一起发行，已经内置于平台的一套免费的CTI接口。 通过HTTPS或HTTP协议以GET方式访问。 不同的URL和参数对应不同的功能接口。 可以在浏览器中使用JavaScript访问该接口（要考虑跨域），实现来电弹屏、点击拨号、座席上下线、转接等功能。 可以使用XMLHttpRequest组件或者后台请求URL的方式进行接口调用。 可用于任何浏览器以及C#、delphi、java、VB、VC等编程语言。 与MVBCTI控件不同，WEBCTI由于采用http协议，调用者需要采取轮询的方式

41、获取平台的状态数据。,WEBCTI 接口技术架构,WEBCTI 认证方法,每次URL请求都必须传送webkey变量。 webkey使用mvb2000基本设置里的webkey字符串+当日日期（格式：yyyy-mm-dd）组成的字符串进行MD5运算，得到的结果作为webkey使用。结果应该全部以ascii码方式表示，使用小写字母。详见MEB2000_WEB开发接口使用方法或MVB2000_WEB开发接口,WEBCTI 接口调用,18/webservice/getcpuload.php?webkey=5589a16d0b48a49ce1c66c2ad11268c0,

42、root : row : createtime : 2010-05-14 10:40:08,infotype : cpuload,user : 10.77,system : 6.00,nice : 0.00,idle : 83.23,18/webservice/getcpuload.php?webkey=5589a16d0b48a49ce1c66c2ad11268c0 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url); request.UnsafeAuthenticatedConne

43、ctionSharing = true; request.Method = GET; request.Timeout = 5000; try HttpWebResponse response = (HttpWebResponse)request.GetResponse(); StreamReader sr = new StreamReader(response.GetResponseStream(), System.Text.Encoding.GetEncoding(gb2312); String retXml = sr.ReadToEnd(); sr.Close(); doc.LoadXml

44、(retXml); response.Close(); catch (Exception exc) System.Diagnostics.Debug.WriteLine(exc.StackTrace); MessageBox.Show(exc.Message); return doc; /*解析xml数据*/ private string get_xmlvalue( XmlNode Node,string feild) XmlNode xn = Node.SelectSingleNode(feild); if (xn = null | xn.FirstChild =null) return ; else return xn.FirstChild.Value; ,WEBCTI 调用样例(PHP),$WEBCTI=new MVB2000_WEBCTI(); $w