Jump to: navigation, search

Private Branch Exchange

Also known as a PBX. A switch that is inside of a private business. Also, a small telephone network for customer premises for intracampus and outside telephone calls. Provides local connectivity, switching, and connections to the voice Wide Area Network (WAN).



Glossary

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Public Switched Telephone Network

Also known as a PSTN. The public telephone network to which telephones, Automatic Call Distributors (ACDs), and Private Branch Exchanges (PBXs) are connected. A general term that refers to the variety of telephone networks and services that are in place worldwide, based on copper wires that carry analog voice data.



Glossary

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Device resource

This resource is part of the Voice API section of the Web Services API.

Overview

Device resources include properties that show the current state of the user's device and the available operations for the current state. Devices are returned from GET requests to /api/v2/me/devices or GET requests to /api/v2/me?subresources=*. See Recovering existing state for examples. The device resource is also present in DeviceStateChangeMessages delivered to the client via CometD. The format of the device resource is identical in these two contexts, which lets clients more conveniently update their state.

Sample data

{  
   "id":"efe1ab32-53f9-43ce-b65e-5768c61f7d4a",
   "deviceState":"Active",
   "userState":{  
      "id":"9430250E-0A1B-421F-B372-F29E69366DED",
      "displayName":"Ready",
      "state":"Ready"
   },
   "phoneNumber":"5005",
   "e164Number":"5005",
   "telephonyNetwork":"Private",
   "doNotDisturb":"Off",
   "voiceEnvironmentUri":"http://127.0.0.1:8080/api/v2/voice-environments/370ef5e6-9e3c-4d91-9588-7f4dfe67e011",
   "capabilities":[  
      "ForwardCallsOn",
      "DoNotDisturbOn",
      "ListenIn",
      "Coach",
      "BargeIn",
      "CancelSupervisorMonitoring"
   ],
   "supervisorMonitoringState":{  
      "state":"ListenIn",
      "mode":"AllCalls",
      "scope":"Call",
      "targetDeviceUri":"http://127.0.0.1:8080/api/v2/devices/9c14cad7-17c4-48d0-8492-7cf0ff92c224"
   }
}

Resource details

Field Description
id The unique identifier for the call.
deviceState The state of the device (Active, Inactive).
userState The state of the user for this device. The userState contains the following list of structures:
  • id — The ID of the user state.
  • displayNam" — The display name for the user state.
  • state — The user state.
phoneNumber The phone number assigned to this device.
e164Number The phone number in e.164 format.
telephonyNetwork The type of telephony network the device is associated with. The possible values are:
  • Public — A device that is connected over the PSTN via SIP Server.
  • Private — Other deployment scenarios such as local endpoints or IP phones connected to SIP Server or PBX hardphones connected to Avaya.
doNotDisturb The Do Not Disturb state for this device (On, Off).
voiceEnvironmentUri The URI for the voice environment to which this device belongs.
capabilities A list of capabilities currently available on the device. For users with ROLE_AGENT, the possible values are: DoNotDisturbOn, DoNotDisturbOff, ForwardCallsOn, and ForwardCallsOff. Additionally, users with ROLE_SUPERVISOR may see the following: ListenIn, BargeIn, Coach, CancelSupervisorMonitoring, MuteMonitoredUser, and UnmuteMonitoredUser.
supervisorMonitoringState The current state of the supervisor monitoring the device. This property is only present when supervisor monitoring is active on the device. The supervisorMonitoringState contains the following list of structures:
  • state — The supervisor monitoring state on this device. Possible values are ListenIn, Coach, or BargeIn.
  • mode — The supervisor monitoring mode on this device. Possible values are NextCall or AllCalls.
  • scope — The scope of supervisor monitoring. Possible values are Call or Agent.
  • targetDeviceUri — The URI of the device being monitored.
  • phoneNumber — The monitored phone number.
  • switchName — The name of the switch owning the phone number.
This page was last edited on October 31, 2023, at 13:26.
Comments or questions about this documentation? Contact us for support!