转接接口请求说明

一、转接接口

1.接口简介

本接口主要用来转接电话，支持来电转接和外呼转接，可以转外线，坐席或者对应的技能组

2.接口请求

  • HTTP请求方式：POST

  • 请求链接：{HOST}/v20160818/call/transfer/{ACCOUNTID}?sig={SIG}

  • 请求时请将{HOST}换成对接数据查询中获取到的请求域名，{ACCOUNTID}替换为账户编号，{SIG}是根据鉴权规则生成的，请看鉴权文档，查看具体的生成规则

  • 鉴权文档：接口鉴权

3.接口参数如下：

参数名 是否必填 值 参数释义
FromExten 是 坐席工号 例：假设8001@gs是坐席登陆账号，8001才是坐席工号
Exten 是 被叫号码 可传入,外线号码, 坐席工号, 技能组编号例如:1501045xxxx, 8000, 10014640
Mode 是 number/skillgroup 转接到技能组为skillgroup, 转接到外线或者坐席为number
ActionID 否 唯一字符串（可随机） 随机码，用户用来标识请求的操作，服务器返回的Response中会带有对应Action的ActionID；在通话事件中会带有该字段；该字段最大长度是40个字节

4.系统返回

返回Json对象，样例：

{
    "Command": "Response",
    "Succeed": false,
    "Message": "317",
    "ActionID": "Transfer0.2626624043352459",
    "Response": "Transfer"
}

返回值字段说明：

字段名称 值 说明
Response Transfer 对应Action的名称
ActionID 唯一字符串 对应操作的唯一标记
Succeed 处理结果 请求是否成功，当不成功时会在Message字段中给出原因
Command Response 返回的固定参数
Message 结果说明 300 转接失败,联系管理员，pbx中的转接接口没有开启
310未配置外呼线路
311转接的用户忙
312转接的用户未签入
313转接的用户正在通话
314转接的用户没有以通话方式登录
315无法呼通转接的用户
316转接用户不存在
317对方忙碌,无法处理您的转接电话
400 Error action：请求有误，请检查传递的参数是否合法
401 PBX not found：账户配置问题
403 forbbiden：鉴权失败
404 Agent not found：坐席未找到，请检查FromExten字段中的坐席分机号是否传递正确
500 Server error：服务器错误

二、取消转接接口

1.接口简介

取消正在转接中的电话

2.接口请求

  • HTTP请求方式：POST

  • 是否需要鉴权：接口鉴权

  • 请求链接：{HOST}/v20160818/call/cancelTransfer/{ACCOUNTID}?sig={SIG}

  • 请求时请将{HOST}换成对接数据查询中获取到的请求域名，{ACCOUNTID}替换为账户编号，{SIG}是根据鉴权规则生成的，请看鉴权文档，查看具体的生成规则

  • 接口鉴权

3.接口参数如下：

参数名 是否必填 值 参数释义
FromExten 是 坐席工号 例：假设8001@gs是坐席登陆账号，8001才是坐席工号
ActionID 否 唯一字符串（可随机） 随机码，用户用来标识请求的操作，服务器返回的Response中会带有对应Action的ActionID；在通话事件中会带有该字段；该字段最大长度是40个字节

请求实例

https://apis.7moor.com/v20160818/call/cancelTransfer/N00000001305?sig=SIG

{
   "FromExten": "8001",
    "ActionID":"123456789"
}

4.系统返回

返回Json对象，样例：

{
    "Command": "Response",
    "Succeed": true,
    "ActionID": "123456789",
    "Response": "CancelTransfer"
}

返回值字段说明：

字段名称 值 说明
Response CancelTransfer 对应Action的名称
ActionID 唯一字符串 对应操作的唯一标记
Succeed 处理结果 请求是否成功，当不成功时会在Message字段中给出原因
Command Response 返回的固定参数
Message 结果说明 301 This exten is not calling... 当前坐席不存在转接话务
400 Error action please check your params 传入参数错误,请检查你的参数
500 Server error 服务器错误,请联系管理员
404 Agent not found 坐席没有找到
401 PBX not found 坐席所在pbx没有找到