~~NOTOC~~



======呼叫通知======
{| style="width:100%;"
! style="width:15em"|事件名称
! style="width:10em"|Event
! |说明
|-
|[[#呼入事件|呼入事件]]
|incomingcall
|用户呼入呼叫中心时触发该事件，事件上报到AS服务器后，AS服务器通过REST呼叫应答接口来选择接听或者挂断
|-
|[[#Web/IP坐席外呼开始|WEB/IP坐席外呼开始]]
|directbeginrpt
|通过web页面或者sip软电话对接呼叫中心，发起外呼请求时会触发该事件
|-
|[[#双向外呼开始|双向外呼开始]]
|callbackbeginrpt
|AS服务器调用REST外呼接口呼叫坐席和用户，呼叫开始时会上报双向外呼开始事件
|-
|[[#应答确认事件|应答确认事件]]
|incomingcallack
|用户呼入呼叫中心，AS下发[[#呼叫应答|呼叫应答]]并置状态为接听时会 触发该事件
|-
|[[#呼叫状态通知事件|呼叫状态通知事件]]
|callstatrpt
|呼叫过程中的状态事件通知，如响铃，接听，拒接，超时等
|-
|[[#直接转坐席事件| 直接转坐席事件 ]]
|directtoservice 
|用户呼入呼叫中心，AS服务器可以下发[[#直接转坐席|直接转坐席]],转坐席过程的异常会通过该事件通知AS服务器
|-
|[[#预测试外呼事件| 预测试外呼事件 ]]
|predictoutcallbeginrpt
|AS服务器调用REST预测试外呼接口，外呼用户，此时会触发该事件，用户接听后，用户入队到指定队列，后续按照入队流程处理
|-
|[[#呼叫结束事件|呼叫结束事件]]
|calldisconnectrpt
|通话过程中，坐席和用户任何一方挂机，都会触发该事件，事件中用dir 0表示坐席 1表示用户侧


|}
===== 事件对象说明 =====



==== 呼入事件====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|event
|String
|style="text-align:center;"|必选
|事件名称 incomingcall
|-
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|caller       
|String
|style="text-align:center;"|必选
|主叫号码
|-
|called
|String
|style="text-align:center;"|必选
|被叫号码
|}
----
<hidden 通知示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
    <event>incomingcall</event>
    <callId>2015100908543501530CTI</callId>
    <appId>247e35ff320a4142a105024055c367cf </appId>
    <caller>075586682088</caller>
    <called>53806409</called>
    <timeStamp>20160131170852107</timeStamp>
</request>
</code>
</hidden>

----
==== Web/IP坐席外呼开始====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|event
|String
|style="text-align:center;"|必选
|事件名称 directbeginrpt
|-
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|caller
|String
|style="text-align:center;"|必选
|主叫号码
|-
|called
|String
|style="text-align:center;"|必选
|被叫号码
|}
----
<hidden 通知示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
  <event>directbeginrpt</event>
  <callId>20151203143610006462532060006057FLOW</callId>
  <appId>11a3f2ba83ef496f994ba8a6979cc4c7</appId>
  <caller>62532060006057</caller>
  <called>18898739887</called>
  <timeStamp>20160131170852107</timeStamp>
</request>
</code>
</hidden>

==== 双向外呼开始====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|event
|String
|style="text-align:center;"|必选
|事件名称 callbackbeginrpt
|-
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|caller
|String
|style="text-align:center;"|必选
|主叫号码
|-
|called
|String
|style="text-align:center;"|必选
|被叫号码
|}
----
<hidden 通知示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
  <event> callbackbeginrpt</event>
  <callId> 2015100908543501530CTI</callId>
  <appId>11a3f2ba83ef496f994ba8a6979cc4c7</appId>
  <caller>62532060006057</caller>
  <called> 15019409157</called>
  <timeStamp>20160131170852107</timeStamp>
</request>
</code>
</hidden>
==== 应答确认事件====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|event
|String
|style="text-align:center;"|必选
|事件名称 incomingcallack
|-
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|}
----
<hidden 通知示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
    <appId>247e35ff320a4142a105024055c367cf </appId>
    <callId>2015100817062901467CTI</callId>
    <event>incomingcallack</event>
    <timeStamp>20160131170852107</timeStamp>
</request>
</code>
</hidden>

====呼叫状态通知事件====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|event
|String
|style="text-align:center;"|必选
|事件名称 callstatrpt
|-
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|serviceId
|String
|style="text-align:center;"|必选
|如果是主席侧状态通知字段显示坐席ID,用户侧该字段为空
|-
|dir
|Int
|style="text-align:center;"|必选
|呼叫状态坐席侧或者用户侧
  * 0，	坐席侧
  * 1，	用户侧

|-
|ansCode
|Int
|style="text-align:center;"|必选
|呼叫状态值
  * 0： 外呼超时
  * 1： 拒绝
  * 2： 无应答
  * 3： 不存在
  * 4： 呼叫失败
  * 5： 振铃
  * 6： 接听
  * 7： 主叫挂机
  * 8： 通话中
  * 9： 关机
  * 10： 停机
  * 11：vboss呼叫资源不足
  * 12：线路黑名单
  * 99： 未知

|}
----
<hidden 通知示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
<appId>247e35ff320a4142a105024055c367cf </appId>
<callId>2015100817062901467CTI</callId>
<serviceId>62532060006057</serviceId>
<dir>0</dir>
<ansCode>6</ansCode>
<event>callstatrpt</event>
<timeStamp>20160131170852107</timeStamp>
</request>
</code>
</hidden>

====直接转坐席事件====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|event
|String
|style="text-align:center;"|必选
|事件名称 directtoservice 
|-
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|reason 
|Int
|style="text-align:center;"|必选
| 错误码
  * 0: 正常
  * 1：没有找到坐席
  * 2：呼叫失败 
  * 其他：未定义

|}
----
<hidden 通知示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
  <event> directtoservice </event>
  <callId> 7dbc2536-c01d-11e5-a5b4-5d5dac84681f </callId>
  <appId> bb8e39dee6a24cedbb23970fa83b4114 </appId>
  <reason >1</ reason >
  <timeStamp>20160131170852107</timeStamp>
</request>
</code>
</hidden>

====预测试外呼事件====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|event
|String
|style="text-align:center;"|必选
|事件名称 predictoutcallbeginrpt
|-
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|caller 
|Int
|style="text-align:center;"|必选
| 主叫号码
|-
|data
|String
|style="text-align:center;"|可选
|用户透传数据
|}
----
<hidden 通知示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
  <event> predictoutcallbeginrpt</event>
  <callId> 7dbc2536-c01d-11e5-a5b4-5d5dac84681f </callId>
  <appId> bb8e39dee6a24cedbb23970fa83b4114 </appId>
  <caller >15019409157</caller>
  <data>123</data>
  <timeStamp>20160131170852107</timeStamp>
</request>
</code>
</hidden>



====呼叫结束事件====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|event
|String
|style="text-align:center;"|必选
|事件名称 calldisconnectrpt
|-
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|dir
|Int
|style="text-align:center;"|必选
| 错误码
  * 0: 坐席
  * 1：用户侧
  * 其他：未定义

|-
|fileName
|String
|style="text-align:center;"|必选
|录音文件名称
|-
|reason
|Int
|style="text-align:center;"|必选
|挂机原因
  * 0 : 正常挂机
  * 1 ：TTS超时挂机,
  * 2 ：TTS转换失败
  * 3 ：入队失败
  * 4 ：排队获取按键超时
  * 5 ：OTPS找不到APPID
  * 6 ：计费余额不足
  * 7 ： 会话超过最长允许通话时长
  * 8 ： 计费异常错误
  * 9 ： 计费连接OTPS服务器超时
  * 10：用户主动挂机
  * 11：技能组被删除
  * 12 ：用户服务器响应异常

|-
|data
|String
|style="text-align:center;"|可选
|用户透传数据
|}
----
<hidden 通知示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
    <appId>247e35ff320a4142a105024055c367cf </appId>
    <callId>2015100908563101533CTI</callId>  
    <flieName>1446560181239909</flieName>
    <date>20151103</date>
    <dir>0</dir>
    <reason>0</reason>
    <event>calldisconnectrpt</event>
    <timeStamp>20160131170852107</timeStamp>
</request>
 </code>
</hidden>