Synchronizing the Agent Status and Call Information When the Agent Page Is Refreshed

This interface is used only for status synchronization after the browser is refreshed. Invoking this interface will clear the event queue.

Prerequisites

The agent has signed in.

Description

This interface is used to synchronize the agent status and call information when the agent page is refreshed.

Interface Method

The request method must be set to POST. This interface supports only the POST method.

URI

https://IP address:Port number/agentgateway/resource/onlineagent/{agentid}/syncagentinfo

If the CC-Gateway is deployed in single-node mode, set IP address to the CC-Gateway server address and Port number to the HTTPS port number of the CC-Gateway server (the default value is 8043). If the CC-Gateway is deployed in cluster mode, set IP address to the NSLB address and Port number to the default value 8043.

For the CC-Gateway port number on the NSLB, log in to any NSLB node as the nslb user and run the ./nslbctl l command to query the port number. In the query result, the following port is opened by the CC-Gateway to third-party systems through the NSLB.

In the SaaS scenario, contact O&M personnel to obtain the values of IP address and Port number.

**Table 1** Parameter in the URI
No.	Parameter	Value Type	Mandatory (Yes/No)	Description
1	agentid	String	Yes	Agent ID. The value ranges from 101 to 999999.

Method Name in Logs

syncagentinfo

Request Description

Message header

**Table 2** Parameters in the request message header
No.	Parameter	Value Type	Mandatory (Yes/No)	Description
1	Content-Type	String	Yes	Coding mode of the message body. The default value is application/json; charset=UTF-8.
2	Guid	String	Yes	GUID returned by the sign-in interface during static authentication (AUTHMODE is set to 1) or GUID returned by the polling event query interface during dynamic authentication (AUTHMODE is set to 2).

Message body
None

Response Description

**Table 3** Parameters in the message body
No.	Parameter	Value Type	Description
1	message	String	Description.
2	retcode	String	Error code. The options are as follows: 0: success Other values: failure
3	result	Object	Object in the returned result after a successful query. For details about the parameters of this object, see Table 4.

**Table 4** Parameter description of result
No.	Parameter	Value Type	Description
3.1	callinfo	String	Indicates the call information.
3.2	agentStateInfo	Object	Agent status information. Table 5 describes the parameters of this object.

**Table 5** Parameter description of agentStateInfo
No.	Parameter	Value Type	Description
3.2.1	callFeature	Integer	Indicates the original call type. Feature ID. For details, see Table 6.
3.2.2	callData	String	Indicates the call-related information
3.2.3	lastState	Integer	Indicates the last status of an agent.
3.2.4	preBusy	Boolean	Indicates whether to show busy.
3.2.5	firsttalkingFlag	Boolean	Indicates whether the call is the first call.
3.2.6	workNo	String	Agent ID.
3.2.7	qcWorkNo	String	Indicates the ID of an inspector.
3.2.8	callerNo	String	Calling number.
3.2.9	beginHoldTime	String	Start hold time. The value is a timestamp, in milliseconds.
3.2.10	state	Integer	Agent status. For details about the status code and its meaning, see Table 3.
3.2.11	talkingCallfeature	Integer	Original call type. For details, see Table 6.
3.2.12	releaseFlag	Integer	Indicates whether a session is released. This parameter is reserved.
3.2.13	calledNo	String	Called number.
3.2.14	mainCallId	String	Indicates the callid of the first call.
3.2.15	secondTalkingTime	String	Second call duration. The value is a timestamp, in milliseconds.
3.2.16	preRest	Boolean	Indicates whether to take a rest.
3.2.17	recordID	String	Indicates the serial number of the recording.
3.2.18	currentTime	String	Current time. The value is a timestamp, in milliseconds.
3.2.19	beginTalkingTime	String	Start call duration. The value is a timestamp, in milliseconds.
3.2.20	partner	String	Partner.
3.2.21	holdCallId	String	Indicates the callid of the holding call.
3.2.22	agentStateBeginTime	String	Start time of the agent state. The value is a timestamp, in milliseconds.
3.2.23	curCommand	Integer	Current command. For details, see Table 7.
3.2.24	curCallId	String	Indicates the callid of the current call.
3.2.25	cmdBeginTime	String	Command start time. The value is a timestamp, in milliseconds.
3.2.26	signInMode	String	Sign-in mode. The options are as follows: 0: WebRTC 1: OpenEye

**Table 6** Call type information
State Value	Description
-1	Others.
0	Common inbound call.
6	Internal call.
7	Common call.
41	HPS preempted outbound call.
44	HPS predicted outbound call.
45	HPS reserved callback.
51	Internal two-party consultation.
52	Internal three-party consultation.
53	Multi-party call.

**Table 7** Operation command information
State Value	Description
0	None.
1	The agent hooks on a call.
2	The agent is disconnected.
3	The called party hangs up.
4	First outbound call.
5	Outbound call.
6	Hold state.
7	Unhold state.
8	Mute state.
9	Unmute state.
10	Blind transfer.
11	Release-after-transfer.
12	Talk forwarding.
13	Release-after-three-way-talk forwarding.
14	Hang-up transfer.
15	Special transfer.
16	Two-party help.
17	Three-party help.
18	Three-party call.
19	Playback state.
20	Insertion.
21	Listen.
22	Switch.
23	Intercept.
24	Whisper.
30	Show busy.
31	Rest.

Triggered Event

None

Error Code

100-007
100-011

Example

Message header

Content-Type:application/json; charset=UTF-8
Guid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1

Request parameter
None

Response parameter

{
    "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"
}

Parent topic: Agent Operation Interfaces: onlineagent

Previous topic: Actively Requesting to Update the GUID When the Agent Page Is Refreshed

Next topic: Obtaining Token Information