分机组管理

分机组管理 - 创建分机组

接口说明

创建分机组

请求方式

POST，form-data格式

请求参数

参数名 类型 是否必须 说明
service string 是 App.Sip_Extgroup.AddExtgroup
token string 是 通过授权接口获取的token
name string 是 分机组名
status int 否 分机组状态：0 启用；1 禁用，默认 0

接口请求示例（PHP）

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Extgroup.AddExtgroup',
        'token'     => 'ABCDEFG',
        'name'  => 'abcdefg',
        'status'  => 1
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结构示例

{
    "ret": 200,
    "data": {
        "status": 0,
        "desc": "分机组添加成功",
        "reqtime": 1581410934,
        "rsptime": 1581410934
    },
    "msg": ""
}

返回数据字段说明

参数名 类型 说明
status int 0修改成功，1修改失败
desc string 描述信息
result object 对象信息当前为空

分机组管理 - 删除分机组

接口说明

删除分机组

请求方式

POST，form-data格式

请求参数

参数名 类型 是否必须 说明
service string 是 App.Sip_Extgroup.DelExtgroup
token string 是 通过授权接口获取的token
name string 是 分机组名

接口请求示例（PHP）

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Extgroup.DelExtgroup',
        'token'     => 'ABCDEFG',
        'name'  => 'abcdefg',
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结构示例

{
    "ret":200,
    "data":{
        "status":0,
        "desc":"删除成功",
        "reqtime":1581409781,
        "rsptime":1581409781
    },
    "msg":""
}

返回数据字段说明

参数名 类型 说明
status int 0修改成功，1修改失败
desc string 描述信息
result object 对象信息当前为空

分机组管理 - 获取分机组列表

接口说明

获取当前用户拥有的分机组列表

请求方式

POST，form-data格式

请求参数

参数名 类型 是否必须 说明
service string 是 App.Sip_Extgroup.GetExtgroupInfo
token string 是 通过授权接口获取的token
name string 否 分机组名，为空则获取所有
currentpage int 否 页数，默认：1
itemsperpage int 否 每页数量，默认：10，最小：1；最大：1000

接口请求示例（PHP）

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Extgroup.GetExtgroupInfo',
        'token'     => 'ABCDEFG',
        'name'  => 'abcdefg',
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结构示例

{
"ret": 200,
"data": {
    "status": 0,
    "desc": "成功",
    "result": {
        "totalitems": 2,
        "currentpage": 1,
        "itemsperpage": 20,
        "extgroups": [
            {
                "id": 226,
                "name": "kefu03",
                "status": 1041,
                "createtime": "2026-09-17 07:45:54",
                "message": "坐席组已启用"
            },
            {
                "id": 227,
                "name": "kefu01",
                "status": 1041,
                "createtime": "2026-09-17 09:00:50",
                "message": "坐席组已启用"
            }
        ]
    },
    "reqtime": 1789610690,
    "rsptime": 1789610690
  },
  "msg": ""
}

返回字段说明

字段 类型 说明
result object 分机组对象
-totalitems int 分机总数
-currentpage int 当前页码
-itemsperpage int 每页默认值
-extgroups array 分机组列表数组
—id string 分机组id
—name string 分机组名
—status string 分机组状态码，1041：启用、1042：禁用

分机组管理 - 分机签出分机组

接口说明

将当前用户下的分机从分机组中签出

请求方式

POST，form-data格式

请求参数

参数名 类型 是否必须 说明
service string 是 App.Sip_Extgroup.DelExtnumber
token string 是 通过授权接口获取的token
name string 是 分机组名
extnumber string 是 分机号，多个以逗号分隔

接口请求示例（PHP）

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Extgroup.DelExtnumber',
        'token'     => 'ABCDEFG',
        'name'  => 'abcdefg',
        'extnumber'  => 'abcdefg'
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结构示例

{
    "ret": 200,
    "data": {
        "status": 0,
        "desc": "删除成功",
        "reqtime": 1581409508,
        "rsptime": 1581409508
    },
    "msg": ""
}

返回数据字段说明

字段 类型 说明
desc string 返回描述

分机组管理 - 分机签入分机组

接口说明

将当前用户下的一个分机签入到用户拥有的一个分机组

请求方式

POST，form-data格式

请求参数

参数名 类型 是否必须 说明
service string 是 App.Sip_Extgroup.AddExtnumber
token string 是 通过授权接口获取的token
name string 是 分机组名
extnumber string 是 分机号，多个以逗号分隔

接口请求示例（PHP）

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Extgroup.AddExtnumber',
        'token'     => 'ABCDEFG',
        'name'  => 'abcdefg',
        'extnumber'  => 'abcdefg'
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结构示例

{
    "ret": 200,
    "data": {
        "status": 0,
        "desc": "添加成功",
        "reqtime": 1581409508,
        "rsptime": 1581409508
    },
    "msg": ""
}

返回数据字段说明

字段 类型 说明
desc string 返回描述

分机组管理 - 分机示闲示忙状态设置

接口说明

设置分机的闲忙状态

请求方式

POST，form-data格式

请求参数

参数名 类型 是否必须 说明
service string 是 App.Sip_Extgroup.EditExtnumber
token string 是 通过授权接口获取的token
name string 是 分机组名
extnumber string 是 分机号
state string 是 分机状态 idle：示闲；busy：示忙

接口请求示例（PHP）

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Extgroup.EditExtnumber',
        'token'     => 'ABCDEFG',
        'name'  => 'abcdefg',
        'extnumber'  => '100001',
        'state'  => 'idle'
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结构示例

{
    "ret": 200,
    "data": {
        "status": 0,
        "desc": "修改成功",
        "reqtime": 1581409508,
        "rsptime": 1581409508
    },
    "msg": ""
}

返回数据字段说明

字段 类型 说明
desc string 返回描述

分机组管理 - 获取分机组成员信息

接口说明

获取分机组中的分机状态

请求方式

POST，form-data格式

请求参数

参数名 类型 是否必须 说明
service string 是 App.Sip_Extgroup.GetGroupExt
token string 是 通过授权接口获取的token
name string 否 分机组名，为空则获取当前用户所有分机组数据
extnumber string 否 分机号，为空则获取当前用户所有分机数据
currentpage int 否 页数，默认：1
itemsperpage int 否 每页数量，默认：10，最小：1；最大：1000

接口请求示例（PHP）

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Extgroup.GetGroupExt',
        'token'     => 'ABCDEFG',
        'name'  => 'abcdefg',
        'extnumber'  => 'abcdefg'
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结构示例

{
"ret": 200,
"data": {
    "status": 0,
    "desc": "成功",
    "result": {
        "totalitems": 1,
        "currentpage": 1,
        "itemsperpage": 20,
        "extensions": [
            {
                "name": "kefu01",
                "extnumber": "6853880001",
                "status": "hangup",
                "weight": 1,
                "linkcount": 0,
                "date": null,
                "state": "idle"
            }
        ]
    },
    "reqtime": 1789612335,
    "rsptime": 1789612335
},
"msg": ""
}

返回数据字段说明

字段 类型 说明
result object 分机列表分页信息
-totalitems int 分机总数
-currentpage int 当前页码
-itemsperpage int 每页默认值
-extensions string 分机号数据数组
—name string 分机组名
—extnumber string 分机号
—status string 分机状态 answer：应答；hangup：挂断
—priority string 优先级
—linkcount string 通话时长
—date string 更新时间
—state string 分机闲忙状态 idle：示闲； busy：示忙

分机组管理 - 根据成员查询坐席组

接口说明

根据坐席账号查询坐席所在的坐席组

请求方式

POST，form-data格式

请求参数

参数名 类型 是否必须 说明
service string 是 App.Sip_Extgroup.GetAllExtGroup
token string 是 通过授权接口获取的token
extnumber string 是 坐席账号

接口请求示例（PHP）

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Extgroup.GetAllExtGroup',
        'token'     => 'ABCDEFG',
        'extnumber'  => '7001',
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结构示例

{
    "ret": 200,
    "data": {
        "status": 0,
        "desc": "成功",
        "result": [
                {
                    "name": "kefu01"
                }
            ]
        "reqtime": 1789611195,
        "rsptime": 1789611195
    },
    "msg": ""
}

返回字段说明

字段 类型 说明
result array 分机成员信息
—name string 分机组名

分机组管理 - 获取分机组成员状态数

接口说明

获取分机组各个状态的成员数

请求方式

POST，form-data格式

请求参数

参数名 类型 是否必须 说明
service string 是 App.Sip_Extgroup.GetExtGroupState
token string 是 通过授权接口获取的token
name string 是 坐席组名称

接口请求示例（PHP）

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Extgroup.GetExtGroupState',
        'token'     => 'ABCDEFG',
        'name'  => 'kefu01',
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结构示例

{
"ret": 200,
"data": {
    "status": 0,
    "desc": "成功",
    "result": [
          {
            "name": "kefu01",
            "total": 1,
            "free": 1,
            "work": 0,
            "busy": 0
          }
        ],
        "reqtime": 1789611415,
        "rsptime": 1789611415
    },
    "msg": ""
}

返回字段说明

字段 类型 说明
result string 分机列表数组
—name string 分机组id
—total string 分机组名
—free string 空闲状态
—work string 工作状态
—busy string 置忙状态