# 申请座席会议
#### 前置条件
- 座席已签入
 
#### 场景描述
座席调用该接口申请一个座席会议，调用成功后则需要等待后续的异步事件，申请成功后，申请会议的座席会成为会议主席。申请会议的座席接收到AgentConf_SelfJoinResult事件，表明申请会议的座席自身已加入到会议中，但还需要继续等待AgentConf_RequestSuccess事件后，座席才能进行会议主席相关的操作。在收到AgentConf_RequestSuccess事件前，座席调用会议相关的接口操作时，平台会直接返回失败。
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/notice_3.0-zh-cn.png)
- 当前座席处于空闲或者通话状态，处于通话状态时当前呼叫必须处于一个稳定状态，否则申请座席会议会失败，例如：在通话过程中进行放音、静音、保持呼叫、挂起、转座席，则申请座席会议会返回失败。
- 三方通话过程中如果存在两个座席，被叫座席不允许发起座席会议。
- 与会者类型仅支持座席工号或电话号码。
- 电话会议方数小于等于vdn中设置的"并发语音最大呼叫数"。
 
#### 接口方法
设置成"POST"。该接口仅支持POST方法，不支持GET、PUT和DELETE等方法。
#### 接口URI
https://ip:port/agentgateway/resource/agentconf/{agentid}/requestagentconf
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png)
如果CC-Gateway单机部署，IP地址为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号，默认值为8043；如果CC-Gateway采用集群模式部署，IP请配置为NSLB地址， Port请配置为默认值8043。
NSLB上的CC-Gateway端口号，请以nslb用户登录任意一个NSLB节点，执行./nslbctl l查询，查询结果中，如下端口表示CC-Gateway通过NSLB面向第三方系统开放的端口。
![](https://support.huaweicloud.com/api-ccfs-cec/figure/zh-cn_image_0000002204207349.png)
SaaS场景下请咨询运维人员获取IP和Port。
表1URI中携带的参数说明 
| 序号 | 参数名     | 数据类型   | 选取原则 | 说明                     |
|:---|:---|:---|:---|:---|
| 1  | agentid | string | True | 座席的工号，取值范围：101～999999。 |
   
#### 日志中的方法名
requestAgentConf
#### 请求说明
- 消息头
  表2请求头参数说明 
  | 序号 | 名称           | 参数类型   | 是否必选 | 说明                                                             |
  |:---|:---|:---|:---|:---|
  | 1  | Content-Type | string | True | 消息主体编码方式，缺省值：application/json;charset=UTF-8                    |
  | 2  | Guid         | string | True | 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 |
     
  

- 消息体
  表3消息体参数说明 
  | 序号 | 名称           | 参数类型    | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  |:---|:---|:---|:---|:---|
  | 1  | memberNum    | int     | True  | 会场能够容纳的与会人数。 取值范围：1～120。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  | 2  | confCallerNo | String  | False | 会议外呼用户时显示的主叫号码。 最大长度为24字节。 不输入参数时，平台默认使用VDN配置台基本信息的系统主叫号码。在VDN有号码限制的情况，需要号码在限制范围内。                                                                                                                                                                                                                                                                                                                                                                                 |
  | 3  | time         | int     | False | 会议申请时长。 单位：分钟。 取值范围：4～1440。 默认值为60。                                                                                                                                                                                                                                                                                                |
  | 4  | promptTime   | int     | False | 会议结束前提示时长。 可选参数。 单位：分钟。 取值范围：3～1440。 默认值为3。 如果大于等于会议申请时长，按照申请时长-1计算。 |
  | 5  | beepTone     | boolean | False | 有用户加入、退出会议时是否播放提示音。 默认值为false。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | 6  | playMode     | int     | False | 2：播放指定文件音，默认值为2。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | 7  | voicePath    | String  | False | 文件绝对路径名。文件格式为: 盘符/conf/vdn编号/放音文件名，例如： y:/conf/120/1136287.V3 当"BeepTone"设置为"true"时，此参数必须设置并且playMode需要为2；当"BeepTone"设置为"false"时，此参数设置无效。 最大长度为127。                                                                                                                                                                                                                                                                                                                |
     
  
 
#### 响应说明
表4消息体参数说明 
| 序号 | 名称      | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| 1  | message | string | 描述 说明： 当出现错误提示"Unknown ERROR._\*\*\*\*\*"时，\*\*\*\*\*表示CTI错误结果码，详情请参见[表2](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0580.html#ZH-CN_TOPIC_0000002481273748__zh-cn_topic_0000002478109716_zh-cn_topic_0125397792_table1358143552019)。 |
| 2  | retcode | string | 错误码。取值如下： 0：成功 非0：失败                                                                                                                                                                                                                              |
| 3  | result  | object | 预留字段                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   
#### 触发事件
- 通话中（AgentState_Busy）
- 物理话机振铃（AgentOther_PhoneAlerting）
- 物理话机摘机（AgentOther_PhoneOffhook）
- 自己加入会议（AgentConf_SelfJoinResult）
- 会议申请成功（AgentConf_RequestSuccess）
- 会议申请失败（AgentConf_RequestFailed）
- 会议结束前提示时长：会议超时提醒事件（AgentConf_Timeout）
 
#### 错误结果码
- 000-002
- 100-006
- 100-007
 
#### 报文样例
- 消息头
  ```
  Content-Type:application/json;charset=UTF-8
  Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
  ```
  
- 请求参数
  ```
  {
      "memberNum": 4,
      "confCallerNo": "10000",
      "time": 50,
      "promptTime": 5,
      "beepTone": true,
      "playMode": 2,
      "voicePath": "y:/conf/120/1136287.V3"
  }
  ```
  
- 响应参数
  ```
  {
    "result": {},
    "message": "success",
    "retcode": "0"
  }
  ```