华为交换机中间件开发手册——实用版.doc

资源描述

属性名称含义默认值特性 AgentID 坐席工号 0 Initial之前设置生效 MainCTIIP 平台IP “” Initial之前设置生效 BackCTIIP 平台备机IP “” Initial之前设置生效 DN 坐席分机号码 “” Initial之前设置生效 AutoAnswer 自动应答 1 设置之后，下一通电话生效 ServiceList 技能组 “” Initial之前设置生效 AutoEnterIdle 是否自动进入空闲态 0 设置之后，下一通电话生效 OtherWorkTimeOut 挂机后进入空闲态间隔 15000 只有AutoEnterIdle为1，该值才生效，设置之后，下一通电话生效方法初始化功能设置控件的相关属性。一般在页面加载的时候调用。原型 LONG Initial(void) 参数参数参数说明无返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流无发起方失败事件流无对方事件流无反初始化功能反初始化。一般在页面关闭的时候设置。原型 LONG UnInitial(void) 参数参数参数说明无返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流无发起方失败事件流无对方事件流无签入功能坐席登录CTI平台。原型 LONG SignIn(void) 参数参数参数说明无返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流事件描述 OnSignInSuccess(LONG MediaServerType) MediaServerType 为1代表CTI Server 发起方失败事件流事件描述 OnSignInFailure(LONG MediaServerType) MediaServerType 为1代表CTI Server 对方事件流无签出功能坐席退出呼叫中心平台。原型 LONG SignOut (void) 参数参数参数说明无返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流事件描述 OnSignOutSuccess(LONG MediaServerType) MediaServerType 为1代表CTI Server 发起方失败事件流事件描述 OnSignOutFailure(LONG MediaServerType) MediaServerType 为1代表CTI Server 对方事件流无呼叫进入、录音（事件）功能有呼叫（内线、外线、咨询、通话转移）进入。振铃事件描述 OnAnswerRequest(CallID, CallType, MediaType) CallID：呼叫标识 CallType：0代表客户呼叫，1代表内部呼叫，2代表咨询呼叫，3代表通话转移呼叫 MediaType：5，代表语音媒体久不应答事件描述 OnLongNoAnswer( CallerNo, BeginTime, EndTime) CallerNo：客户号码 BeginTime：开始振铃时间 EndTime：结束振铃时间录音事件描述 OnBeginRecordSuccess(FileName) FileName：录音文件名称应答功能应答内线呼叫、外线呼叫、咨询呼叫、通话转移呼叫。原型 LONG Answer(LONG MediaType) 参数参数参数说明 MediaType 为1，代表语音媒体返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）操作方成功事件流事件描述 OnAnswerSuccess( MediaType ) MediaType：5，代表语音媒体操作方失败事件流事件描述 OnAnswerFailure( MediaType ) MediaType：5，代表语音媒体对端坐席事件流无挂断功能坐席挂断当前呼叫。原型 Hangup(LONG MediaType) 参数参数参数说明 MediaType 为1，代表语音媒体返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）操作方成功事件流事件描述 OnHangupSuccess( Party, MediaType ) Party：0代表客户挂断，1代表坐席挂断，2代表被咨询方挂断 MediaType：5，代表语音媒体操作方失败事件流（内线呼叫）事件描述 OnHangupFailure( Party, MediaType ) Party：0代表客户挂断，1代表坐席挂断，2代表被咨询方挂断 MediaType：5，代表语音媒体对端坐席事件流无外呼功能发起呼叫。原型 MakeCall( Dest, ANI, Type, MediaType) 参数参数参数说明 Dest 需要外呼的号码（如果为内线，则为坐席的分机号码） ANI 发起呼叫方的电话号码，一般为发起操作的坐席的分机号码 Type 0，代表外部呼叫 1，代表内部呼叫 MediaType 为1，代表语音媒体返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）操作方成功事件流对端振铃并应答成功事件流描述 OnMakeCallSuccess( CallID, MediaType ) CallID：呼叫标识 MediaType：5，代表语音媒体 OnMakeCallTalkSuccess( MediaType ) MediaType：5，代表语音媒体对端振铃但没有应答成功事件流描述 OnMakeCallSuccess( CallID, MediaType ) CallID：呼叫标识 MediaType：5，代表语音媒体 OnMakeCallFailure ( MediaType ) MediaType：5，代表语音媒体操作方失败事件流事件流描述 OnMakeCallFailure( MediaType ) MediaType：5，代表语音媒体对方事件流（内线呼叫）坐席振铃事件流描述 OnAnswerRequest(CallID, CallType, MediaType) CallID：呼叫标识 CallType：1代表内部呼叫 MediaType：5，代表语音媒体坐席振铃未应答事件流描述 OnAnswerRequest(CallID, CallType, MediaType) CallID：呼叫标识 CallType：1代表内部呼叫 MediaType：5，代表语音媒体 OnLongNoAnswer( CallerNo, BeginTime, EndTime) CallerNo：客户号码 BeginTime：振铃开始时间 EndTime：结束振铃时间二次拨号功能拨通总机之后，拨打分机。原型 SendDTMF( DTMFDigits ) 参数参数参数说明 DTMFDigits 需要发送的分机号码返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流无发起方失败事件流无对方事件流无咨询功能发起咨询，包括坐席、外线。原型 Consult( ConsultNum, ConsultType, MediaType ) 参数参数参数说明 ConsultNum 需要咨询的坐席分机号码、外线号码或技能组描述 ConsultType 0，外线 1，内线 2，技能组 MediaType 5，代表语音媒体返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流对端振铃并应答成功事件流描述 OnConsultSuccess ( CallID, MediaType ) CallID：呼叫标识 MediaType：5，代表语音媒体 OnConsultTalkSuccess ( MediaType ) MediaType：5，代表语音媒体对端振铃但没有应答成功事件流描述 OnConsultSuccess ( CallID, MediaType ) CallID：呼叫标识 MediaType：5，代表语音媒体 OnConsultFailure 没有问题，就是这样 ( MediaType ) MediaType：5，代表语音媒体操作方失败事件流事件流描述 OnConsultFailure(LONG MediaType) MediaType：5，代表语音媒体被咨询方事件流（坐席）振铃事件流描述 OnAnswerRequest(CallID, CallType, MediaType) CallID：呼叫标识 CallType：1代表内部呼叫 MediaType：5，代表语音媒体坐席振铃未应答事件流描述 OnAnswerRequest(CallID, CallType, MediaType) CallID：呼叫标识 CallType：2代表咨询呼叫 MediaType：5，代表语音媒体 OnLongNoAnswer( CallerNo, BeginTime, EndTime) CallerNo：发起咨询方号码 BeginTime：振铃开始时间 EndTime：结束振铃时间咨询转移功能将客户电话转移到被咨询方。原型 Transfer( MediaType ) 参数参数参数说明 MediaType 5，代表语音媒体返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流事件流描述 OnTransferSuccess 发起方失败事件流事件流描述 OnTransferFailure 对方事件流无通话转移功能将当前电话直接转移到目标方原型 SingleStepTransfer( TransferNum, TransferType, MediaType) 参数参数参数说明 TransferNum 转移的内线号码、外线号码、技能组、IVR号码 TransferType 0，内线 1，外线 2，技能组 3， IVR MediaType 5，代表语音媒体返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流事件流描述 OnSingleStepTransSuccess( MediaType ) 5，代表语音媒体 OnHangupSuccess( Party, MediaType) Party：Party：0代表客户挂断，1代表坐席挂断，2代表被咨询方挂断 MediaType：5，代表语音媒体发起方失败事件流事件流描述 OnSingleStepTransFailure(MediaType) 5，代表语音媒体被转移方事件流（转移坐席）振铃事件流描述 OnAnswerRequest(CallID, CallType, MediaType) CallID：呼叫标识 CallType：3代表通话转移呼叫 MediaType：5，代表语音媒体坐席振铃未应答事件流描述 OnAnswerRequest(CallID, CallType, MediaType) CallID：呼叫标识 CallType：3代表通话转移呼叫 MediaType：5，代表语音媒体 OnLongNoAnswer( CallerNo, BeginTime, EndTime) CallerNo：发起咨询方号码 BeginTime：振铃开始时间 EndTime：结束振铃时间强制签出功能将坐席强制退出平台原型 ForceOut(LONG AgentID) 参数参数参数说明 AgentID 坐席工号返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流事件流描述 OnForceOutSuccess 发起方失败事件流事件流描述 OnForceOutFailure 对方事件流事件流描述 OnForceOut 强插功能强插。原型 Insert(LONG AgentID, LONG MediaType) 参数参数参数说明 AgentID 坐席工号 MediaType MediaType：5，代表语音媒体返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流事件流描述 OnInsertSuccess( MediaType ) MediaType：5，代表语音媒体发起方失败事件流事件流描述 OnInsertFailure( MediaType) MediaType：5，代表语音媒体对方事件流无强拆功能强制拆除坐席的话路。原型 Break(LONG AgentID, LONG MediaType) 参数参数参数说明 AgentID 坐席工号 MediaType MediaType：5，代表语音媒体返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流无发起方失败事件流无对方事件流无监听功能监听坐席和客户的通话原型 Listen(LONG AgentID, LONG MediaType) 参数参数参数说明 AgentID 坐席工号 MediaType MediaType：5，代表语音媒体返回值返回值返回值说明 0 成功其他失败（使用GetPromptByErrorCode获取错误描述）发起方成功事件流事件流描述 OnListenSuccess没有问题 ( MediaType ) MediaType：5，代表语音媒体发起方失败事件流事件流描述 OnListenFailure 没有问题 ( MediaType) MediaType：5，代表语音媒体对方事件流无批量获取座席状态功能获取座席当前状态原型 BSTR QueryAgentStatusByAgentID(LPCTSTR AgentIDs); 参数参数参数说明 AgentIDs 坐席工号字符串，格式为“1001,1002” 返回值返回值返回值说明监控信息格式为格式为“座席1工号,状态,状态持续时间(秒),进入状态原因|座席2工号,状态,状态持续时间(秒),进入状态原因”，如“1001,0,100,0|1002,2,300,0”。座席状态码： enum AGENT_STATE { NOT_LOGINED=0, //未签入 IDLE, //空闲状态 PREOCCUPY , //预占用状态 OCCUPY , //占用状态 ANSWERING , //应答状态 TALKING , //通话状态 WORKING, //工作状态 SETBUSY, //忙状态 REST, //请假休息 AGENT_STUDING, //学习状态 AGENT_WORK_ADJUST//调整状态 }; 状态原因指座席休息（离席）时选择的原因码。发起方成功事件流无发起方失败事件流无对方事件流无获取技能队列下所有座席状态功能获取技能队列下所有座席状态原型 BSTR QueryAgentStatusBySkillName(LPCTSTR SkillName); 参数参数参数说明 SkillName 技能队列名称字符串返回值返回值返回值说明监控信息格式为格式为“座席1工号,状态,状态持续时间(秒),进入状态原因|座席2工号,状态,状态持续时间(秒),进入状态原因”，如“1001,0,100,0|1002,2,300,0”。座席状态码： enum AGENT_STATE { NOT_LOGINED=0, //未签入 IDLE, //空闲状态 PREOCCUPY , //预占用状态 OCCUPY , //占用状态 ANSWERING , //应答状态 TALKING , //通话状态 WORKING, //工作状态 SETBUSY, //忙状态 REST, //请假休息 AGENT_STUDING, //学习状态 AGENT_WORK_ADJUST//调整状态 }; 状态原因指座席休息（离席）时选择的原因码。发起方成功事件流无发起方失败事件流无对方事件流无

展开阅读全文