Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The GET /users/by/agentDisplayId/{agentDisplayId} endpoint returns the agent user matching the agent ID provided.

Panel
borderColor#eeeeee
bgColorwhite
titleColorwhite
borderWidth1
titleBGColor#7ec9f4
borderStylesolid
titleIn this page

Table of Contents

Parameters

The endpoint accepts the following path parameter:

agentDisplayId

Type

Required

Example

StringTrue123

The unique ID of the required agent user.

Responses

Responses contain the requested agent user object.

Successful response

Successful requests return a 200 Success code and the requested agent user.

Example response

Code Block
languagejs
themeMidnight
{
  "username": "agent",
  "name": "Agent User",
  "email": "agent@vonage.com",
  "userId": "8e22b1fe-d2ea-403d-8c03-50eb21188e79",
  "lastLoginTime": "2021-08-26T07:37:55.465Z",
  "active": true,
  "ssoExternalId": "exampleSso",
  "userAccountConfiguration": {
    "role": "Agent",
    "actAsAgent": true,
    "agentConfiguration": {
      "agentDisplayId": "123",
      "webrtc": true,
      "enforcedDispositionCodes": false,
      "transcribeCalls": true,
      "screenRecording": false,
      "callParking": true,
      "salesCadence": false,
      "outboundAutoanswer": true,
      "inboundAutoanswer": true,
      "outboundWrapUp": 100,
      "backToReadyAfterNoAnswer": 100,
      "backToReadyAfterLineBusy": 90,
      "backToReadyAfterInvalidNumber": 80,
      "backToReadyAfterNetworkIssue": 5,
      "callRatingFrequency": 56,
      "location": "GB",
      "telephonyAddress": {
        "telephoneAddress": "800100",
        "telephonyExtension": "44",
        "outboundTelephonyRegion": "ab6fd03e-de5a-41fb-9ad8-0e9fcb39f827",
        "nationalDisplay": true,
        "virtualLocation": "PL"
      },
      "capacity": {
        "isAgentLevel": false,
        "live": 60,
        "nonlive": 15,
        "semilive": 75
      },
      "associatedUsers": [
        {
          "username": "supervisor_vbc",
          "applicationType": "VBC"
        }
      ]
    }
  }
}

where:

Insert excerpt
_ExcerptAPIUserObject
_ExcerptAPIUserObject
nopaneltrue