# 座席页面刷新时同步座席状态status和通话信息
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/caution_3.0-zh-cn.png)
该接口仅限在浏览器刷新后状态同步使用，调用此接口会清理事件队列。
#### 前置条件
- 座席已签入
 
#### 场景描述
座席页面刷新时同步座席状态status和通话信息。
#### 接口方法
设置成"POST"。该接口仅支持POST方法，不支持PUT、GET和DELETE等方法。
#### 接口URI
https://ip:port/agentgateway/resource/onlineagent/{agentid}/syncagentinfo
![](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。 |
   
#### 日志中的方法名
syncagentinfo
#### 请求说明
- 消息头
  表2请求头参数说明 
  | 序号 | 名称           | 参数类型   | 是否必选 | 说明                                                             |
  |:---|:---|:---|:---|:---|
  | 1  | Content-Type | string | True | 消息主体编码方式，缺省值：application/json;charset=UTF-8                    |
  | 2  | Guid         | string | True | 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 |
     
  

- 消息体 无
  
 
#### 响应说明
表3消息体参数说明 
| 序号 | 名称      | 参数类型   | 说明                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| 1  | message | string | 描述                                                                                                                                                                                                                                           |
| 2  | retcode | string | 错误码。取值如下： 0：成功 非0：失败                 |
| 3  | result  | object | 查询成功后，返回结果信息的对象。 该对象的参数说明请参见[表4]。 |
   
 表4result对象参数说明 
| 序号  | 名称             | 参数类型   | 说明                                                                                                                              |
|:---|:---|:---|:---|
| 3.1 | callinfo       | string | 通话信息。                                                                                                                           |
| 3.2 | agentStateInfo | object | 座席状态信息，该对象的参数说明请参见[表5]。 |
   
 表5agentStateInfo对象参数说明 
| 序号     | 名称                  | 参数类型    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| 3.2.1  | callFeature         | int     | 呼叫原始类型。特征ID，详细见[表6]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 3.2.2  | callData            | string  | 呼叫相关信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 3.2.3  | lastState           | int     | 座席最后的状态。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 3.2.4  | preBusy             | boolean | 是否示忙。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 3.2.5  | firsttalkingFlag    | boolean | 是否第一次通话。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 3.2.6  | workNo              | string  | 座席工号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 3.2.7  | qcWorkNo            | string  | qc座席工号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 3.2.8  | callerNo            | string  | 主叫号码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 3.2.9  | beginHoldTime       | string  | 开始保持时间，时间戳，单位：ms。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 3.2.10 | state               | int     | 座席状态。 详细状态码和含义请参见[表3](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0581.html#ZH-CN_TOPIC_0000002513073655__zh-cn_topic_0000002477949740_zh-cn_topic_0125397793_table876241916257)。                                                                                                                                                                                                                                                                                                                                                                  |
| 3.2.11 | talkingCallfeature  | int     | 通话呼叫原始类型，详细见[表6]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 3.2.12 | releaseFlag         | int     | 会话是否释放。 暂未使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 3.2.13 | calledNo            | string  | 被叫号码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 3.2.14 | mainCallId          | string  | 首次发起呼叫的callid。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 3.2.15 | secondTalkingTime   | string  | 第二次通话时间，时间戳，单位：ms。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 3.2.16 | preRest             | boolean | 是否休息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 3.2.17 | recordID            | string  | 录音流水号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 3.2.18 | currentTime         | string  | 当前时间，时间戳，单位：ms。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 3.2.19 | beginTalkingTime    | string  | 开始通话时间，时间戳，单位：ms。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 3.2.20 | partner             | string  | 合作方。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 3.2.21 | holdCallId          | string  | 保持的呼叫callid                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 3.2.22 | agentStateBeginTime | string  | 座席状态开始时间，时间戳，单位：ms。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 3.2.23 | curCommand          | int     | 当前命令，详细含义见[表7]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 3.2.24 | curCallId           | string  | 当前的呼叫callid。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 3.2.25 | cmdBeginTime        | string  | 命令开始时间，时间戳，单位：ms。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 3.2.26 | signInMode          | string  | 签入模式，取值范围： - 0：WebRTC  - 1：OpenEye   |
   
 表6**呼叫类型信息** 
| 状态值 | 说明        |
|:---|:---|
| -1  | 其他。       |
| 0   | 普通呼入。     |
| 6   | 内部呼叫。     |
| 7   | 普通呼叫。     |
| 41  | HPS预占式外呼。 |
| 44  | HPS预测式外呼。 |
| 45  | HPS预约回呼。  |
| 51  | 内部两方咨询。   |
| 52  | 内部三方咨询。   |
| 53  | 多方通话      |
   
 表7**操作命令信息** 
| 状态值 | 说明      |
|:---|:---|
| 0   | 无命令。    |
| 1   | 座席挂机。   |
| 2   | 座席断开连接。 |
| 3   | 用户挂机。   |
| 4   | 首次外呼。   |
| 5   | 外呼。     |
| 6   | 保持。     |
| 7   | 取消保持。   |
| 8   | 静音。     |
| 9   | 取消静音。   |
| 10  | 释放转。    |
| 11  | 成功转。    |
| 12  | 通话转。    |
| 13  | 三方转。    |
| 14  | 挂起转。    |
| 15  | 特殊转。    |
| 16  | 两方求助。   |
| 17  | 三方求助。   |
| 18  | 三方通话。   |
| 19  | 放音。     |
| 20  | 插入。     |
| 21  | 侦听。     |
| 22  | 切换。     |
| 23  | 拦截。     |
| 24  | 耳语。     |
| 30  | 示忙。     |
| 31  | 休息。     |
   
#### 触发事件
无
#### 错误结果码
- 100-007
- 100-011
 
#### 报文样例
- 消息头
  ```
  Content-Type:application/json;charset=UTF-8
  Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
  ```
  
- 请求参数 无
  
- 响应参数
  ```
  {
      "result": {
          "callinfo": null,
          "agentStateInfo": {
              "callFeature": 0,
              "callData": "",
              "lastState": 255,
              "preBusy": false,
              "firsttalkingFlag": false,
              "workNo": "41001",
              "qcWorkNo": "",
              "callerNo": "",
              "beginHoldTime": null,
              "state": 1,
              "talkingCallfeature": 0,
              "releaseFlag": 0,
              "calledNo": "",
              "mainCallId": "",
              "secondTalkingTime": null,
              "preRest": false,
              "recordID": "",
              "currentTime": "1566636307992",
              "beginTalkingTime": null,
              "partner": "",
              "holdCallId": "",
              "agentStateBeginTime": 1566636286408,
              "curCommand": 0,
              "curCallId": "",
              "cmdBeginTime": "",
              "cmdBeginTime": "",
          }
      },
      "message": "success",
      "retcode": "0"
  }
  ```