Querying the Details About a Specified Agent

Prerequisites

• The agent has signed in.

Description

This interface is used to query the details about a specified agent by agent ID after the agent has signed in.

Interface Method

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

URI

https://IP address:Port number/agentgateway/resource/agentgroup/{agentid}/agentbyworkno/{workno}

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.

Method Name in Logs

queryAgentInfoByWorkNo

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

Triggered Event

• None

Error Code

• 100-006
• 100-007

Example

• Message header

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

• Request parameter

  None

• Response parameter

  {
      "message": "",
      "retcode": "0",
      "result": {
          "workno": "20011",
          "name": "20011",
          "status": "4",
          "ctiStatus": "1",
          "groupid": 1,
          "groupname": "jst",
          "skilllist": [
              {
                  "name": "clicktodial_jst",
                  "id": 10,
                  "mediatype": 2
              },
              {
                  "name": "callback",
                  "id": 2,
                  "mediatype": 4
              },
              {
                  "name": "webchat",
                  "id": 3,
                  "mediatype": 1
              },
              {
                  "name": "email",
                  "id": 4,
                  "mediatype": 6
              },
              {
                  "name": "voice_hym",
                  "id": 5,
                  "mediatype": 5
              },
              {
                  "name": "voice",
                  "id": 6,
                  "mediatype": 5
              },
              {
                  "name": "webchat_jst",
                  "id": 9,
                  "mediatype": 1
              }
          ],
          "mediatype": "TTT",
          "vdnid": 6,
          "phonenumber": "70942",
          "currentstatetime": 1210,
          "logindate": 1501125758000,
          "callids": [],
          "inMultimediaConf": 0,
          "currentStateReason": 0,
          "perRestFlag": false,
          "perBusyFlag": false
      }
  }