编辑用户呼叫转移配置

请求方法

PUT

请求地址

/users/{userId}/callForward

请求参数

参数	参数类型	数据类型	是否必需	描述
userId	Path	String	是	用户主键id，长度32
ringMode	Body	Integer	是	工作时间响铃模式,1：顺序响铃， 2：同时响铃
noAnswerForward	Body	Integer	是	工作时间无应答转移,1：断开忙音，2：语音信箱
answerTime	Body	Integer	否	同时响铃应答时间，默认60s，工作时间响铃模式为2时，工作时间转移队列里面的应答时间都将采用此值,范围[0,12,24,36,48,60,72,84,96,108,120]
callForwardQueue	Body	CallForwardQueue[]	否	工作时间转移队列，默认账号在线设备应答时间60s。最多不超过10个。 工作时间转移队列有传时，必须传一个且只能有一个转移目标为账号在线设备的否则呼叫转移队列无效

CallForwardQueue

参数名称	数据类型	是否必须	参数说明
enable	Boolean	否	是否启用，默认true
answerTime	Integer	否	应答时间(单位s),默认应答时间60s，范围[0,12,24,36,48,60,72,84,96,108,120]
forwardTargetType	Integer	是	转移目标类型， 0：账号在线设备，1：手机号码，2：外部号码，3：内部分机号，4：振铃组
forwardTarget	String	否	转移目标（纯数字），长度范围1-64。当转移目标类型为2,3,4时必填。转移目标类型为3时，转移目标为企业内部分机号； 转移目标类型为4时，转移目标为振铃组分机号

HTTP状态码

返回值	描述
200	操作成功，详见响应参数
400	客户端传参异常
401	鉴权失败
500	服务端异常

请求消息示例

PUT /open/api/v2/users/{userId}/callForward HTTP/1.1
Host: api.yealink.com
Content-Type: application/json
{
    "ringMode": 1,
    "noAnswerForward": 1,
    "callForwardQueue": [
        {
            "answerTime": 12,
            "forwardTargetType": 0,
            "forwardTarget": "0"
        },
        {
            "answerTime": 48,
            "forwardTargetType": 4,
            "forwardTarget": "112985"
        }
    ]
}

响应消息示例

HTTP/1.1 200 
Content-Type: application/json;charset=UTF-8

CURL命令示例

curl -XPUT -H 'Authorization: Bearer
eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM
0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXorKU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'timestamp:
1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' -H "Content-type: application/json" -d
'{"ringMode": 1,"noAnswerForward": 1,"callForwardQueue": [{ "answerTime": 12,"forwardTarget": 0,"number": "0"},{"answerTime": 48,"forwardTarget": 4, "number": "112985"}]}' 'https://api.yealink.com/open/api/v2/users/{userId}/callForward'