查询多个分机组信息

同时查询多个分机组的详细信息。

请求 URL

GET {base_url}/{api_path}/extensiongroup/query?access_token={access_token}

请求参数


参数	是否必填	类型	说明
ids	是	String	分机组的唯一 ID。注：可使用搜索特定分机组接口查询分机组的唯一 ID。使用半角逗号 `,` 分隔多个分机组 ID。

响应参数


参数	类型	说明
errcode	Integer	返回错误码。 `0`：请求成功。非零值：请求失败。注：更多错误码和错误信息说明，请参见错误码 & 错误信息。
errmsg	String	返回信息。 `SUCCESS`：请求成功。 `FAILURE`：请求失败。
data	Array <ExtGroup_DetailInfo>	分机组的详细信息。

ExtGroup_DetailInfo


参数	类型	说明
id	Integer	分机组的唯一 ID。
member_select	String	分机组成员的添加方式。 `sel_all_ext`：添加所有分机。 `sel_specific`：仅添加指定分机。
members	Array<Member_info>	成员分机的详细信息。
mgr_enb_chg_presence 适用分机组管理员	Integer	管理员是否可在话务控制台修改分机组成员的在线状态。 `0`：禁用 `1`：启用
mgr_enb_call_distribution 适用分机组管理员	Integer	管理员是否可在话务控制台分配来电，包括转移、转接、拖拽等操作。 `0`：禁用 `1`：启用
mgr_enb_call_conn 适用分机组管理员	Integer	管理员是否可在话务控制台截答或挂断其他分机的通话。 `0`：禁用 `1`：启用
mgr_enb_monitor 适用分机组管理员	Integer	管理员是否可在话务控制台监听通话。 `0`：禁用 `1`：启用
mgr_enb_call_park 适用分机组管理员	Integer	管理员是否可在话务控制台停泊和取回通话。 `0`：禁用 `1`：启用
mgr_enb_ctrl_ivr 适用分机组管理员	Integer	管理员是否可在话务控制台控制 IVR 来电，不受 IVR 菜单限制。 `0`：禁用 `1`：启用
mgr_enb_ctrl_call_flow 适用分机组管理员	Integer	管理员是否可在话务控制台控制通话流程。 `0`：禁用 `1`：启用
mgr_enb_ctrl_ai_receptionist 适用分机组管理员	Integer	管理员是否可在话务控制台控制 AI 接待员的通话。 `0`：禁用 `1`：启用
mgr_enb_office_time_switch 适用分机组管理员	Integer	管理员是否可在话务控制台切换办公时间和假期状态。 `0`：禁用 `1`：启用
mgr_enb_mgr_recording 适用分机组管理员	Integer	管理员是否可在话务控制台切换分机的录音状态。 `0`：禁用 `1`：启用
mgr_enb_company_contact_match 适用分机组管理员	Integer	管理员是否可在话务控制台识别企业联系人的来电，即使其无权查看该联系人。 `0`：禁用 `1`：启用
mgr_enb_ext_call_distribution 适用分机组管理员	Integer	管理员是否可在分机页面分配来电，包括转移、转接操作。 `0`：禁用 `1`：启用
mgr_enb_ext_call_conn 适用分机组管理员	Integer	管理员是否可在分机页面截答或挂断其他分机的通话。 `0`：禁用 `1`：启用
mgr_enb_ext_monitor 适用分机组管理员	Integer	管理员是否可在分机页面监听通话。 `0`：禁用 `1`：启用
mgr_enb_ext_call_park 适用分机组管理员	Integer	管理员是否可在分机页面停泊和取回通话。 `0`：禁用 `1`：启用
mgr_enb_ext_call_flow 适用分机组管理员	Integer	管理员是否可在分机页面控制通话流程。 `0`：禁用 `1`：启用
mgr_enb_ext_ai_receptionist 适用分机组管理员	Integer	管理员是否可在分机页面管理 AI 接待员的通话。 `0`：禁用 `1`：启用
mgr_enb_ext_company_contact_match 适用分机组管理员	Integer	管理员是否可在分机页面识别企业联系人的来电，即使其无权查看该联系人。 `0`：禁用 `1`：启用
user_enb_chg_presence 适用分机组用户	Integer	用户是否可在话务控制台修改分机组成员的在线状态。 `0`：禁用 `1`：启用
user_enb_call_distribution 适用分机组用户	Integer	用户是否可在话务控制台分配来电，包括转移、转接、拖拽等操作。 `0`：禁用 `1`：启用
user_enb_call_conn 适用分机组用户	Integer	用户是否可在话务控制台截答或挂断其他分机的通话。 `0`：禁用 `1`：启用
user_enb_monitor 适用分机组用户	Integer	用户是否可在话务控制台监听通话。 `0`：禁用 `1`：启用
user_enb_call_park 适用分机组用户	Integer	用户是否可在话务控制台停泊和取回通话。 `0`：禁用 `1`：启用
user_enb_ctrl_ivr 适用分机组用户	Integer	用户是否可在话务控制台控制 IVR 通话，不受 IVR 菜单限制。 `0`：禁用 `1`：启用
user_enb_ctrl_call_flow 适用分机组用户	Integer	用户是否可在话务控制台控制通话流程。 `0`：禁用 `1`：启用
user_enb_ctrl_ai_receptionist 适用分机组用户	Integer	用户是否可在话务控制台控制 AI 接待员的通话。 `0`：禁用 `1`：启用
user_enb_company_contact_match 适用分机组用户	Integer	用户是否可在话务控制台识别企业联系人的来电，即使其无权查看企业联系人。 `0`：禁用 `1`：启用
user_enb_ext_call_distribution 适用分机组用户	Integer	用户是否可在分机页面分配来电，包括转移、转接等操作。 `0`：禁用 `1`：启用
user_enb_ext_call_conn 适用分机组用户	Integer	用户是否可在分机页面截答或挂断其他分机的通话。 `0`：禁用 `1`：启用
user_enb_ext_monitor 适用分机组用户	Integer	用户是否可在分机页面监听通话。 `0`：禁用 `1`：启用
user_enb_ext_call_park 适用分机组用户	Integer	用户是否可在分机页面停泊和取回通话。 `0`：禁用 `1`：启用
user_enb_ext_call_flow 适用分机组用户	Integer	用户是否可在分机页面控制通话流程。 `0`：禁用 `1`：启用
user_enb_ext_ai_receptionist 适用分机组用户	Integer	用户是否可在分机页面控制 AI 接待员的通话。 `0`：禁用 `1`：启用
user_enb_ext_company_contact_match 适用分机组用户	Integer	用户是否可在分机页面识别企业联系人的来电，即使其无权限查看企业联系人。 `0`：禁用 `1`：启用
name	String	分机组名称。

Member_info


参数	类型	说明
ext_id	Integer	分机的唯一 ID。
ext_num	String	分机号码。
first_name	String	名字。
last_name	String	姓氏。
role	String	分机在该分机组中的角色。 `manager`：管理员 `user`：用户 `custom`：自定义
enb_chg_presence 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台修改分机组成员的在线状态。 `0`：禁用 `1`：启用
enb_call_distribution 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台分配来电，包括转移、转接、拖拽等操作。 `0`：禁用 `1`：启用
enb_call_conn 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台截答或挂断其他分机的通话。 `0`：禁用 `1`：启用
enb_monitor 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台监听通话。 `0`：禁用 `1`：启用
enb_call_park 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台停泊和取回通话。 `0`：禁用 `1`：启用
enb_ctrl_ivr 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台控制 IVR 来电，不受 IVR 菜单限制。 `0`：禁用 `1`：启用
enb_ctrl_call_flow 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台控制通话流程。 `0`：禁用 `1`：启用
enb_ctrl_ai_receptionist 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台控制 AI 接待员的通话。 `0`：禁用 `1`：启用
enb_office_time_switch 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台切换办公时间和假期状态。 `0`：禁用 `1`：启用
enb_mgr_recording 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台切换分机的录音状态。 `0`：禁用 `1`：启用
enb_company_contact_match 适用分机组自定义用户	Integer	自定义用户是否可在话务控制台识别企业联系人的来电，即使其无权查看该联系人。 `0`：禁用 `1`：启用
enb_ext_call_distribution 适用分机组自定义用户	Integer	自定义用户是否可在分机页面分配来电，包括转移、转接操作。 `0`：禁用 `1`：启用
enb_ext_call_conn 适用分机组自定义用户	Integer	自定义用户是否可在分机页面截答或挂断其他分机的通话。 `0`：禁用 `1`：启用
enb_ext_monitor 适用分机组自定义用户	Integer	自定义用户是否可在分机页面监听通话。 `0`：禁用 `1`：启用
enb_ext_call_park 适用分机组自定义用户	Integer	自定义用户是否可在分机页面停泊和取回通话。 `0`：禁用 `1`：启用
enb_ext_call_flow 适用分机组自定义用户	Integer	自定义用户是否可在分机页面控制通话流程。 `0`：禁用 `1`：启用
enb_ext_ai_receptionist 适用分机组自定义用户	Integer	自定义用户是否可在分机页面管理 AI 接待员的通话。 `0`：禁用 `1`：启用
enb_ext_company_contact_match 适用分机组自定义用户	Integer	自定义用户是否可在分机页面识别企业联系人的来电，即使其无权查看该联系人。 `0`：禁用 `1`：启用

示例

请求示例

查询分机组的详细信息 (ID: 178 & 307)。

GET /openapi/v1.0/extension/query?access_token=u04QYrGUwVsivUfszru0VwZzqNSbRbrt&ids=178,307 HTTP/1.1 

Host: yeastardocs.example.yeastarcloud.com

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "data": [
        {
            "id": 178,
            "name": "Docs",
            "member_select": "sel_specific",
            "members": [
                {
                    "ext_id": 159,
                    "ext_num": "1000",
                    "first_name": "Leo Ball",
                    "last_name": "",
                    "role": "manager"
                },
                {
                    "ext_id": 10,
                    "ext_num": "1001",
                    "first_name": "Phillip Huff",
                    "last_name": "",
                    "role": "manager"
                }
            ],
            "mgr_enb_monitor": 1,
            "mgr_enb_call_conn": 1,
            "mgr_enb_call_distribution": 1,
            "mgr_enb_call_park": 1,
            "mgr_enb_ctrl_ivr": 1,
            "mgr_enb_office_time_switch": 0,
            "mgr_enb_mgr_recording": 0,
            "mgr_enb_chg_presence": 1,
            "user_enb_call_distribution": 0,
            "user_enb_call_conn": 0,
            "user_enb_monitor": 0,
            "user_enb_call_park": 0,
            "user_enb_chg_presence": 0,
            "mgr_enb_company_contact_match": 0,
            "user_enb_company_contact_match": 0,
            "user_enb_ctrl_ivr": 0,
            "mgr_enb_ext_call_distribution": 1,
            "mgr_enb_ext_call_conn": 1,
            "mgr_enb_ext_monitor": 1,
            "mgr_enb_ext_call_park": 1,
            "mgr_enb_ext_company_contact_match": 0,
            "user_enb_ext_call_distribution": 0,
            "user_enb_ext_call_conn": 0,
            "user_enb_ext_monitor": 0,
            "user_enb_ext_call_park": 0,
            "user_enb_ext_company_contact_match": 0,
            "mgr_enb_ctrl_call_flow": 1,
            "mgr_enb_ext_call_flow": 1,
            "user_enb_ctrl_call_flow": 0,
            "user_enb_ext_call_flow": 0,
            "mgr_enb_ctrl_ai_receptionist": 1,
            "mgr_enb_ext_ai_receptionist": 0,
            "user_enb_ctrl_ai_receptionist": 0,
            "user_enb_ext_ai_receptionist": 0
        },
        {
            "id": 307,
            "name": "test",
            "member_select": "sel_specific",
            "members": [
                {
                    "ext_id": 159,
                    "ext_num": "1000",
                    "first_name": "Leo Ball",
                    "last_name": "",
                    "role": "manager"
                },
                {
                    "ext_id": 10,
                    "ext_num": "1001",
                    "first_name": "Phillip Huff",
                    "last_name": "",
                    "role": "custom",
                    "enb_chg_presence": 1,
                    "enb_call_distribution": 1,
                    "enb_call_conn": 1,
                    "enb_monitor": 1,
                    "enb_call_park": 1,
                    "enb_ctrl_ivr": 1,
                    "enb_office_time_switch": 1,
                    "enb_mgr_recording": 1,
                    "enb_company_contact_match": 1,
                    "enb_ext_call_distribution": 1,
                    "enb_ext_call_conn": 1,
                    "enb_ext_monitor": 1,
                    "enb_ext_call_park": 1,
                    "enb_ctrl_call_flow": 1,
                    "enb_ext_call_flow": 1,
                    "enb_ext_company_contact_match": 1
                },
                {
                    "ext_id": 4,
                    "ext_num": "1002",
                    "first_name": "Terrell Smith",
                    "last_name": "",
                    "role": "user"
                }
            ],
            "mgr_enb_monitor": 1,
            "mgr_enb_call_conn": 1,
            "mgr_enb_call_distribution": 1,
            "mgr_enb_call_park": 1,
            "mgr_enb_ctrl_ivr": 1,
            "mgr_enb_office_time_switch": 0,
            "mgr_enb_mgr_recording": 0,
            "mgr_enb_chg_presence": 1,
            "user_enb_call_distribution": 0,
            "user_enb_call_conn": 0,
            "user_enb_monitor": 0,
            "user_enb_call_park": 0,
            "user_enb_chg_presence": 0,
            "mgr_enb_company_contact_match": 0,
            "user_enb_company_contact_match": 0,
            "user_enb_ctrl_ivr": 0,
            "mgr_enb_ext_call_distribution": 1,
            "mgr_enb_ext_call_conn": 1,
            "mgr_enb_ext_monitor": 1,
            "mgr_enb_ext_call_park": 1,
            "mgr_enb_ext_company_contact_match": 0,
            "user_enb_ext_call_distribution": 0,
            "user_enb_ext_call_conn": 0,
            "user_enb_ext_monitor": 0,
            "user_enb_ext_call_park": 0,
            "user_enb_ext_company_contact_match": 0,
            "mgr_enb_ctrl_call_flow": 1,
            "mgr_enb_ext_call_flow": 1,
            "user_enb_ctrl_call_flow": 0,
            "user_enb_ext_call_flow": 0,
            "mgr_enb_ctrl_ai_receptionist": 1,
            "mgr_enb_ext_ai_receptionist": 1,
            "user_enb_ctrl_ai_receptionist": 0,
            "user_enb_ext_ai_receptionist": 0
        }
    ]
}