用户工具

呼叫中心:monitoring_ipcc

监听

监听是通话过程中,班长可以听到被监听方坐席的谈话,班长状态也可以通过相关接口进行转换,其中与坐席和用户通话必须有班长监听的前提

包含以下接口:

数据结构说明

监听对象

属性 类型 约束 说明
ivr appId String 必选 应用唯一标识
callId String 必选 呼叫ID
number String 必选 班长PSTN号码或Client ID
data String 可选 用户透传数据

JSON示例

JSON示例

{
    "ivr":{
           "appId":"247e35ff320a4142a105024055c367cf",
           "callId":"77a18fb0-bdde-11e5-b810-77c743ca5c3a",
           "number":"075582255215",
           "data":""
    }
}

XML示例

XML示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ivr>
     <appId>247e35ff320a4142a105024055c367cf</appId>
     <callId>77a18fb0-bdde-11e5-b810-77c743ca5c3a</callId>
     <number>075582255125</number>
     <data></data>
</ivr>

恢复监听/结束监听对象

属性 类型 约束 说明
ivr appId String 必选 应用唯一标识
callId String 必选 呼叫ID
data String 可选 用户透传数据

JSON示例

JSON示例

{
    "ivr":{
          "appId":"247e35ff320a4142a105024055c367cf",
          "callId":"77a18fb0-bdde-11e5-b810-77c743ca5c3a",
          "data":""
    }
}

XML示例

XML示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ivr>
     <appId>247e35ff320a4142a105024055c367cf</appId>
     <callId>77a18fb0-bdde-11e5-b810-77c743ca5c3a</callId>
     <data></data>
</ivr>

用户/坐席交谈对象

属性 类型 约束 说明
ivr appId String 必选 应用唯一标识
callId String 必选 呼叫ID
fileName String 可选 与坐席通话前播放的语音文件名,放音文件需要先上传,如不传此参数,则不播放任何内容
data String 可选 用户透传数据

JSON示例

JSON示例

{
    "ivr":{
          "appId":"247e35ff320a4142a105024055c367cf",
          "callId":"77a18fb0-bdde-11e5-b810-77c743ca5c3a",
          "fileName":"",
          "data":""
    }
}

XML示例

XML示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ivr>
      <appId>247e35ff320a4142a105024055c367cf</appId>
      <callId>77a18fb0-bdde-11e5-b810-77c743ca5c3a</callId>
      <fileName></fileName>
      <data></data>
</ivr>

强插/强拆对象

属性 类型 约束 说明
ivr appId String 必选 应用唯一标识
callId String 必选 呼叫ID
number String 可选 班长PSTN号码或Client ID,班长已经监听情况下可选,班长没有监听时需要填写该字段
fileName String 可选 与坐席/用户通话前先播放的文件,要求文件要先上传,如不传此参数则不播放任何内容
data String 可选 用户透传数据

JSON示例

JSON示例

{
    "ivr":{
          "appId":"247e35ff320a4142a105024055c367cf",
          "callId":"77a18fb0-bdde-11e5-b810-77c743ca5c3a",
          "number":"075582255125",
          "fileName":"",
          "data":""
    }
}

XML示例

XML示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ivr>
       <appId>247e35ff320a4142a105024055c367cf</appId>
       <callId>77a18fb0-bdde-11e5-b810-77c743ca5c3a</callId>
       <number>075582255125</number>
       <fileName></fileName>
       <data></data>
</ivr>

坐席替换对象

属性 类型 约束 说明
ivr appId String 必选 应用唯一标识
callId String 必选 呼叫ID
number String 必选 坐席PSTN号码或Client ID
fileName String 可选 与坐席通话前播放的语音文件名,放音文件需要先上传,如不传此参数则不播放任何内容
data String 可选 用户透传数据

JSON示例

JSON示例

{
    "ivr":{
           "appId":"247e35ff320a4142a105024055c367cf",
           "callId":"77a18fb0-bdde-11e5-b810-77c743ca5c3a",
           "number":"075582255125",
           "fileName":"",
           "data":""
    }
}

XML示例

XML示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ivr>
   	<appId>247e35ff320a4142a105024055c367cf</appId>
        <callId>77a18fb0-bdde-11e5-b810-77c743ca5c3a</callId>
        <number>075582255125</number>
        <fileName></fileName>
        <data></data>
</ivr>

一般响应对象

属性 类型 约束 说明
resp respCode String 必选 参见 响应码说明
ivr appId String 必选 应用ID
callId String 必选 呼叫ID

JSON示例

JSON示例

{
    "resp": {
        "respCode": "000000",
        "ivr": {
            "appId": "8230e48a30864a50a5ad5919d0b30dd1",
            "callId":"2015102614502300261CTI"
        }
    }
}

XML示例

XML示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<resp>
    <respCode>000000</respCode>
    <ivr>
        <appId>8230e48a30864a50a5ad5919d0b30dd1</appId>
        <callId>2015102614502300261CTI</callId>
    </ivr>
</resp>

接口说明

开始监听

功能 开始监听
URL https://api.ucpaas.com/{SoftVersion}/Accounts/{accountSid}/ipcc/call/listening?sig={SigParameter}
Method POST
Headers 参考REST介绍中 HTTP Headers 的说明
Body 监听对象
Response 一般响应对象

恢复监听

功能 班长恢复监听状态
URL https://api.ucpaas.com/{SoftVersion}/Accounts/{AccountSid}/ipcc/call/recoverListening?sig={SigParameter}
Method POST
Headers 参考REST介绍中 HTTP Headers 的说明
Body 恢复监听对象
Response 一般响应对象

跟坐席交谈

功能 班长和坐席说话
URL https://api.ucpaas.com/{SoftVersion}/Accounts/{AccountSid}/ipcc/call/talkToSeat?sig={SigParameter}
Method POST
Headers 参考REST介绍中 HTTP Headers 的说明
Body 坐席交谈对象
Response 一般响应对象

跟用户交谈

功能 班长和用户交谈,坐席侧只能听,不能说
URL https://api.ucpaas.com/{SoftVersion}/Accounts/{accountSid}/ipcc/call/talkToCustomer?sig={SigParameter}
Method POST
Headers 参考REST介绍中 HTTP Headers 的说明
Body 用户交谈对象
Response 一般响应对象

强插

功能 班长强行插入坐席和用户直接通话
URL https://api.ucpaas.com/{SoftVersion}/Accounts/{AccountSid}/ipcc/call/bargeIn?sig={SigParameter}
Method POST
Headers 参考REST介绍中 HTTP Headers 的说明
Body 强插对象
Response 一般响应对象

强拆

功能 班长和用户交谈,坐席侧被挂断
URL https://api.ucpaas.com/{SoftVersion}/Accounts/{AccountSid}/ipcc/call/demolitions?sig={SigParameter}
Method POST
Headers 参考REST介绍中 HTTP Headers 的说明
Body 强拆对象
Response 一般响应对象

坐席替换

功能 班长替换坐席,可以用新坐席也可以班长自己替换坐席
URL https://api.ucpaas.com/{SoftVersion}/Accounts/{accountSid}/ipcc/call/seatReplace?sig={SigParameter}
Method POST
Headers 参考REST介绍中 HTTP Headers 的说明
Body 坐席替换对象
Response 一般响应对象

结束监听

功能 班长结束监听
URL https://api.ucpaas.com/{SoftVersion}/Accounts/{accountSid}/ipcc/call/endListening?sig={SigParameter}
Method POST
Headers 参考REST介绍中 HTTP Headers 的说明
Body 结束监听对象
Response 一般响应对象

页面工具