分机/队列管理

来自uucall
Admin（讨论 | 贡献）2016年4月26日 (二) 21:03的版本 （→‎新增队列信息）

跳转至： 导航、 搜索

获取分机信息

  • 说明
方法: GET

前缀：http://ip:port/uucall_restapi/rest/
路径: /cti/userext/{extid}

参数校验：无
  • 示例
GET /cti/userext/1001 HTTP/1.1

Host:192.168.2.1:2888

content-length: 139

Accept:application/xml;

Content-Type:application/xml;charset=utf-8;

appid:XXXX

timestamp:2016-03-11 00:00:00

Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=


  • 参数列表
类型 参数名 描述 是否必填 数据类型 默认值
查询参数 uid 企业帐号ID true Int64
查询参数 extid 分机编号 false Int64


  • 结构响应

其中相应结果HTTP Code为200的string为json格式字符串，具体字段和字段值形式如下：

Result Data
success UserExt
failed 失败描述


  • 返回值格式

{"result":"SUCCESS","data":{"bindAccounts":["csl","jcx","zhouxiaoqing"],"crmName":"自建CRM","crmid":20042,"diyNumbers":["4008792831","13305915801"],"ext":{"bindPhone":"013358259004","diyNum":"4008792831","employeeNum":"1001","extsSize":0,"id":1054,"offlineTransfer":1,"permissions":2,"screenState":1,"screenType":2,"screenUrl":"20042&216","setBindPhone":true,"setDiyNum":true,"setEmployeeNum":true,"setExts":false,"setId":true,"setOfflineTransfer":true,"setPermissions":true,"setScreenState":true,"setScreenType":true,"setScreenUrl":true,"setState":true,"setTelExt":true,"setUid":true,"setWorkState":false,"state":0,"telExt":6315651,"uid":1225},"pageName":"默认详情页面","pageid":216,"sipAcc":6315651},"code":100}

修改分机信息

  • 说明
方法: PUT

前缀：http://ip:port/uucall_restapi/rest/
路径: /cti/userext/{extid}

参数校验：无
  • 示例
PUT /cti/userext/1001 HTTP/1.1

Host:192.168.2.1:2888

content-length: 139

Accept:application/xml;

Content-Type:application/xml;charset=utf-8;

appid:XXXX

timestamp:2016-03-11 00:00:00

Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=

{
    "bindPhone":"013358259004",

    "offline":true,

    "diyNum":"4008792831",

    "permissions":true,

    "screenWay":"other",

    "screenURL":"http://192.168.22.10:8090/vcc_uucall_self/",

    "screenState":"2",

    "accounts":"waki4,waki5"

}


  • 参数列表
类型 参数名 描述 是否必填 数据类型 默认值
查询参数 uid 企业帐号ID true Int64
查询参数 extid 分机编号 true Int64
查询参数 bindPhone 绑定固话/手机 true string
查询参数 offline 是否下线转接 1不转接 2转接 false boolean
查询参数 diyNum 分机主叫号码 false string
查询参数 permissions 外呼权限 1呼入 2呼出 3全部 4全无 false boolean
查询参数 screenWay 弹屏方式 - other：第三方；none：无弹屏；crm：CRM弹屏； false string
查询参数 screenURL 弹屏地址 false string
查询参数 screenState 弹屏时机 false Int32
查询参数 accounts 绑定账号 false string


  • 结构响应

其中相应结果HTTP Code为200的string为json格式字符串，具体字段和字段值形式如下：

Result Data
success 成功描述
failed 失败描述


  • 返回值格式

application/json
{"result":"SUCCESS","code":100}

获取队列信息

  • 说明
方法: GET

前缀：http://ip:port/uucall_restapi/rest/

路径: /cti/telext/{telextid}

参数校验：无
  • 示例
GET /cti/telext/1888 HTTP/1.1

Host:192.168.2.1:2888

content-length: 139

Accept:application/xml;

Content-Type:application/xml;charset=utf-8;

appid:XXXX

timestamp:2016-03-11 00:00:00

Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=


  • 参数列表
类型 参数名 描述 是否必填 数据类型 默认值
查询参数 uid 企业帐号ID true Int64
查询参数 telextid 队列编号 false Int64


  • 结构响应

其中相应结果HTTP Code为200的string为json格式字符串，具体字段和字段值形式如下：

Result Data
success TelExt
failed 失败描述


  • 返回值格式

application/json
{"result":"SUCCESS","data":{"crmid":0,"extTimeout":0,"extstates":0,"interval":0,"isloop":0,"listTimeout":0,"maxwaitcount":0,"pageid":0,"report":0,"ring":0,"rule":0,"screenWay":0,"telext":{"createtime":0,"id":0,"screenState":0,"screenType":0,"setAdmins":false,"setCreatetime":false,"setExtlist":false,"setId":false,"setName":false,"setScreenState":false,"setScreenType":false,"setScreenURL":false,"setState":false,"setTransruleid":false,"setUid":false,"state":0,"transruleid":0,"uid":0},"waitmusic":0,"waitsound":0},"code":100}

修改队列信息

  • 说明
方法: PUT

前缀：http://ip:port/uucall_restapi/rest/

路径: /cti/telext/{telextid}

参数校验：无
  • 示例
PUT /cti/telext/1001 HTTP/1.1

Host:192.168.2.1:2888

content-length: 139

Accept:application/xml;

Content-Type:application/xml;charset=utf-8;

appid:XXXX

timestamp:2016-03-11 00:00:00

Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=

{
    "name":"接口测试队列0",

    "mxwait":"5",

    "wtmusic":"/speech/1192/trans_begin.wav",

    "isloop":true,

    "wtsound":"/speech/1225/谢谢使用再见.wav",

    "interval":"5",

    "rule":"0",

    "ring":true,

    "report":true,

    "states":"0",

    "listTimeOut":"36",

    "extTimeOut":"36",

    "screenWay":"specify",

    "screenType":"crm",

    "screenURL":"20042&216"

}


  • 参数列表
类型 参数名 描述 是否必填 数据类型 默认值
查询参数 telextid 队列编号 true Int64
查询参数 uid 用户编号 true Int64
查询参数 name 队列名称 false string
查询参数 mxwait 最大等待数 false Int32
查询参数 wtmusic 等待音乐路径 false string
查询参数 isloop 是否循环 false boolean
查询参数 wtsound 等待提示音路径 false string
查询参数 interval 提示间隔 0~60s false Int32
查询参数 rule 转接规则(0转队列 1转分机 2转语音导航 3转固定号码) false Int32
查询参数 ring 是否振铃 false boolean
查询参数 report 是否接通报工号 false boolean
查询参数 states 分机不可用状态(1通话中 2振铃 4帐号签出) false Int64
查询参数 listTimeOut 队列超时时间 false Int32
查询参数 extTimeOut 分机超时时间 false Int32
查询参数 screenWay 弹屏方式 - none：无弹屏；ext：分机默认弹屏；specify：指定弹屏； false Int32
查询参数 screenType 弹屏类型 - 当screenWay为specify时比传，other：指定第三方弹屏；crm：指定CRM弹屏 false Int32
查询参数 screenURL pageid(CRM编号和详情页编号用|分隔) false string


  • 结构响应

其中相应结果HTTP Code为200的string为json格式字符串，具体字段和字段值形式如下：

Result Data
success 成功描述
failed 失败描述


  • 返回值格式

application/json
{"result":"SUCCESS","code":100}

新增队列信息

  • 说明
方法: POST

前缀：http://ip:port/uucall_restapi/rest/

路径: /crm/field/business

参数校验：无
  • 示例
POST /crm/field/business HTTP/1.1

Host:192.168.2.1:2888

content-length: 139

Accept:application/xml;

Content-Type:application/xml;charset=utf-8;

appid:XXXX

timestamp:2016-03-11 00:00:00

Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=

{
    "name":"接口测试队列0",

    "mxwait":"5",

    "wtmusic":"/speech/1192/trans_begin.wav",

    "isloop":true,

    "wtsound":"/speech/1225/谢谢使用再见.wav",

    "interval":"5",

    "rule":"0",

    "ring":true,

    "report":true,

    "states":"0",

    "listTimeOut":"36",

    "extTimeOut":"36",

    "screenWay":"specify",

    "screenType":"crm",

    "screenURL":"20042&216"

}


  • 参数列表
类型 参数名 描述 是否必填 数据类型 默认值
查询参数 uid 用户编号 true Int64
查询参数 name 队列名称 false string
查询参数 mxwait 最大等待数 false Int32
查询参数 wtmusic 等待音乐路径 false string
查询参数 isloop 是否循环 false boolean
查询参数 wtsound 等待提示音路径 false string
查询参数 interval 提示间隔 0~60s false Int32
查询参数 rule 转接规则(0转队列 1转分机 2转语音导航 3转固定号码) false Int32
查询参数 ring 是否振铃 false boolean
查询参数 report 是否接通报工号 false boolean
查询参数 states 分机不可用状态(1通话中 2振铃 4帐号签出) false Int64
查询参数 listTimeOut 队列超时时间 false Int32
查询参数 extTimeOut 分机超时时间 false Int32
查询参数 screenWay 弹屏方式 - none：无弹屏；ext：分机默认弹屏；specify：指定弹屏； false Int32
查询参数 screenType 弹屏类型 - 当screenWay为specify时比传，other：指定第三方弹屏；crm：指定CRM弹屏 false Int32
查询参数 screenURL pageid(CRM编号和详情页编号用|分隔) false string


  • 结构响应

其中相应结果HTTP Code为200的string为json格式字符串，具体字段和字段值形式如下：

Result Data
success 成功描述
failed 失败描述


  • 返回值格式

application/json
{"result":"SUCCESS","code":100}

删除队列信息

  • 说明
方法: DELETE

前缀：http://ip:port/uucall_restapi/rest/

路径: /cti/telext/{telextid}

参数校验：无
  • 示例
DELETE /cti/telext/1888 HTTP/1.1

Host:192.168.2.1:2888

content-length: 139

Accept:application/xml;

Content-Type:application/xml;charset=utf-8;

appid:XXXX

timestamp:2016-03-11 00:00:00

Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=


  • 参数列表
类型 参数名 描述 是否必填 数据类型 默认值
查询参数 uid 企业帐号ID true Int64
查询参数 telextid 队列编号 true Int64


  • 结构响应

其中相应结果HTTP Code为200的string为json格式字符串，具体字段和字段值形式如下：

Result Data
success 成功描述
failed 失败描述


  • 返回值格式

application/json

取自“http://112.5.128.48:9988/index.php?title=分机/队列管理&oldid=255”