单个创建接入码与技能队列、IVR绑定关系(createCalledRoute)
场景描述
单个创建接入码与技能队列、IVR绑定关系的接口
接口方法
POST
接口URI
https://域名/apiaccess/rest/cc-management/v1/calledRoute/createCalledRoute,例如域名是service.besclouds.com
请求说明
| 
        序号  | 
      
        名称  | 
      
        参数类型  | 
      
        是否必选  | 
      
        说明  | 
     
|---|---|---|---|---|
| 
        1  | 
      
        X-APP-Key  | 
      
        string  | 
      
        False  | 
      
        appKey字段,用户标识,请联系运营人员获取appKey  | 
     
| 
        2  | 
      
        Authorization  | 
      
        string  | 
      
        True  | 
      
        鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格)  | 
     
| 
        序号  | 
      
        名称  | 
      
        参数类型  | 
      
        是否必选  | 
      
        说明  | 
     
|---|---|---|---|---|
| 
        1.1  | 
      
        accessCode  | 
      
        string  | 
      
        True  | 
      
        接入码;最大长度32字符  | 
     
| 
        1.2  | 
      
        extCode  | 
      
        string  | 
      
        False  | 
      
        扩展码; 最大长度12字符(如果希望一个接入码能设置多个目的设备。这种情况下可通过配置扩展码的方式来实现,例如,接入码为12345,我们可以添加扩展码1,路由到技能队列A,扩展码2,路由到技能队列B。这样客户可直接拨打123451实现直接接入技能队列A。)  | 
     
| 
        1.3  | 
      
        mediaTypeId  | 
      
        integer  | 
      
        False  | 
      
        媒体类型;默认值:5 字段可选值:(2:语音点击通话 5:音视频 18:视频点击通话 19:视频 53:多媒体) 说明: 1、传入技能队列(devicetype=1)时,mediaTypeId等于传入的技能队列绑定的mediaTypeId(没有绑定默认5) 2、接入码accessCode所属的媒体类型(查询接入码接口返回的mediaTypeId字段)和该入参mediaTypeId的对应关系如下: 5对应5和19; 53对应53; 2对应2和18  | 
     
| 
        1.4  | 
      
        devicetype  | 
      
        integer  | 
      
        True  | 
      
        设备类型; 1:技能队列 3:IVR 说明:多媒体渠道不能选择IVR流程  | 
     
| 
        1.5  | 
      
        deviceId  | 
      
        integer  | 
      
        True  | 
      
        目标设备id(技能队列skillId、IVR的id) 说明:传入技能队列(devicetype=1)时,deviceId的对应的媒体类型要和入参mediaTypeId一致  | 
     
响应说明
- 响应状态码: 200
    
表3 响应体参数 序号
名称
参数类型
是否必选
说明
1.1
returnCode
string
False
返回码 0:成功 其他:失败
1.2
description
string
False
描述
 - 响应状态码: 400
    
错误的请求:请检查请求路径及参数
 - 响应状态码: 401
    
未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
 - 响应状态码: 403
    
鉴权失败
 - 响应状态码: 404
    
请求的内容未找到:请检查请求的路径。
 - 响应状态码: 500
    
业务失败:请依次确认您请求中各参数的取值。
 
错误码
无。
报文样例
请求头:
Content-Type:application/json Authorization:Bearer XXXXXXXXXXXXXXXXXXXXXXX X-APP-Key:XXXXXXXXXXXXXXXXXXXXXXX
请求参数:
{
    "accessCode": "9911411", 
    "extCode": "11",
    "devicetype": 1, 
    "deviceId": 1,
    "mediaTypeId": 19
}
  响应参数:
{
    "returnCode": "0",
    "description": "data create success"
}