监听是通话过程中,班长可以听到被监听方坐席的谈话,班长状态也可以通过相关接口进行转换,其中与坐席和用户通话必须有班长监听的前提
包含以下接口:
属性 | 类型 | 约束 | 说明 | |
---|---|---|---|---|
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 | 一般响应对象 |