• 公司系列产品
    企业400电话
    录音电话系统
    乐语通微信电话
  • 分享到:

您好,欢迎来到宁波梦飞网络

当前位置:首页 > 客服中心> IPPBX常见问题 > IPPBX第三方接口文档

IPPBX第三方接口文档


1 第三方集成方案
1.1. 第三方集成简介:
第三方集成是指SmartVoice 呼叫中心系统与其他第三方软件的集成接口。主要集成包
括:
 呼叫中心端弹屏集成
 第三方软件端弹屏集成
 CDR 通话记录集成
等三种数据集成接口。下面将详细介绍。
1.2. 呼叫中心端弹屏集成
1.2.1. ODBC 接口
呼叫中心端弹屏是指弹屏在呼叫中心端完成,联系人数据通过ODBC 从第三方系统获取,
其示意图如下:
如上图所示,此时弹屏有呼叫中心完成,弹屏所需的数据通过ODBC 的方式访问第三方
数据。弹屏总共需要2 种数据:
1. 联系人数据:读取联系人时,通过读取第三方数据库中的联系人视图来完成。当有
修改时,呼叫中心将新的联系人数据写入到联系人临时表中,我们需要在联系人
临时表上绑定触发器,由触发器根据临时表数据修改用户正式库中的联系人数据。
2. 联系人的服务记录数据:服务记录表完全由呼叫中心进行维护,如果用户需要用到
服务记录表的数据,可以通过在服务记录表中绑定触发器的模式进行,如根据服
务记录创建工单。
注:相应的参考库结构说明请参考附录
1.2.2. HTTP 接口
呼叫中心端弹屏是指弹屏在呼叫中心端完成,联系人数据通过HTTP 接口从第三方系统
获取,其示意图如下:
如上图所示,此时弹屏由呼叫中心完成,弹屏所需的联系人资料通过HTTP 的接口的方
式从第三方应用中获取,数据提交均通过标准的Post 格式提交,第三方应用返回的格式为
JSON 格式。在这种模式中,第三方应用需要提供对应的链接供呼叫中心调用,本模式下总
共需要4 种接口:
1. 弹屏接口:这是一个必须的接口,当客户呼入电话时,服务中心会获取客户的
caller_number,并将此号码提交给第三方应用的弹屏接口,第三方应用需要根据
caller_number 到联系人表中查询与此号码有关的所有联系人,并将查询到的联系
人信息通过JSON 格式返回。
 提交数据:通过Post 提交的数据结构如下:
序号 名称 描述
1 caller_number 客户呼入的主叫号码
 返回数据:联系人资料返回通过JSON 格式返回。
2. 根据主键查找联系人接口:这是一个可选的接口,只有需要下面第四个接口或者一个号
码关联多个联系人时,需要此接口。
3. 提交数据:通过Post 提交的数据结构如下:
序号 名称 描述
1 联系人主键,
根据客户需求
而定
联系人主键
4. 返回数据:联系人资料返回通过JSON 格式返回。
3. 联系人资料修改接口:这是一个可选的接口,只有坐席有需要修改联系人资料时,才需
要接口。
5. 提交数据:联系人资料将通过Post 格式提交,具体的数据项要根据客户应用决定。
6. 返回格式:数据返回通过json 格式完成,
如果成功:{“ret”:”success”}
如果错误:{“ret”:”fail”, “message”:”对应的错误信息”}
4. 联系人查询接口:这是一个可选的接口,只有坐席需要查询联系人资料时,才需要此接
口。
7. 提交数据:此接口中,提交的数据包括2 种,第一种是查询选项,具体的项目要根
据客户需求来确定;第二种是固定数据项,其项目如下:
序号 名称 描述
1 page_size 每次返回的联系人数量
2 current_page 返回第几页数据,从1 开始
3 order 排序字段,可选,没提供时,第三方应用做缺省排序
4 order_dir 排序方向,分为ASC 和DESC,缺省为ASC
8. 返回数据:通过json 格式返回查询到的数据,格式如下:
{“total_count”:100, “count”:20, items:[]},其中total_count 表示符合
查询条件的记录总数,count 表示本次返回记录数,items 存放返回的数据,他是
一个数组格式
1.3. 第三方软件端弹屏集成
第三方软件端弹屏是指弹屏由第三方软件完成。当系统收到来电是,呼叫中心负责将电
话状态提供给第三方软件。他包含两种模式:
 数据库集成模式
 HTTP 接口模式
1.3.1. 数据库集成模式
在这种模式下,其结构示意图如下:
如上图所示,当呼叫中心收到来电时,CTI 模块通过ODBC 实时的将来电信息(主要包
括主叫号码,被叫号码,来电时间等数据)实时的写到用户侧的数据库中,第三方软件可以
根据这张表的数据来完成弹屏的动作。
需要注意的是:在电话状态表中,分机号码是唯一,也就是说每个分机号码在电话状态
表中只会有一条记录,CTI 更新此表时,首先会检查此分机对应的记录是否存在,如果存在
则做更新操作,否则做插入操作。
1.3.2. HTTP 接口模式
在HTTP 接口模式下,CTI 控制程序实时的将来电信息POST 给第三方应用,第三方应用
接收到Post 过来的数据后,完成实际的弹屏动作。Post 的数据结构如下:
序号 名称 描述
1 ext_no 来去电的所属分机号码
2 peer_number 来电去号码,系统会自动的将手机
3 call_type 呼叫类型,in—表示呼入,out—呼出,lo---内部分机通

4 call_time 来电时间,以yyyy-MM-dd HH:mm:ss 格式返回
1.4. CDR 通话记录集成
CDR 集成,是指第三方系统保存CDR 记录。SmartVoice 提供了2 种集成方式:
 数据库集成模式
 HTTP 接口
1.4.1. 数据库集成模式
在数据库集成模式中,呼叫中心的CDR 引擎会实时的将通话记录写到用户的数据表中
(表结构参考附录),如下图所示:
1.4.2. HTTP 接口
在HTTP 接口模式下,CDR 引擎实时的将CDR 信息POST 给第三方应用,第三方应用接收
到Post 过来的数据后,完成实际的处理动作。Post 的数据结构如下:
序号 名称 描述
1 caller 主叫号码
2 called 被叫号码
3 begin_time 通话开始时间, 以yyyy-MM-dd HH:mm:ss 格式返回
4 end_time 通话结束时间,以yyyy-MM-dd HH:mm:ss 格式返回
5 duration 通话持续时间,单位为秒
6 record_path 录音存储路径
7 call_type 通话类型:in—表示呼入,out—呼出,lo---内部分机通话
8 trunk 中继
9 uuid CDR 的唯一标示
10 hangupcause 挂断原因(物理线路原因)
1.5. 第三方CTI 电话控制接口
第三方电话控制接口,是指第三方程序可以通过CTI 接口来控制电话系统的接口。目前
系统主要支持以下接口:
 拨打号码
 呼叫保持
 取消呼叫保持
 电话转移
 设置坐席状态
 电话质检
 电话挂机
1.5.1. IP 安全认证
系统提供了基于IP 的安全认证模式,也就是说,系统只允许某些特定的IP 来调用
本软件接口,此IP 可以通过配置文件进行配置。*表示任意IP 均可访问。
1.5.2. 用户名密码认证
除了IP 安全认证外,系统还提供了基于用户名,密码的认证方式。此用户必须赋予名
称为“接口”的角色,如果不存在此角色,请手工创建。
1、 登陆接口:
第三方软件通过Web Post 方式, 登陆系统。调用链接为: http://ip/
atstar/index.php/login/interfacelogin,提交参数:
 user -- 用户名
 password -- 密码
返回:系统返回数据格式为json 格式。
(1)、成功返回:当登陆成功时,返回如下格式:
{"success":"true","token":"bd3eb317a82556daca0a26c6433b9a7e"}
其中:success 为true,表示登陆成功,token:为返回的安全令牌,以后的每次CTI
调用必须携带此参数,此令牌具有10 分钟有效期,当离最后一次操作时间大于10 分钟时,
令牌失效,需要重新登录获取令牌。
(2)、失败返回:等登录失败是,返回如下格式:
{"success":"false","message":""}
其中,success 为false,表示登陆失败,message 表示失败原因
1.5.3. 接口调用方式
第三方软件通过Web Post 方式与电话系统对接, 调用链接为:
http://ip/atstar/index.php/status-op,实际应用中,请将ip 修改为实际的呼叫中心IP。
当调用成功时,返回:+OK,调用失败时,返回:-ERR:错误信息
1.5.4. 调用接口详解
接口操作 接口描述 Post 参数
拨打电话 通过分机拨打其他的
号码
op=dial
ext_no=对应的分机号码
dia_num=要拨打的号码
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
拨打电话
转路由
通过分级拨打外线,当
外线接通后,外线将会
转接到参数所指定的
op=dialroute
ext_no=对应的分机号码
dia_num=需要拨打的外线号码
路由 route=所需要转接的路由,此值在路由中将作为被
叫号码处理
拨打IVR 通过分级拨打外线,当
外线接通后,转接到指
定的IVR
op=dialivr
ext_no=对应的分机号码
dia_num=拨打的外线号码
ivr=IVR 的编号
挂机 将分机的当前通话挂

op=hangup
ext_no=对应的分机号码
呼叫保持 将当前分机通话保持 op=hold
ext_no=对应的分机号码
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
取消呼叫
保持
将当前分机保持的呼
叫返回通话
op=unhold
ext_no=对应的分机号码
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
电话转移 将当前分机的通话转
移到另一个号码
op=transfer
ext_no=对应的分机号码
transfer_num=要转移的号码
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
设置坐席
状态
设置当前分机所对应
坐席的状态
op=agentstatus
ext_no=对应的分机号码
status=要设置的状态,支持”Available”和”On
Break”两种状态
cause= 要设置状态的详细情况, 分为
ready,break1,break2 等
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
电话质

将当前分机的通话转
质检流程
op=feedback
ext_no=对应的分机号码
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
查询坐席
状态
查询当前分机的坐席
状态
op=query_agentstatus
ext_no=对应的分机号码
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
----返回坐席所对应的状态
通话转会
议室
将当前分机通话转接
到会议室中,如果当前
分机没有在通话状态,
会自动拨打当前分机,
如果分级当前正在会
议室
op=conference
confname=会议室名称,此参数可选,如果没有传入,
那么使用:conf_分机号作为会议室名称,否则系统
使用conf_会议室名 称作为会议室名称
ext_no=对应的分机号
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
邀请号码
进会议室
邀请新的号码进入当
前分机所在的会议室
op= inviteconference
ext_no=对应的分机号
dial_num=拟邀请的号码
confname=会议室名称,此参数可选,如果没有传入,
那么使用:conf_分机号作为会议室名称,否则系统
使用conf_会议室名 称作为会议室名称
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
召开会议 邀请指定的号码进入
会议室开会
op=conferencev2
ext_no=对应的分机号
confname=会议室号码
member=参会人员号码,多个号码可以用逗号(,)或
分号分割
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
注意:此操作返回成功并不表示成员已经进入会议
室,仅仅表示此次调用没有出错。判断成员是否进
入会议室,请获取会议室事件。此方法可以重复调
用,让正在进行的会议邀请新成员加入。
会议控制 对会议室进行控制 op=ctrlconf
ext_no=对应的分机号
confname=会议号码(如果用conference 邀请的会
议,此参数可以省略)
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
subop=需要对会议室进行的控制行为,包括以下选
项:
 lock:锁定会议室
 unlock:取消锁定会议室
会议成员
控制
对会议室成员进行控

op=ctrlmember
ext_no=对应的分机号
memberid=会议成员编号,all 表示所有,last 表示
最后一个进入成员,此编号可以通过会议事件获得
confname=会议号码(如果用conference 邀请的会
议,此参数可以省略)
token=安全令牌(可选,基于用户名,密码认证时,
需要传入)
subop=需要对会议室进行的控制行为,包括以下选
项:
 deaf:静音
 tmute:切换麦克风状态
 undeaf:取消静音
 unmute:取消禁麦
 mute:禁麦
 hup:无提示的踢走成员
 kick:踢走成员
1.6. 第三方系统查询电话系统状态接口
1.6.1. 认证方式:
请参看2.5.1 和2.5.2 的描述
1.6.2. 接口调用方式
第三方软件通过Web Post 方式与电话系统对接, 调用链接为:
http://ip/atstar/index.php/status-query,实际应用中,请将ip 修改为实际的呼叫中心
IP。当调用成功时,返回:JSON 格式数据,调用失败时,返回JSON 格式如下:{‘success’:
false, ‘message’: “错误信息”}
1.6.3. 获取当前正在运行的会议室
 接口功能
获取当前正在运行的会议室
 参数
序号 名称 必选 描述
1 op=list_conference 是 列出会议室的功能代码
2 token=安全令牌 否 登陆返回的安全令牌,当采用IP 认证
时,此参数可以不填写
 成功返回
{"success":"true","data":[{"conf_name":"conf_8000","uuid":"aff86c7b-4ac8-475
a-b397-7e3b890b6230","members":"2","runtimes":"82"}]}
 success:为true表示调用成功
 data:里面存放所有当前有效的会议室,他是一个数组,里面每个数据项的含义为:
 conf_name: 会议室名称
 uuid: 会议室的UUID唯一编号
 members: 会议室当前成员数据量
 runtimes: 会议室到现在运行的时间(秒)
 失败返回
{“success”:”false”,”message”:””}
 success: false表示调用失败
 message:表示失败原因
1.6.4. 获取指定会议室的成员列表
 接口功能
获取指定会议室的成员列表
 参数
序号 名称 必选 描述
1 op=list_conference_member 是 列出指定会议室成员列表的功
能代码
2 confname=需要列出的会议室名

是 需要列出的会议室名称
2 token=安全令牌 否 登陆返回的安全令牌,当采用
IP 认证时,此参数可以不填写
 成功返回
{"success":"true","data":[{"id":"2","uuid":"3eaa921d-aaba-47d1-b0a8-931e11ac
04eb","caller_name":"6001","caller_number":"6001","join_time":"1417512176","last
_talking":"1417512537"},{"id":"1","uuid":"e312668d-616d-4132-a9f8-cb9668459d2
e","caller_name":"6007","caller_number":"6007","join_time":"1417512143","last_tal
king":"1417512540"}]}
 success:为true表示调用成功
 data:里面存放所有指定会议室的成员列表,他是一个数组,里面每个数据项的含
义为:
 id: 成员编号,做成员控制时,需要用到此编号
 uuid: 会议室成员的UUID唯一编号
 caller_name: 成员姓名
 caller_number: 成员号码
 join_time: 参会时间的时间戳
 last_talking:成员最后一次发言时间
 失败返回
{“success”:”false”,”message”:””}
 success: false表示调用失败
 message:表示失败原因
1.6.5. 获取所有的队列列表
 接口功能
获取所有的队列列表
 参数
序号 名称 必选 描述
1 op=list_queue 是 列出所有的队列列表的功能代码
2 token=安全令牌 否 登陆返回的安全令牌,当采用IP 认证时,
此参数可以不填写
 成功返回
{"success":"true","data":[{"queue_name":"queue_2@tech","max_wait_time":"1
800","max_wait_time_with_noagent":"1800"},{"queue_name":"queue_1@\u6280\u6
72f\u670d\u52a1","max_wait_time":"1800","max_wait_time_with_noagent":"1800"}
]}
 success:为true表示调用成功
 data:里面存放所有的队列列表,他是一个数组,里面每个数据项的含义为:
 queue_name: 队列名称,格式为queue_队列标号@队列名称
 max_wait_time: 队列最大允许排队时间
 max_wait_time_with_noagent: 队列在没有坐席的情况下,允许成员排队最
长时间
 失败返回
{“success”:”false”,”message”:””}
 success: false表示调用失败
 message:表示失败原因
1.6.6. 获取指定队列的坐席列表
 接口功能
获取指定队列的坐席列表
 参数
序号 名称 必选 描述
1 op=list_queue_agent 是 列出指定队列的坐席列表的功能代码
2 queuename=需要列出的
队列名称
是 需要列出的队列名称
3 token=安全令牌 否 登陆返回的安全令牌,当采用IP 认证
时,此参数可以不填写
 成功返回
{"success":"true","data":[{"agent_no":"6001","uuid":"","status":"Available","cau
se":"ready","state":"Waiting","last_offered_call":"1417444830","last_status_change":
"1417100502","no_answer_count":"0","answer_count":"2"}]}
 success:为true表示调用成功
 data:里面存放所有指定队列的坐席列表,他是一个数组,里面每个数据项的含义
为:
 agent_no: 坐席号码
 uuid: 会议室成员的UUID唯一编号
 status: 坐席在线状态,Available:表示在线,可以接听电话,On Break表示
签出,系统不会分配电话
 cause: 签出原因,具体参考坐席状态设定
 state: 坐席电话状态,Waiting,表示等待接听电话状态,In a queue call:
正在接听电话,Receiving坐席正在分配电话
 last_offered_call:最后一次分配电话时间
 last_status_change:最后一次坐席状态改变时间
 no_answer_count:坐席未接电话次数
 answer_count:坐席接电话次数
 失败返回
{“success”:”false”,”message”:””}
 success: false表示调用失败
 message:表示失败原因
1.6.7. 获取指定队列的排队列表
 接口功能
获取指定队列的排队列表
 参数
序号 名称 必选 描述
1 op=list_queue_member 是 列出指定队列的排队列表的功能代

2 queuename=需要列出的队
列名称
是 需要列出的队列名称
3 token=安全令牌 否 登陆返回的安全令牌,当采用IP 认
证时,此参数可以不填写
 成功返回
 {"success":"true","data":[{"uuid":"a65fda63-bc67-482e-b03f-0d86ab0a6762
","cid_number":"600777","cid_name":"600777","join_time":"1417523204"}
]}
 success:为true表示调用成功
 data:里面存放所有指定队列的坐席列表,他是一个数组,里面每个数据项的含义
为:
 uuid: 呼入号码的UUID唯一编号
 cid_number: 呼入客户号码
 cid_name: 呼入客户名称
 join_time: 客户进入队列的时间

 失败返回
{“success”:”false”,”message”:””}
 success: false表示调用失败
 message:表示失败原因
2 事件通知
当系统状态发生变化时,系统可以通过Post 的方式通知到第三方应用,设
置方式为:
在IPPBX->系统管理->接口参数-》弹屏数据远程提交地址(如下图所示):
2.1. 事件详情
事件主要分为以下三大类事件:
 分机类事件
 呼叫中心事件
2.1.1. 分机类事件
当分机状态发生变化时,将会产生如下事件:
2.1.1.1 振铃事件
当分机振铃时,呼叫中心将向第三方应用发送事件,提交的数据项有:
序号 名称 描述
1 peer_number 呼入或呼出号码
2 ext_no 所属分机号码
3 call_type 客户名称
4 call_time 振铃时间
5 trunk 中继号码
6 uuid 通话唯一标示
7 call_state 分机状态:值为ring
2.1.1.2 电话接通事件
当分机接通后,呼叫中心将向第三方应用发送事件,提交的数据项有:
序号 名称 描述
1 peer_number 呼入或呼出号码
2 ext_no 所属分机号码
3 call_type 客户名称
4 call_time 应答时间
5 trunk 中继号码
6 uuid 通话唯一标示
7 call_state 分机状态:值为busy
2.1.1.3 电话保持事件
当分机被保持后,呼叫中心将向第三方应用发送事件,提交的数据项有:
序号 名称 描述
1 peer_number 呼入或呼出号码
2 ext_no 所属分机号码
3 call_type 呼叫类型:in-呼入,out-呼出,
4 call_time 开始保持时间
5 trunk 中继号码
6 uuid 通话唯一标示
7 call_state 分机状态:值为hold
2.1.1.4 电话挂断事件
当分机被挂断后,呼叫中心将向第三方应用发送事件,提交的数据项有:
序号 名称 描述
1 peer_number 呼入或呼出号码
2 ext_no 所属分机号码
3 call_type 呼叫类型:in-呼入,out-呼出,
4 call_time 开始保持时间
5 trunk 中继号码
6 uuid 通话唯一标示
7 call_state 分机状态:值为idle
2.1.2. 呼叫中心事件
当坐席或者客户来电发生变化时,将产生如下事件:
2.1.2.1 坐席在线状态事件
当坐席在线状态事件发生改变时,呼叫中心将向第三方应用发送事件,提交的数据项有:
序号 名称 描述
1 ext_no 坐席号码
2 state_cause 坐席状态分为: ready,
break1,break2,break3….break 的种类根据系统设

3 state_cause_description 坐席状态中文描述
4 state_duration 此状态在今天持续的合计时间
5 state_cause_time 坐席状态改变时间
6 last_update 状态发送时间
2.1.2.2 坐席电话状态事件
当坐席电话状态事件发生改变时,呼叫中心将向第三方应用发送事件,提交的数据项有:
序号 名称 描述
1 ext_no 坐席号码
2 agent_state 坐席的电话状态,分为:
Waiting-坐席空闲,等待分配电话
Receive—坐席正在振铃,准备接收来电
In a queue call—坐席正在通话
6 last_update 状态改变时间
2.1.2.3 坐席电话分配事件
当呼叫中心准备向坐席分配电话时,呼叫中心将向第三方应用发送事件,提交的数据项
有:
序号 名称 描述
1 ext_no 坐席号码
2 action 事件动作,值为:agent-offering
3 member_name 呼入电话姓名
4 member_number 呼入电话号码
5 last_update 电话分配时间
2.1.2.4 坐席电话接通事件
当坐席接通客户来电时,呼叫中心将向第三方应用发送事件,提交的数据项有:
序号 名称 描述
1 ext_no 坐席号码
2 action 事件动作,值为:bridge-agent-start
3 member_name 呼入电话姓名
4 member_number 呼入电话号码
5 last_update 电话分配时间
2.1.2.5 坐席电话接通事件
当坐席接通客户来电时,呼叫中心将向第三方应用发送事件,提交的数据项有:
序号 名称 描述
1 ext_no 坐席号码
2 action 事件动作,值为:bridge-agent-start
3 member_name 呼入电话姓名
4 member_number 呼入电话号码
5 last_update 电话分配时间
2.1.2.6 客户进入队列事件
当客户进入队列时,呼叫中心将向第三方应用发送事件,提交的数据项有:
序号 名称 描述
1 queue 队列名称
2 action 事件动作,值为:member-queue-start
3 member_name 呼入电话姓名
4 member_number 呼入电话号码
5 join 进入队列时间
2.1.2.7 客户离开队列事件
当客户离开队列时,呼叫中心将向第三方应用发送事件,提交的数据项有:
序号 名称 描述
1 queue 队列名称
2 action 事件动作,值为:member-queue-end
3 member_name 呼入电话姓名
4 member_number 呼入电话号码
5 join 进入队列时间
2.1.3. 会议室事件
2.1.4.1 会议室创建事件
当会议室开启时,将发出此事件,事件提交数据项有:
序号 名称 描述
1 action 会议室创建行为,此处值为: conference-create
2 c_name 会议室名称,名称规则是:conf_会议号码
3 update_time 会议室创建时间戳,如:1414028125.47357,整数部分是秒数,
小数部分是微秒数
2.1.4.2 会议室删除事件
当会议室所有成员都已经挂机后,会议室将自动关闭,此时将产生此事件,事件提交数
据项有:
序号 名称 描述
1 action 会议室删除行为,此处值为: conference- destroy
2 c_name 会议室名称,名称规则是:conf_会议号码
3 update_time 会议室删除时间戳,如:1414028125.47357,整数部分是秒数,
小数部分是微秒数
2.1.4.3 会议成员进入事件
当会议成员成功进入会议室后,此时将产生此事件,事件提交数据项有:
序号 名称 描述
1 action 会议成员进入行为,此处值为: add-member
2 member_no 会员成员号码,此号码是指其联系号码
3 member_id 会议成员在会议室的编号,做成员控制时,需要用此编号
4 c_name 会议室名称,名称规则是:conf_会议号码
5 update_time 会议成员加入时间戳,如:1414028125.47357,整数部分是秒
数,小数部分是微秒数
2.1.4.4 会议成员退出会议室事件
当会议成员成功进入会议室后,此时将产生此事件,事件提交数据项有:
序号 名称 描述
1 action 会议成员退出行为,此处值为: del-member
2 member_no 会员成员号码,此号码是指其联系号码
3 member_id 会议成员在会议室的编号,做成员控制时,需要用此编号
4 c_name 会议室名称,名称规则是:conf_会议号码
5 update_time 会议成员加入时间戳,如:1414028125.47357,整数部分是秒
数,小数部分是微秒数
2.1.4.5 会议成员静音事件
当会议成员静音后,此时将产生此事件,事件提交数据项有:
序号 名称 描述
1 action 会议成员静音行为,此处值为: deaf
2 member_no 会员成员号码,此号码是指其联系号码
3 member_id 会议成员在会议室的编号,做成员控制时,需要用此编号
4 c_name 会议室名称,名称规则是:conf_会议号码
5 update_time 会议成员静音时间戳,如:1414028125.47357,整数部分是秒
数,小数部分是微秒数
2.1.4.6 会议成员取消静音事件
当会议成员静音后,此时将产生此事件,事件提交数据项有:
序号 名称 描述
1 action 会议成员取消静音行为,此处值为: undeaf
2 member_no 会员成员号码,此号码是指其联系号码
3 member_id 会议成员在会议室的编号,做成员控制时,需要用此编号
4 c_name 会议室名称,名称规则是:conf_会议号码
5 update_time 会议成员取消静音时间戳,如:1414028125.47357,整数部分
是秒数,小数部分是微秒数
2.1.4.7 会议成员静麦事件
当会议成员静麦后,此时将产生此事件,事件提交数据项有:
序号 名称 描述
1 action 会议成员静麦行为,此处值为: mute
2 member_no 会员成员号码,此号码是指其联系号码
3 member_id 会议成员在会议室的编号,做成员控制时,需要用此编号
4 c_name 会议室名称,名称规则是:conf_会议号码
5 update_time 会议成员静麦时间戳,如:1414028125.47357,整数部分是秒
数,小数部分是微秒数
2.1.4.8 会议成员取消静麦事件
当会议成员取消静麦后,此时将产生此事件,事件提交数据项有:
序号 名称 描述
1 action 会议成员取消静麦行为,此处值为: unmute
2 member_no 会员成员号码,此号码是指其联系号码
3 member_id 会议成员在会议室的编号,做成员控制时,需要用此编号
4 c_name 会议室名称,名称规则是:conf_会议号码
5 update_time 会议成员取消静麦时间戳,如:1414028125.47357,整数部分
是秒数,小数部分是微秒数
3 附录
3.1. 联系人参考表tmp_contact
序号 名称 描述
1 tmp_contact_id 主键,自动增长
2 name 联系人姓名
3 customer_name 客户名称
4 title 职位
5 customer_code 客户代码
6 lead_source 客户来源
7 contact_number 联系电话
8 fax 传真
9 website 网址
10 email 电子邮件
11 address 地址
12 comment 备注
13 create_time 创建时间
14 zip_code 邮政编码
15 trade 所属行业
16 is_block 是否为黑名单
17 contact_level 联系人等级
3.2. 临时联系人表绑定触发器参考代码
CREATE TRIGGER [dbo].[After_tmp_contact]
ON [dbo].[tmp_contact]
FOR INSERT
AS
BEGIN
declare @tmp_contact_id int
if exists(select contact.contact_id from contact, inserted where contact.contact_number =
inserted.contact_number)
begin
--更新联系人
update contact set
contact.name = t.name, contact.title = t.title, contact.lead_source = t.lead_source,
contact.fax = t.fax, contact.website=t.website,contact.email=t.email,contact.address=t.address,
contact.zip_code=t.zip_code,contact.trade=t.trade, contact.customer_name=t.customer_name,
contact.is_block=t.is_block,contact.contact_level=t.contact_level
from contact inner join inserted t
on contact.customer_code=t.customer_code and contact.contact_number=t.contact_number
end else
begin
insert into contact(name, title, customer_code, contact_number, customer_name, lead_source, fax,
website, email, address, zip_code, trade, is_block, contact_level)
select name, title, customer_code, contact_number, customer_name, lead_source, fax, website, email,
address, zip_code, trade, is_block, contact_level from inserted
end;
select @tmp_contact_id = tmp_contact_id from inserted
delete from tmp_contact where tmp_contact_id=@tmp_contact_id
end;
3.3. 服务记录表
序号 名称 描述
1 service_id 服务编号
2 service_time 服务时间
3 customer_code 客户代码,跟联系人关联
4 service_type 服务类型,如咨询、投诉等
5 call_no 来电电话号码
6 direction 电话方向:in-呼入,out-呼出,lo-内部
7 detail 服务详情
8 state 服务状态,包括:新建、处理中、已完成
9 agent_no 坐席号码
10 create_time 创建时间
3.4. 电话状态表
序号 名称 描述
1 ext_no 分机号码
2 peer_number 来去电号码
3 call_type 呼叫类型,in-呼入,out-呼出,lo-内部
4 update_date 更新时间
5 state 电话状态,提供给第三方用于控制此来电是否已经完成弹屏
3.5. CDR 通话记录表


名称 描述
1 id 编号
2 caller 主叫号码
3 called 被叫号码
4 start_time 通话开始时间, 以yyyy-MM-dd HH:mm:ss 格式返回
5 end_time 通话结束时间,以yyyy-MM-dd HH:mm:ss 格式返回
6 duration 通话持续时间,单位为秒
7 file_path 录音存储路径
8 call_type 通话类型:in—表示呼入,out—呼出,lo---内部分机通话
9 trunk 中继
10 uuid CDR 的唯一标示
11 create_time 创建时间
12 comment 备注
13 hangup_cause 挂断原因
14 in_bytes 流入字节
15 out_bytes 流出字节
16 caller_owner 是否属于主叫
17 called_owner 是否属于被叫
18 cdr_date 通话记录日期
19 year 通话记录年份
20 month 通话记录月份
21 date 通话记录日期
22 hour 通话记录小时
23 forward_number 转接时,对外转接的号码
24 queue_time 排队时间
25 feedback_time 质检时间
26 ivr_time IVR 消耗时间
27 cdr_state 通话在哪个阶段挂断,ivr-表示IVR,queue-表示排队是挂断,ring-
表示振铃是挂断,bridged-表示正常转接,route-表示路由时挂断
28 route_state 表示通话是在路由时被挂断
29 ivr_state 表示通话是在ivr 时被挂断
30 queue_state 表示通话是在排队是被中断
31 ring_state 表示通话是在振铃时中断
32 bridged_state 表示通话被正常转接
33 hangup_side 表示通话挂断方,caller 表示主叫,called 表示被叫
34 fw_in 表示此电话是由别的分机或坐席转接过来
35 fw_out 表示此电话是我转给别的坐席
2016-09-17更新

联系我们

客户服务:点击这里给我发消息 点击这里给我发消息

技术支持:点击这里给我发消息 点击这里给我发消息

在微信上关注我们