04ctiapi接口参考 常量及数据结构doc.docx

1、04ctiapi接口参考 常量及数据结构doc第1章 常量定义本章要点：本章介绍了CTIAPI涉及的常量，供二次开发人员参考。& 说明：对于常量和数据结构，在Apiuse.h中均有定义，开发人员可直接查看。1.1 员工权限/定义系统用户的权限#define RIGHT_BUSYIDLE 0x00000001 / 示忙/示闲#define RIGHT_MUTEONOFF 0x00000002 /静音/非静音#define RIGHT_HOLDFETCH 0x00000004 /保持/取保持#define RIGHT_CONNECTHOLD 0x00000008 /连接保持#define RIGH

2、T_CALLOUT 0x00000010 /普通呼出#define RIGHT_INTERCALL 0x00000020 /内部呼叫#define RIGHT_TRANSFER 0x00000040 /内部转移#define RIGHT_TRANSITTALK 0x00000080 /接转接来话#define RIGHT_TRITALK 0x00000100 /三方通话#define RIGHT_TRANSITOUT 0x00000200 /转出#define RIGHT_SSPTRANSIVR 0x00000400 /人工转移自动#define RIGHT_DENYTALK 0x000008

3、00 /不接来话#define RIGHT_SUPERVISEINSERT 0x00001000 /监听/监听插入#define RIGHT_INTERCEPT 0x00002000 /拦截#define RIGHT_FORCEOUTBUSYIDLE 0x00004000 /强制签出/强制示忙/强制示闲#define RIGHT_SPYRECORDPLAY 0x00008000 /质检录音/质检放音#define RIGHT_SPYMONITOR 0x00010000 /质检监视#define RIGHT_ASSESSMANAGER 0x00020000 /考评管理员#define RIGHT

4、_ASSESS 0x00040000 /普通考评员#define RIGHT_ALARM 0x00080000 /告警台#define RIGHT_REPORT 0x00100000 /报表处理员#define RIGHT_SERVICEEXPERT 0x00200000 /话务专家员#define RIGHT_MONITOR 0x00400000 /监控系统#define RIGHT_SYSTEM 0x00800000 /数管员#define RIGHT_REPORTMANAGER 0x01000000 /报表管理员#define RIGHT_HOMECALLOUT 0x02000000 /

5、国内长途呼出#define RIGHT_ABOARDCALLOUT 0x04000000 /国际长途呼出#define RIGHT_PILOTCALLOUT 0x08000000 /本呼叫中心接入码呼出#define RIGHT_SCREENQC 0x10000000 /全屏质检#define RIGHT_PICKUP 0x20000000 /同组代答1.2 设备类型/Device设备的m_ucDeviceType是该枚举，其他都用地址中的类型来表示enum ICD_DEVICETYPE NotKnowType = 0, QueueType = 1, AgentType, IvrType, C

6、onferenceType, CallPartyType, AgentQueueType, /ICD3.0扩展 RouteType, PhoneType, /普通电话类型（一般市话、分机和外接分台等） AgentPrivateQueueType, /业务代表私有队列类型，DeviceNo就使用工号;1.3 座席类型与状态enum AGENT_TYPE EXTENSION_TYPE = 0, /分机类型 USERLINE_TYPE, /用户线类型（增加兼容类型） AGENT_TYPE_1B1D, /1B+D座席（包括TUA长通电话座席） AGENT_TYPE_SINGLE_PHONE, /单非长

7、通电话座席 AGENT_TYPE_PC_PHONE, /PC+PHONE座席 AGENT_TYPE_ISDN_2BD, /视频座席 2B+D座席 AGENT_TYPE_ISDN_6BD, /视频座席 6B+D座席;enum AGENT_OP_STATUS /业务代表主要状态的变化 ops_null=0, /座席签出 ops_login, /座席签入 ops_idle, /空闲 ops_busy, /示忙 ops_active, /通话态 ops_wait_answer,/给业务代表分来话后等业务代表应答 ops_wait_connect,/业务代表应答或业务代表呼出成功后等待连接成功的消息 o

8、ps_release, /业务代表拆线 ops_disconnect, /请求释放 ops_wait_alerting,/呼出时等被叫振铃 ops_tri_tlak = 10,/三方通话 ops_fail, /座席通道坏或座席死机 ops_ok , /座席通道或座席已恢复 ops_hungup , /人工转自动，业务代表处于挂起状态 /业务代表是否被监听或插入 ops_supervise_insert, /被监听或插入 ops_stop_supervise_insert, /停止被监听或插入 /业务代表是否被录音 ops_record_begin, /被录音 ops_record_stop ,

9、 /停止被录音 /业务代表是否被监视 ops_monitor, /被监视 ops_stop_monitor, /停止被监视 / ops_monitor_supervisor_other = 20,/监听或插入 ops_stop_monitor_supervisor_other,/停止监听或插入 ops_playvoice, /放音 ops_stop_playvoice, /停止放音 ops_surveillant, /监视 ops_stop_surveillant =25 ,/停止监视 ops_rest, /座席休假（休息） ops_work, /工作状态 ops_monitor_insert

10、_call, /监听插入呼叫 /added 3.0 ops_play, /放音 ops_stop_play, /停止放音 ops_force_out, /强制签出 ops_force_idle, /强制示闲 ops_force_busy /强制示忙;1.4 呼叫特征/呼叫中心系统呼叫特征，用于写话单目的/0200为CTI Server保留enum Call_Feature_Type /呼叫中心系统呼叫特征 SP_CALL_NORMAL =0, /普通呼入 SP_CALL_SPECIAL, /SPECIAL CALL , USED BY CONFERENCE CALL KE11_CALL, /K

11、E=11, USED BY VMS CALL-GET VOICE INFORMATION KE15_CALL, /KE=15, USED BY VMS CALL-DELETE VOICE INFORMATION BP_CALL , /BP,USED BY VMS CALL-SEND INFORMATION TO BP SP_CALL_LONG, /长途呼入呼叫 INTER_CALL, /内部呼叫 SP_CALL_OUT, /普通呼出 OP_CALL_OUT, /座席呼出类型，可以支持强插在发送到SIP模块后要转换成6 。 OP_PRI_OUT, /PRI呼出 IVR_CALL_OUT, /IV

12、R呼出 OUTBOUND_CALL_OUT, /预约呼出 /OPS:begin ICD_SP_OPS_AIDERCALL, /辅助呼叫 ICD_SP_OPS_INCALL, /来话呼叫（国际业务代表） ICD_SP_OPS_PASSCALL, /去话呼叫（国际业务代表） ICD_SP_OPS_GIVECALL, /递延呼叫 ICD_SP_OPS_INCALL_OUT,/来话呼出呼叫 ICD_SP_OPS_PASSCALL_OUT,/递延呼出呼叫 ICD_SP_OPS_TEL_CALL_OUT,/电话呼出 /OPS:end /以下为专为视频呼叫新增的呼叫特征 /VCP:begin ICD_SP_

13、VCP_ISDNCALL_IN, /视频呼入实际呼叫（排队机发起） ICD_SP_VCP_ISDNCALL_OUT, /视频呼出实际呼叫（到排队机） ICD_SP_VCP_VIRTUALCALL_IN_2BD, /视频呼入2B+D虚呼叫（2路呼叫整合成的一路呼叫） ICD_SP_VCP_VIRTUALCALL_IN_6BD, /视频呼入6B+D虚呼叫（6路呼叫整合成的一路呼叫） ICD_SP_VCP_VIRTUALCALL_OUT_2BD, /视频呼出2B+D虚呼叫（CCS发起） ICD_SP_VCP_VIRTUALCALL_OUT_6BD, /视频呼出6B+D虚呼叫（CCS发起） /VCP:

14、end /以下为自动呼出的呼叫特征 /OUTBOUND:begin ICD_SP_OUTBOUND_PRE_OCCUPY, /预占用呼出 ICD_SP_OUTBOUND_PRE_CONNECT, /预连接呼出 ICD_SP_OUTBOUND_VIRTUAL_CALLIN, /虚呼入呼出 ICD_SP_OUTBOUND_PREVIEW, /预览呼出 ICD_SP_OUTBOUND_CALLBACK, /回呼请求 /OUTBOUND:end /0200为CTI Server保留;1.5 录放音常量enum RELOCATION_DIRECTION SEEK_FORWARD, / 0： 向前 SEE

15、K_BACKWARD / 1： 向后;enum RELOCATION_SEEK_FROM SEEK_FROM_HEAD=0, /文件头 SEEK_FROM_CURRENT, /文件当前位置 SEEK_FROM_TAIL /文件尾;1.6 呼叫转移方式enum TRANSFER_STYLE CANCEL_TRANSFER = 0, FORWARD_TRANSFER, /前转 BUSY_TRANSFER /忙转;1.7 语音类型enum voice_resource /放音资源类型 SPT_RESOURCE=0, /SPT放音 VP_RESOURCE, /VP放音 SIG_RESOURCE, /S

16、IG信号音 NO_VOICE /没有语音;enum Play_Type /放音类型 PLAY_NOTE=0, / 放提示音 PLAY_LOCAL_FILE, / 没用，仅为与A型排队机TopEng业务兼容。 PLAY_SPEC_FILE, / 放指定文件 PLAY_TEM_FILE, / 放临时文件 PLAY_COMBINE, / 放合成音 PLAY_QC_FILE /播放质检录音;1.8 监视类型enum MI_TYPE MI_TRUNKNO = 0, /按中继监视 MI_CALLER, /按主叫监视 MI_CALLED /按被叫监视;1.9 内部求助类型enum CONNECT_BY_TY

17、PE /内部求助连接类型 BY_DIRECT = 0, /两方求助 BY_CONFERENCE /三方求助;1.10 呼叫离开设备原因enum CALL_DIRECT_MODE /离开设备原因 NORMAL_DIRECT = 0 , /正常离开 KEEP_DIRECT, /保持 WAIT_DIRECT, /等待 RELEASE_DIRECT /释放;1.11 中继类型enum ACD_TRUNK_TYPE INBOUND_TRUNK = 0, /入中继 OUTBOUND_TRUNK, /出中继 BIDIRECT_TRUNK /双向中继;1.12 资源连接类型enum CONNECT_BY_TY

18、PE BY_DIRECT = 0, /搭线直接连接 BY_CONFERENCE /会场连接;第2章 数据结构定义本章要点：本章介绍了本API涉及的数据结构，供二次开发人员参考。& 说明：对于常量和数据结构，在Apiuse.h中均有定义，开发人员可直接查看。2.1 DBCCC_USER_RECORD（座席登录信息）#define RESERVED_SIZE 9typedef struct tagDBCCC_USER_RECORD WORD usWorkNo; /用户工号 CHAR szUserName DBCCC_MAXLEN_USERNAME + 1 ;/用户姓名 CHAR szPasswor

19、d DBCCC_MAXLEN_PASSWORD + 1 ;/用户口令 ULONG ulSecurity; /用户权限 UCHAR ucReservedRESERVED_SIZE; /保留未用的区域DBCCC_USER_RECORD, *LPDBCCC_USER_RECORD; / 2.2 DBCCC_USER_RECORD_EX（扩展的座席登录信息）Const USHORT MAX_RIGHT_BYTE_LEN = 32; /最大权限字符长度 struct DBCCC_USER_RECORD_EX : public DBCCC_USER_RECORD VDNID usVDN; /VDN号 UC

20、HAR ucRightMAX_RIGHT_BYTE_LEN; /权限;2.3 DEVICE_ID（设备标识）typedef struct tagDEVICE_ID UCHAR ucDeviceType; /设备类enum ICD_DEVICETYPE USHORT usDeviceNo; /设备号码 friend int operator=(const struct tagDEVICE_ID & id1, const struct tagDEVICE_ID& id2 ) return (id1.ucDeviceType = id2.ucDeviceType & id1.usDeviceNo =

21、 id2.usDeviceNo); friend int operator!=(const struct tagDEVICE_ID& id1, const struct tagDEVICE_ID& id2 ) return (id1.ucDeviceType != id2.ucDeviceType | id1.usDeviceNo != id2.usDeviceNo); DEVICE_ID, *LPDEVICE_ID; /设备标识2.4 CALLID（呼叫标识）struct CALLID ULONG ulTime; /呼叫进入时间 USHORT usDsn; /呼叫进入的任务号 UCHAR u

22、cHandle; /呼叫进入一个任务的次数 UCHAR ucServer; /唯一标识一个服务器的标识 inline friend int operator!=(const CALLID& id1, const CALLID& id2 ); inline friend int operator=(const CALLID& id1, const CALLID& id2 ); /呼叫标识typedef CALLID *LPCALLID;inline int operator!=(const CALLID& id1, const CALLID& id2 ) return memcmp(&id1,

23、&id2, sizeof(CALLID); inline int operator=(const CALLID& id1, const CALLID& id2 ) return !memcmp(&id1, &id2, sizeof(CALLID); const CALLID CALLID_NO_USE = 0xffffffff, 0xffff, 0xff, 0xff ;2.5 EVENT_TIME（事件时间结构）事件时间结构，指示发生此事件的时间。typedef struct tagEVENT_TIME USHORT wYear; UCHAR wMonth; UCHAR wDayOfWeek;

24、 /Specifies the current day of the week; /Sunday = 0, Monday = 1, and so on. UCHAR wDay; UCHAR wHour; UCHAR wMinute; UCHAR wSecond; USHORT wMilliseconds; /Specifies the current millisecondEVENT_TIME, *LPEVENT_TIME; 2.6 DBCCC_EVENT_HEAD（事件头）typedef struct tagDBCCC_EVENT_HEAD EVENT_TIME ulTime; /事件产生时

25、间 USHORT usEventType; /事件类型。enum CCC_EVENT USHORT usSize; /与事件相关的数据长度DBCCC_EVENT_HEAD, *LPDBCCC_EVENT_HEAD; 2.7 DBCCC_DEVICE_STRUCT（业务类型结构）此结构后是呼叫轨迹，用多个DBCCC_DEVICE_STRUCT表示。typedef struct tagDBCCC_DEVICE_STRUCT ULONG ulWaitBeginTime; /等待开始时间 ULONG ulWaitEndTime; /等待结束时间 ULONG ulAnswerBeginTime; /应答

26、开始时间 ULONG ulAnswerEndTime; /应答结束时间 ULONG ulTalkBeginTime; /谈话开始时间 ULONG ulTalkEndTime; /谈话结束时间 USHORT usDeviceNo; /设备编号 UCHAR ucDeviceType; /设备类型 enum ICD_DEVICETYPE UCHAR ucDoFuction; /此设备的处理方式，enum CALL_DIRECT_MODE UCHAR ucLeaveReason; /离开此设备原因, enum CALL_DIRECT_MODEDBCCC_DEVICE_STRUCT, *LPDBCCC_

27、DEVICE_STRUCT;2.8 DBCCC_DEVICE_STRUCT_EX（扩展呼叫轨迹）typedef struct tagDBCCC_DEVICE_STRUCT_EX ULONG ulWaitBeginTime; /等待开始时间 ULONG ulWaitEndTime; /等待结束时间 ULONG ulAnswerBeginTime; /应答开始时间 ULONG ulAnswerEndTime; /应答结束时间 ULONG ulTalkBeginTime; /谈话开始时间 ULONG ulTalkEndTime; /谈话结束时间 USHORT usDeviceNo; /设备编号 UC

28、HAR ucDeviceType; /设备类型 enum ICD_DEVICETYPE UCHAR ucDoFuction; /此设备的处理方式enum CALL_DIRECT_MODE UCHAR ucEnterReason; /进入此设备原因 UCHAR ucLeaveReason; /离开此设备原因DBCCC_DEVICE_STRUCT_EX, *LPDBCCC_DEVICE_STRUCT_EX;2.9 CALL_DIRECT_MODE（离开设备原因）enum CALL_DIRECT_MODE NORMAL_DIRECT = 0 , /正常离开 KEEP_DIRECT, /保持 WAIT

29、_DIRECT, /等待 RELEASE_DIRECT /释放;2.10 DBCCC_CALL_INFO（呼叫信息）typedef struct tagDBCCC_CALL_INFO ULONG cb; 结构长度 CALLID callID; /呼叫标识 CHAR cKeyID MAXLEN_EXTEN + 1;/呼叫的唯一标识 CHAR cANI MAXLEN_EXTEN + 1; /主叫 CHAR cDialedNumber MAXLEN_EXTEN + 1 ; /被叫 CHAR ucMid; /模块号 USHORT usTrunkNo; /中继号 UCHAR ucPriority; /用户级别 DEVICE