Common Objects¶
Several services are using similar objects. They are described in this section.
Service User Id¶
The attribute serviceUserId is a String. From high level point of view it is a mandatory parameter.
However For Hunt Groups, IVRs (aka Auto-Attendants), Call Centers, and Meet-Me Conferencing APIO offers the possibility to generate it based on its id auto-generation mechanism. This mechanism can be triggered either via a rule defined in a template (priority one) or in configuration settings.
For the template it is done by including a “default_values” section and inside this section a “serviceUserId” element:
"default_values": {
"serviceUserId": "{{group_id}}_hg{{country_code}}{{national_no_0}}@{{domain}}"
}
For the settings it is by using the the following attributes (note that this section comports more parameters not described here)
"AUTOMATIC_ID_RULES": {
"SUID_HUNT_GROUP_AUTO_GENERATE": True,
"SUID_HUNT_GROUP_RULE": "{{group_id}}_hg{{name}}@{{domain}}",
"SUID_MEET_ME_CONF_AUTO_GENERATE": True,
"SUID_MEET_ME_CONF_GROUP_RULE": "{{group_id}}_mmc{{name}}@{{domain}}",
"SUID_AUTO_ATTENDANT_AUTO_GENERATE": True,
"SUID_AUTO_ATTENDANT_RULE": "{{group_id}}_aa{{name}}@{{domain}}",
"SUID_CALL_CENTER_AUTO_GENERATE": True,
"SUID_CALL_CENTER_RULE": "{{group_id}}_cc{{name}}@{{domain}}",
}
- In these rules the following variables can be used:
phone_number_e164: The phone number in E164 format (if a phone number in the profile of the service user defined)
country_code: The country code of the phone number (if a phone number in the profile of the service user defined)
national_no_0: The national number, without trailing 0, of the phone number (if a phone number in the profile of the service user defined)
domain: the domain
tenant_id: the Tenant Id
group_id: the Group Id
name: The name of the service user (if provided)
Audio File attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
name |
String |
C |
O |
The name of the file |
level |
String |
C |
O |
Who owns the announcement. Allowed values Group, User. Default value for User services: User Default value for Group services: Group |
Admin Detail Attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
userId |
String |
A |
R |
F |
The unique id of the admin if the network element allows/requires to specify it. |
firstName |
String |
A |
O |
O |
The first name of the admin. |
lastName |
String |
A |
O |
O |
The last name of the admin. |
language |
String |
A |
O |
O |
The preferred language for the admin. Default as defined in settings. |
department |
Object |
A |
F |
F |
An object as defined as Group department key attributes. |
password |
String |
F |
O |
O |
The password for a new admin. Auto-generated if not provided. |
emailAddress |
String |
A |
O |
O |
The email address for the admin. |
userProfileType |
String |
F |
O |
F |
The User Profile Type to be used for this Admin if not the default one. |
loginMode |
Integer |
F |
O |
F |
To override the loginMode of the User Profile Type used. Usually to force a SSO login (3). |
role |
String |
O |
O |
O |
An optional role for the admin. No logic associated in the APIO itself. |
Note: if the userProfileType is not of the level Group, it will be ignored.
Admin Detail List Item Attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
userId |
String |
A |
The unique id of the admin if the network element allows/requires to specify it. |
firstName |
String |
A |
The first name of the admin. |
lastName |
String |
A |
The last name of the admin. |
language |
String |
A |
The preferred language for the admin. Default as defined in settings. |
Call Center Instance¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
serviceUserId |
String |
A |
C |
F |
Uniquely identifies a call center. For PUT the value is an URL parameter. See Service User Id for the ways it could be auto-generated. |
serviceInstanceProfile |
Object |
A |
R |
O |
Service Profile Information for a call center. See Call Center Service Instance Profile. |
type |
String |
A |
O |
O |
Type of call center. |
routingType |
String |
A |
O |
O |
Routing type for distributing calls within a call center. |
policy |
String |
A |
R |
O |
Policy for distributing calls within a hunt group or call center. |
queueLength |
Integer |
A |
O |
O |
The limit for the number of calls the system will keep in queue, waiting for an available agent. |
enableReporting |
Boolean |
A |
O |
O |
Toggle enable reporting functionality. |
allowCallerToDialEscapeDigit |
Boolean |
A |
O |
O |
Toggle allow caller to dial escape digit functionality. |
escapeDigit |
String |
A |
O |
O |
A single DTMF dialing digit. |
resetCallStatisticsUponEntryInQueue |
Boolean |
A |
O |
O |
Toggle reset call statistics upon entry in queue functionality. |
allowAgentLogoff |
Boolean |
A |
O |
O |
Toggle allow agent logoff functionality. |
allowCallWaitingForAgents |
Boolean |
A |
O |
O |
Toggle allow call waiting for agents functionality. |
allowCallsToAgentsInWrapUp |
Boolean |
A |
O |
O |
Toggle allow calls to agents in Wrap-Up functionality. |
overrideAgentWrapUpTime |
Boolean |
A |
O |
O |
Toggle override agent Wrap-Up time functionality. |
wrapUpSeconds |
Integer |
A |
O |
O |
The Automatic Call Distribution (ACD) Wrap-Up time in seconds. |
forceDeliveryOfCalls |
Boolean |
A |
O |
O |
Toggle force delivery of calls functionality. |
forceDeliveryWaitTimeSecondsSeconds |
Integer |
A |
O |
O |
Force delivery wait time in seconds. |
enableAutomaticStateChangeForAgents |
Boolean |
A |
O |
O |
Toggle automatic state change for agents functionality. |
agentStateAfterCall |
String |
A |
O |
O |
Agent Automatic Call Distribution (ACD) State. States available for Wrap-Up agent state management. |
agentUnavailableCode |
String |
C |
O |
O |
Agent Unavailable Code value. In order to set it correctly:
|
externalPreferredAudioCodec |
String |
A |
O |
O |
Audio file codec. |
internalPreferredAudioCodec |
String |
A |
O |
O |
Audio file codec. |
playRingingWhenOfferingCall |
Boolean |
A |
O |
O |
Toggle play ringing when offering call functionality. |
callCenterQueueThresholdsIsActive |
Boolean |
A |
F |
F |
Toggle call center queue thresholds functionality. |
networkClassOfService |
String |
A |
O |
O |
Network Class of Service name. |
Call Center Service Instance Profile¶
This is also valid for Route Points.
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
name |
String |
A |
R |
O |
See name.from Service User Profile. |
cliFirstName |
String |
A |
R |
O |
See cliFirstName.from Service User Profile. |
cliLastName |
String |
A |
R |
O |
See cliLastName.from Service User Profile. |
phoneNumber |
String |
A |
O |
O |
See phoneNumber.from Service User Profile. |
extension |
String |
A |
O |
O |
See extension.from Service User Profile. |
department |
Object |
A |
O |
O |
See department.from Service User Profile. |
language |
String |
A |
O |
O |
See language.from Service User Profile. In POST if not provided, the settings “DEFAULT_LANGUAGE” will be used. |
timeZone |
String |
A |
O |
O |
See timeZone.from Service User Profile. |
timeZoneDisplayName |
String |
O |
N |
N |
See timeZoneDisplayName.from Service User Profile. |
publicUserIdentity |
String |
A |
O |
O |
See publicUserIdentity.from Service User Profile. |
cliPhoneNumber |
String |
A |
O |
O |
See cliPhoneNumber.from Service User Profile. |
password |
String |
F |
O |
O |
The password. In the POST if not provided it will be auto-generated |
Service User Profile¶
Some services acts as a virtual user as they have properties usually associated to a profile such as a name, a phone number, a language, …Except if stated otherwise in the API using it, the Required / O status is for the Add, in a Modify all is o .
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
name |
String |
A |
R |
O |
Service Instance Name for a service with a user id. |
cliFirstName |
String |
A |
R |
O |
First Name for Calling Line Id Display. |
cliLastName |
String |
A |
R |
O |
Last Name for Calling Line Id Display. |
phoneNumber |
String |
A |
O |
O |
The public phone number to reach the service. |
extension |
String |
A |
O |
O |
The internal extension to reach the service. |
department |
Object |
A |
O |
O |
An object as defined as Group department key attributes. |
language |
String |
A |
O |
O |
The language used for this service, it usually impacts announcements. In POST if not provided, the settings “DEFAULT_LANGUAGE” will be used. |
timeZone |
String |
A |
O |
O |
The time zone of this service user. |
timeZoneDisplayName |
String |
O |
N |
N |
A proposed display name for the time zone of this service user. |
aliases |
Array |
A |
O |
O |
List of SIP URIs. See Aliases. |
publicUserIdentity |
String |
A |
O |
O |
The IMS public identity for this service, relevant in IMS context only. |
cliPhoneNumber |
String |
A |
O |
O |
The public phone number exposed by the service when calling out. |
Note that since 1.10.3, if the AS answer contains a country code indication that country code will be used for the E164 normalization of the phoneNumber.
Route Point Instance¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
serviceUserId |
String |
A |
C |
F |
Uniquely identifies a route point. For PUT the value is an URL parameter. See Service User Id for the ways it could be auto-generated. |
serviceInstanceProfile |
Object |
A |
R |
O |
Service Profile Information for a call center. See Call Center Service Instance Profile. |
queueLength |
Integer |
A |
O |
O |
The limit for the number of calls the system will keep in queue, waiting for an available agent. |
noAnswerTimeoutRings |
Boolean |
A |
O |
O |
The duration (in number of rings) before the cal is considered as in timeout. |
overrideAgentWrapUpTime |
Boolean |
A |
O |
O |
Toggle override agent Wrap-Up time functionality. |
wrapUpSeconds |
Integer |
A |
O |
O |
The Automatic Call Distribution (ACD) Wrap-Up time in seconds. |
forceDeliveryOfCalls |
Boolean |
A |
O |
O |
Toggle force delivery of calls functionality. |
forceDeliveryWaitTimeSecondsSeconds |
Integer |
A |
O |
O |
Force delivery wait time in seconds. |
enableAutomaticStateChangeForAgents |
Boolean |
A |
O |
O |
Toggle automatic state change for agents functionality. |
agentStateAfterCall |
String |
A |
O |
O |
Agent Automatic Call Distribution (ACD) State. States available for Wrap-Up agent state management. |
agentUnavailableCode |
String |
C |
O |
O |
Agent Unavailable Code value. In order to set it correctly:
|
externalPreferredAudioCodec |
String |
A |
O |
O |
Audio file codec. |
internalPreferredAudioCodec |
String |
A |
O |
O |
Audio file codec. |
playRingingWhenOfferingCall |
Boolean |
A |
O |
O |
Toggle play ringing when offering call functionality. |
networkClassOfService |
String |
A |
O |
O |
Network Class of Service name. |
Aliases¶
Enter a list of valid SIP URI or an empty list to delete them all it.
Call Center List Item¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
serviceUserId |
String |
A |
Uniquely identifies a call center. |
name |
String |
A |
Service Instance Name for a service with a user id. |
phoneNumber |
String |
A |
Phone number. |
extension |
String |
A |
The extension. |
department |
Object |
A |
Uniquely identifies a department system-wide. An object as defined as Group department key attributes. |
active |
Boolean |
A |
The status of the service. |
type |
String |
A |
Type of call center. |
policy |
String |
A |
Policy for distributing calls within a hunt group or call center. |
Agent List Item¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
PUT |
POST |
|||
userId |
String |
A |
R |
R |
Unique name for the agent assigned to a call center. |
firstName |
String |
A |
F |
F |
User’s first name. |
lastName |
String |
A |
F |
F |
User’s last name. |
weight |
Integer |
A |
F |
F |
|
phoneNumber |
String |
A |
F |
F |
Phone number. |
extension |
String |
A |
F |
F |
The extension. |
department |
Object |
A |
F |
F |
ely identifies a department system-wide. An object as defined as Group department key attributes. |
emailAddress |
String |
A |
F |
F |
User’s email address. |
skillLevel |
String |
A |
F |
F |
User’s skill level. “O” or empty means no skill level configured (for example for Basic or Standard CC). |
Agent User ID List Item¶
Name |
Type |
Method |
Description |
---|---|---|---|
PUT |
|||
userId |
String |
R |
Unique name for the agent assigned to a call center. |
Skilled Agent List Item¶
Name |
Type |
Method |
Description |
---|---|---|---|
PUT |
|||
agents |
Array |
R |
The list of skilled agents to be assigned to a call center. See Agent User ID List Item. |
skillLevel |
String |
R |
User’s skill level. |
Agent Currently Staffed Item¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
userId |
String |
A |
Unique name for the agent assigned to a call center. |
firstName |
String |
A |
User’s first name. |
lastName |
String |
A |
User’s last name. |
phoneNumber |
String |
A |
Phone number. |
extension |
String |
A |
The extension. |
department |
Object |
A |
Uniquely identifies a department system-wide. An object as defined as Group department key attributes. |
emailAddress |
String |
A |
User’s email address. |
Active Instance List Item¶
Name |
Type |
Method |
Description |
---|---|---|---|
PUT |
|||
serviceUserId |
String |
R |
Unique name for the call center to modify. |
active |
Boolean |
R |
Status of the service. |
Route Point List Item¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
serviceUserId |
String |
A |
Uniquely identifies a route point. |
name |
String |
A |
Service Instance Name for a service with a user id. |
phoneNumber |
String |
A |
Phone number. |
extension |
String |
A |
The extension. |
department |
Object |
A |
Uniquely identifies a department system-wide. An object as defined as Group department key attributes. |
active |
Boolean |
A |
The status of the service. |
Audio File List Item¶
Object with key “name” and value an already existing audio file to set.
“Unmodify” string value to leave unmodified the positional item.
Null value to delete the positional item.
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
name |
Object |
C |
O |
Name of the (already existing) audio file to set. |
String |
C |
O |
“Unmodify” value to leave unmodified the positional item. |
|
Null |
C |
O |
Null value to delete the positional item. |
|
level |
String |
C |
O |
‘Group’ or “User’ depending who own the announcement. Default is ‘Group’ |
Announcements Config¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
audioMessageSelection |
String |
A |
R |
The type of the announcement. |
audioFileList |
Array |
C |
O |
List of the audio file. See Audio File List Item for values of the items |
Estimated Wait Message Options¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
enabled |
Boolean |
A |
O |
Toggle enable status. |
operatingMode |
String |
A |
O |
The type of estimated wait message that is played. |
playPositionHighVolume |
Boolean |
A |
O |
Toggle enable playPositionHighVolume functionality. |
playTimeHighVolume |
Boolean |
A |
O |
Toggle enable playTimeHighVolume functionality. |
maximumPositions |
Integer |
A |
O |
The number of position for which the estimated wait is played. |
maximumWaitingMinutes |
Integer |
A |
O |
The number of minutes for which the estimated wait is played. |
defaultCallHandlingMinutes |
Integer | A | O |
The default handling time per call (minutes). |
||
playUpdatedEWM |
Boolean |
A |
O |
Toggle enable playUpdatedEWM functionality. |
timeBetweenEWMUpdatesSeconds |
Integer |
A |
O |
The interval in seconds between each repetition of the estimated wait message played to queued users. |
Audio File Upload¶
Name |
Type |
Method |
Description |
---|---|---|---|
PUT |
|||
description |
String |
R |
Description for the audio file. |
content |
String |
R |
The file content in Base64, the server will try to transcode it into a supported format. |
Service Management List Item¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
POST |
DELETE |
GET |
|||
name |
String |
R |
R |
A |
The name of the service to be assigned or unassigned. |
assigned |
Boolean |
F |
F |
A |
The assignment status of the service. |
Service License Management List Item¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
name |
String |
A |
R |
The name of the service to be authorized or unauthorized. |
allocated |
Object |
A |
R |
Allocation counters. See Service License Allocation Counters. |
inUse |
Integer |
C |
F |
Amount of uses for the selected service. Present if relevant. |
status |
String |
C |
F |
Identifies the update operation status. Valued from “failed”, “updated”. Present if relevant after an update. |
description |
String |
C |
F |
Description of the service. Present if relevant and provided by the Network Element. |
Service License Allocation Counters¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
unlimited |
Boolean |
C |
O |
Set unlimited uses for the selected service. If not provided false will be used. |
maximum |
Integer |
C |
O |
Maximum number of uses for the selected service. 0 means not authorized. |
noInstance |
Boolean |
C |
F |
if true the service is just assigned/unassigned else it can have instances (from rel 1.4.1) |
Call Capacity Instance¶
Name |
Type |
Methods |
Description |
|||
---|---|---|---|---|---|---|
GET |
POST |
PUT |
DELETE |
|||
name |
String |
N |
R |
O |
F |
Unique name (new name for a PUT) for this instance. For GET and DELETE the value comes from the URL param. Is returned after a GET list instances. |
isDefault |
Boolean |
A |
R |
R |
F |
Define if this instance is the default instance for newly created users. |
maxCalls |
Integer |
A |
R |
R |
F |
Maximum number of simultaneous ongoing calls (global). |
maxIncomingCalls |
Integer |
O |
O |
O |
F |
Maximum number of simultaneous ongoing incoming calls. In GET not present means no limitation, in PUT null means remove limitation. |
maxOutgoingCalls |
Integer |
O |
O |
O |
F |
Maximum number of simultaneous ongoing outgoing calls. In GET not present means no limitation, in PUT null means remove limitation. |
userIds |
Array |
N |
O |
O |
F |
See User IDs. |
users |
Array |
A |
F |
F |
F |
List of users assigned to the service. |
User IDs¶
A List of valid user IDs.
Group attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
groupId |
String |
C |
R |
F |
The unique id of the group if the network element allows/requires to specify it. |
groupName |
String |
A |
O |
O |
The name of the group if defined on the network element. |
userLimit |
Integer |
A |
R |
O |
The maximum number of users allowed in the group. (-1 if unlimited). |
userCount |
Integer |
A |
F |
F |
The current number of users. |
defaultDomain |
String |
A |
R |
O |
The default domain to be used when no domain is specified. |
cliName |
String |
A |
O |
O |
The Calling Line Id Name. |
cliPhoneNumber |
String |
A |
O |
O |
The Calling Line Id Phone Number. It must be a number allocated to the group. |
locationDialingCode |
String |
A |
O |
O |
This code can be used as prefix for inter-groups dialing inside an Enterprise. |
timeZone |
String |
A |
R |
O |
The time zone of this group. |
timeZoneDisplayName |
String |
O |
N |
N |
A proposed display name for the time zone of this group. |
contactInformation |
Object |
O |
O |
O |
The main contact information, see Contact Information attributes. |
addressInformation |
Object |
O |
O |
O |
The address information, see Contact Information attributes. |
resellerId |
String |
O |
O |
O |
The name of the Reseller owning this Group (if any). |
Contact Information attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
name |
String |
A |
O |
O |
The name of the person of contact. |
phoneNumber |
String |
A |
O |
O |
The phone number of the person of contact. |
emailAddress |
String |
A |
O |
O |
The email address of the person of contact |
Contact Information attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
addressLine1 |
String |
A |
O |
O |
The street, number, box address. |
addressLine2 |
String |
A |
O |
O |
The continuation of the address if it must be presented over 2 lines. |
city |
String |
A |
O |
O |
The city. |
state |
String |
A |
O |
O |
The state or province or equivalent notion. |
stateDisplayName |
String |
A |
O |
O |
A display name for the state if needed. |
postalCode |
String |
A |
O |
O |
The postal or zip code. |
country |
String |
A |
O |
O |
The country. |
User attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
POST |
|||
userId |
String |
A |
O |
The unique user Id if the Main AS allows to specify it. |
firstName |
String |
A |
R |
The user first name. (See First / Last name). |
lastName |
String |
A |
R |
The user last name. (See First / Last name). |
department |
String |
A |
F |
The department the user belongs to. |
phoneNumber |
String |
A |
O |
The user phone number (See Phone Number). |
outgoingPhoneNumber |
String |
F |
O |
The alternate phone number for outgoing calls (See Phone Number). |
extension |
String |
A |
O |
The user extension. (See Extension). |
language |
String |
F |
R |
The user language. |
timeZone |
String |
F |
O |
The user timezone (if configured). |
String |
A |
O |
The user email address. |
|
countryCode |
String |
F |
O |
The user country code, as defined in ISO. |
nationalPrefix |
String |
F |
O |
The prefix used for national numbers. |
visibleFirstName |
String |
F |
O |
The user first name visible on the phone. |
visibleLastName |
String |
F |
O |
The user last name visible on the phone. |
devices |
Array |
F |
O |
A list of objects representing the user access devices. (See Device attributes). |
inTrunkGroup |
Boolean |
A |
F |
Indicate of the user is part of a trunk group and therefore has reduced services. |
isAdmin |
Boolean |
A |
O |
Indicate of the user has admin rights on the Group. |
User in List attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
POST |
|||
userId |
String |
A |
R |
The unique user Id if the Main AS allows to specify it. |
firstName |
String |
A |
R |
The user first name. (See First / Last name). |
lastName |
String |
A |
R |
The user last name. (See First / Last name). |
department |
Object |
C |
O |
The department the user belongs to. (See Group department key attributes). |
extension |
String |
A |
O |
The user extension. (See Extension). |
phoneNumber |
String |
A |
O |
The user phone number (See Phone Number). |
emailAddress |
String |
A |
O |
The user email address. |
inTrunkGroup |
Boolean |
A |
F |
Indicate of the user is part of a trunk group and therefore has reduced services. |
tenantId |
String |
C |
F |
The ID of the Tenant owning this User. Only in the result of the Search operations at System level. |
groupId |
String |
C |
F |
The ID of the Group owning this User. Only in the result of the Search operations at System or Tenant level. |
backendName |
String |
C |
F |
The name of the Backend, only provided for a multi-as user, in a system search and if configured to return it. |
backendExternalName |
String |
C |
F |
The external name of the Backend, same constraints as backendName. |
Device attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
POST |
|||
name |
String |
R |
The identifier of the device. |
level |
String |
O |
The level where the the device is defined. (default is user). |
Voice Portal Details¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
name |
String |
A |
R |
The name of the service to be authorized or unauthorized. |
allocated |
Object |
A |
R |
Allocation counters. See Service License Allocation Counters. |
inUse |
Integer |
C |
F |
Amount of uses for the selected service. Present if relevant. |
status |
String |
C |
F |
Identifies the update operation status. Valued from “failed”, “updated”. Present if relevant after an update. |
Voice Portal Instance¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
serviceUserId |
String |
A |
F |
The unique Id of the Voice Portal. |
serviceUserProfile |
Object |
A |
O |
The Service User profile, see Service User Profile. |
active |
Boolean |
A |
O |
Indicate if the service is active or not. |
enableExtendedScope |
Boolean |
A |
O |
|
enableAllAuthentifications |
Boolean |
A |
O |
Allow a user to identify himself using not only its extension but also his phone number or his aliases. |
useVoicePortalWizard |
Boolean |
A |
O |
Force the user to use the configuration wizard. |
voicePortalExternalRoutingScope |
String |
A |
O |
Do the external routing based on global or local settings. |
useExternalRouting |
String |
A |
O |
External routing enabled. |
externalRoutingAddress |
String |
C |
O |
External address to route voice portal calls, not present if not set. |
homeZoneName |
String |
C |
C |
Define a home zone for the user, not present if not set. |
networkClassOfService |
String |
C |
C |
Network Class of Service, not present if not set. |
Group Numbers attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
POST |
|||
numbers |
Array |
A |
O |
List of phone numbers. See Group Numbers list items. The GET returns a list of strings. |
range |
Object |
F |
O |
Range of phone numbers. See Group Numbers Range attributes. |
result |
Object |
C |
F |
After POST or DELETE. List of phone numbers with the result. See Group Numbers Result items |
available_numbers |
Array |
C |
F |
List (of strings) of the available phone numbers. |
assigned_numbers |
Array |
C |
F |
List of objects Group Assigend Numbers attributes. |
Group Numbers list items¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
POST |
|||
phoneNumber |
String |
A |
R |
The phone number. |
status |
Boolean |
A |
F |
The resulting status of the operation, each API will indicate what status are possible. |
message |
String |
O |
F |
An optional message providing more information about the status of the operation on the number |
code |
String |
O |
F |
An error code if the operation has failed. See Error messages. |
details |
String |
O |
F |
An error details if the operation has failed. See Error messages. |
Group Numbers Result items¶
In this table the POST /DELETE has to be understood as returned values in case of POST/DELETE and not as input parameters.
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
POST |
DELETE |
|||
phoneNumber |
String |
A |
A |
The phone number. |
status |
String |
A |
A |
The resulting status of the operation, each API will indicate what status are possible. |
message |
String |
O |
O |
An optional message providing more information about the status of the operation on the number |
code |
String |
O |
O |
An error code if the operation has failed. See Error messages. |
details |
String |
O |
O |
An error details if the operation has failed. See Error messages. |
tenant_status |
String |
O |
N |
The operation could indicate if the nummber was ‘added’ or already ‘available’ at Tenant level |
Group Numbers Range attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
POST |
|||
minPhoneNumber |
String |
A |
R |
The min range phone number. |
maxPhoneNumber |
String |
A |
R |
The max range phone number. |
Group Extensions Range attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
POST |
|||
minExtension |
String |
A |
R |
The min range extension. |
maxExtension |
String |
A |
R |
The max range extension. |
Group Assigend Numbers attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
phoneNumber |
String |
A |
The user phone number (See Phone Number). |
userId |
String |
A |
The unique user Id if the Main AS allows to specify it. |
firstName |
String |
A |
The user first name. (See First / Last name). |
lastName |
String |
A |
The user last name. (See First / Last name). |
userType |
String |
A |
The type of the user. |
department |
Object |
A |
An object as defined in Group department key attributes. |
extension |
String |
A |
The user extension. (See Extension). |
emailAddress |
String |
A |
The user email address. |
Group Numbers POST Result¶
[“status”, “phoneNumber”]
Access Device attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
deviceName |
String |
RA |
R |
F |
The name of the access device. For GET, PUT and DELETE the value comes from the URL param. |
deviceType |
String |
A |
R |
F |
The type of the access device. (-1 if unlimited) |
protocol |
String |
A |
R |
R |
The access device protocol. |
netAddress |
String |
A |
O |
O |
The IP Address, hostname, or domain. |
netPort |
Integer |
A |
O |
O |
The TCP/IP Port number above the 1025 - 65535 range. |
outboundProxyServerNetAddress |
String |
A |
O |
O |
The IP Address, hostname, or domain. |
stunServerNetAddress |
String |
A |
O |
O |
The IP Address, hostname, or domain. |
macAddress |
String |
A |
O |
O |
|
serialNumber |
String |
A |
O |
O |
The access device serial number. |
description |
String |
A |
O |
O |
|
numberOfPorts |
Integer |
A |
F |
F |
Total number of ports supported by this device, -1 means unlimited. |
numberOfAssignedPorts |
Integer |
A |
F |
F |
Number of ports already assigned ot a user on this device. |
availablePorts |
Array |
C |
F |
F |
The list of the available port numbers. In case of unlimited port device will be not returned. Conditionally based on the configuration of the device type (need_port parameter). |
status |
String |
A |
F |
F |
|
physicalLocation |
String |
A |
O |
O |
Physical geographic location of the device. |
transportProtocol |
String |
A |
O |
O |
|
useCustomUserNamePassword |
Boolean |
A |
O |
O |
|
accessDeviceCredentials |
Object |
F |
O |
O |
|
userName |
String |
A |
F |
F |
|
version |
String |
A |
F |
F |
Access Device Credendials¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
userName |
String |
F |
R |
R |
The username for the access device. |
password |
String |
F |
R |
R |
The password for the access device. |
Access Device list item¶
Name |
Type |
Methods |
Description |
---|---|---|---|
GET |
|||
deviceName |
String |
A |
See deviceName.from Access Device attributes. |
deviceType |
String |
A |
See deviceType.from Access Device attributes. |
netAddress |
String |
A |
See netAddress.from Access Device attributes. |
macAddress |
String |
A |
See macAddress.from Access Device attributes. |
availablePorts |
Array |
C |
See availablePorts.from Access Device attributes. |
freePorts |
Integer |
A |
Number of ports not yet in use on the device, 99999 means unlimited |
status |
String |
A |
See status.from Access Device attributes. |
version |
String |
A |
See version.from Access Device attributes. |
User Profile Attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
userId |
String |
R |
O |
R |
User ID. For GET, PUT and DELETE the value comes from the URL param. In POST it can be omitted when an auto-generation rule is configured. |
lastName |
String |
A |
R |
O |
Last Name. |
firstName |
String |
A |
R |
O |
First Name. |
cliLastName |
String |
A |
O |
O |
First Name for Calling Line Id Display. If not provided, the last name will be used. |
cliFirstName |
String |
A |
O |
O |
Last Name for Calling Line Id Display. If not provided, the first name will be used. |
department |
Object |
A |
O |
C |
An object as defined in Group department key attributes. |
phoneNumber |
String |
A |
O |
O |
The public phone number to reach the service. |
extension |
String |
A |
O |
O |
The internal extension to reach the service. |
password |
String |
F |
O |
F |
The password. If not provided, a password will be auto-generated as for password reset. |
oldPassword |
String |
F |
F |
O |
The old password to be modified. |
newPassword |
String |
F |
F |
C |
The new password to be modified. Only if oldPassword.is specified. |
language |
String |
A |
O |
O |
The language used for this service, it usually impacts announcements. In POST if not provided, the settings “DEFAULT_LANGUAGE” will be used. |
emailAddress |
String |
A |
0 |
O |
The user email address. |
networkClassOfService |
String |
A |
O |
O |
The user assigned network class of service. |
timeZone |
String |
A |
O |
O |
The time zone of this user. |
timeZoneDisplayName |
String |
O |
N |
N |
A proposed display name for the time zone of this user. |
accessDeviceEndpoint |
Object |
A |
O |
O |
An object as defined in Access Device Endpoint. |
cliPhoneNumber |
String |
A |
O |
O |
The public phone number exposed by the service when calling out. |
title |
String |
A |
O |
O |
The title exposed by the service. |
pagerPhoneNumber |
String |
A |
O |
O |
The pager phone number. |
mobilePhoneNumber |
String |
A |
O |
O |
The mobile phone number. |
yahooId |
String |
A |
O |
O |
The Yahoo ID. |
addressLocation |
String |
A |
O |
O |
The address location. |
address |
Object |
O |
O |
O |
An object as defined in Address Information attributes Present in GET only if not empty. |
Access Device Endpoint¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
accessDevice |
Object |
R |
R |
R |
An object as defined in Access Device. |
contacts |
Array |
A |
R |
O |
A list of contacts (strings). |
linePort |
String |
A |
R |
O |
The user’s SIP address (private identity). |
lineNumber |
Integer |
A |
R |
O |
Specify the line number. 0 in a GET answer means unknown and must not be sent in PUT data. |
Access Device Endpoint Hotline¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
accessDevice |
Object |
A |
R |
R |
An object as defined in Access Device. |
linePort |
String |
A |
R |
R |
The user’s SIP address (private identity). |
privateIdentity |
String |
N |
O |
F |
TODO |
contacts |
Array |
C |
O |
C |
A list containing 0 or 1 item. |
pathHeader |
String |
C |
O |
C |
Routing information to the device, one for each configured contact. Used when Path header support is enabled. Only available for Rel23. |
staticRegistrationCapable |
Boolean |
A |
F |
F |
TODO |
useDomain |
Boolean |
A |
F |
F |
The user’s line number, depending on the identity/device profile type you selected. Only used by devices with static line ordering. |
lineNumber |
Integer |
C |
C |
C |
Specify the line number. 0 in a GET answer means unknown and must not be sent in PUT data. |
useHotline |
Boolean |
A |
O |
C |
Specify if to use Hotline contact. Only available for Rel23. |
hotlineContact |
String |
C |
O |
C |
The hotline contact. Only available for Rel23. |
Access Device¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
level |
String |
A |
O |
O |
The level of the access device. |
name |
String |
A |
O |
O |
The name of the access device. |
Announcement File Name¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
name |
String |
A |
R |
The name of an existing announcement. |
level |
String |
O |
O |
The level of the owner announcement: “Group” or “User”. Default is “User” for (service) user services and “Group” for group services. |
Incoming Calling Plan Permissions¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
allowFromWithinGroup |
Boolean |
A |
O |
Allows calls from within the group |
allowFromOutsideGroup |
String |
A |
O |
Allows calls from outside the group. Values from list: [‘Allow’,’Disallow’, ‘Allow Only If Redirected From Another User’] |
allowCollectCalls |
Boolean |
A |
O |
Allows collect calls |
digitPatternPermission |
Array |
A |
O |
An array of object as defined by Incoming Calling Plan Digit Pattern Permissions |
Incoming Calling Plan Department Permissions¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
department |
Object |
A |
O |
An object as defined in Group department key attributes. |
allowFromWithinGroup |
Boolean |
A |
O |
Allows calls from within the group |
allowFromOutsideGroup |
String |
A |
O |
Allows calls from outside the group. Values from list: [‘Allow’,’Disallow’, ‘Allow Only If Redirected From Another User’] |
allowCollectCalls |
Boolean |
A |
O |
Allows collect calls |
digitPatternPermission |
Array |
A |
O |
An array of object as defined by Incoming Calling Plan Digit Pattern Permissions |
Incoming Calling Plan Digit Pattern Permissions¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
allow |
Boolean |
A |
O |
Allows or disallows calls from this pattern |
digitPatternName |
String |
A |
R |
Digit pattern name as managed by API Calling Plan Digit Strings |
Calling Plan Digit String¶
Name |
Type |
Methods |
Description |
|||
---|---|---|---|---|---|---|
GET |
POST |
PUT |
DELETE |
|||
name |
String |
A |
R |
R |
R |
Name used to define the digit string - is also the ky used to identify thee digit string |
digitPattern |
String |
A |
R |
O |
F |
Digit pattern associated to the digit string |
Outgoing Calling Plan Permissions¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
group |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
local |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
tollFree |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
toll |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
international |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
operatorAssisted |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
chargeableDirectoryAssisted |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
specialServicesI |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
specialServicesII |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
premiumServicesI |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
premiumServicesII |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
casual |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
urlDialing |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
unknown |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
digitPatternPermission |
Array |
A |
O |
An array of object as defined by Outgoing Calling Plan Digit Pattern Permissions. this param is enabled by a global setting Configuration Information for OCP |
The extra values of the Enhanced mode are obviously only relevant for the Originating OCP as it would make no sense to request and authorization code to the calling party for redirected call.
Outgoing Calling Plan Digit Pattern Permissions¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
permission |
String |
A |
O |
A value from list: [‘Allow’,’Disallow’]. Enhanced mode (originating): [‘AuthCodes’,’FirstTransferNumber’,’SecondTransferNumber’,’ThirdTransferNumber’]. |
digitPatternName |
String |
A |
R |
Digit pattern name as managed by API Calling Plan Digit Strings |
Outgoing Calling Plan Department Permissions¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
department |
Object |
A |
O |
An object as defined in Group department key attributes. |
permissions |
Object |
A |
O |
An object as defined in Outgoing Calling Plan Permissions. |
Phone List attributes¶
Name |
Type |
Methods |
Description |
|||
---|---|---|---|---|---|---|
GET |
POST |
PUT |
DELETE |
|||
name |
String |
A |
R |
O |
R |
The name of the phone list entry. |
phoneNumber |
String |
A |
R |
O |
F |
The phone number of the phone list entry. |
Service Summary attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
name |
String |
A |
The name of the service. |
active |
Boolean |
A |
The status of the service. |
Speed Code attributes¶
Name |
Type |
Methods |
Description |
|||
---|---|---|---|---|---|---|
GET |
POST |
PUT |
DELETE |
|||
speedCode |
String |
A |
R |
R |
R |
The speed code. |
phoneNumber |
String |
A |
R |
R |
F |
The phone number. |
description |
String |
A |
O |
O |
F |
The description. |
Announcement attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
DELETE |
|||
announcements |
Array |
A |
R |
A list of objects as defined in Announcement entry attributes. |
totalFileSize |
Integer |
A |
F |
Sum of the size of all the announcements (in KB). |
maxFileSize |
Integer |
A |
F |
Valid range for space allocation (in Megabytes) for files in the announcement repository. |
Announcement entry attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
DELETE |
|||
name |
Array |
A |
R |
The announcement name. |
mediaType |
Integer |
A |
F |
The announcement media type. |
fileSize |
Integer |
A |
F |
The announcement file size (in KB). |
Announcement instance attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
description |
String |
A |
The announcement description. |
fileSize |
Integer |
A |
The announcement file size (in KB). |
lastUploaded |
String |
A |
Last uploaded datetime. |
usages |
Array |
A |
A list of announcement usages as defined in Announcement Usages attributes. |
Announcement Usages attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
service |
String |
A |
|
instance |
Integer |
A |
Announcement create and modify attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
name |
String |
A |
R |
O |
The announcement filename. For PUT it allows to modify the name, the original name is in the url. |
content |
String |
A |
R |
O |
The media file content (encoded to base64 format) to be uploaded. |
description |
String |
A |
O |
O |
The media file description. |
repositoryAnnouncement |
String |
N |
O |
O |
The announcement name from the Default Announcement Catalog. If set this will override any content provided. If name and/or description are set, then will be used, otherwise the ones from the Default Announcement Catalog will be used. |
Hunt Group Instance¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
serviceUserId |
String |
A |
C |
R |
Uniquely identifies a user. For PUT the value is an URL parameter. See Service User Id for the ways it could be auto-generated. |
serviceInstanceProfile |
Object |
A |
R |
O |
Service Profile Information for a hunt group. See Service User Profile. |
policy |
String |
A |
O |
O |
Policy for distributing calls within a hunt group or call center. |
huntAfterNoAnswer |
Boolean |
A |
O |
O |
|
noAnswerNumberOfRings |
Integer |
A |
O |
O |
Number of rings to wait for the currently hunted agent to answer before hunting to the next available agent. |
forwardAfterTimeout |
Boolean |
A |
O |
O |
|
forwardTimeoutSeconds |
Integer |
A |
O |
O |
Time to wait for any agent to answer before forwarding the caller elsewhere. |
forwardToPhoneNumber |
String |
A |
C |
C |
An outgoing phone number or a number meant to be dialed. It is longer than a DN so that equal access digits or access code digits may be be included. It cannot be a SIP URL. For POST it’s mandatory when ‘forwardAfterTimeout’ is enabled. For PUT it’s mandatory when ‘forwardAfterTimeout’ is enabled and the forwardToPhoneNumber has not been setted previously. |
agents |
Array |
A |
O |
O |
The list of the assigned agents to the given hunt group. In PUT and POST it is an array of user ids (strings). In GET it is a list of objects (see Hunt Group Agents array) in order that the client can display information on agents without having to fetch the list of users of the Group to get the details |
allowCallWaitingForAgents |
Boolean |
A |
O |
O |
|
useSystemHuntGroupCLIDSetting |
Boolean |
A |
O |
O |
|
includeHuntGroupNameInCLID |
Boolean |
A |
O |
O |
|
enableNotReachableForwarding |
Boolean |
A |
O |
O |
|
notReachableForwardToPhoneNumber |
String |
A |
C |
C |
For POST it’s mandatory when ‘enableNotReachableForwarding’ is enabled. For PUT it’s mandatory when ‘enableNotReachableForwarding’ is enabled and the notReachableForwardToPhoneNumber has not been setted previously. |
makeBusyWhenNotReachable |
Boolean |
A |
O |
O |
|
allowMembersToControlGroupBusy |
Boolean |
A |
O |
O |
|
enableGroupBusy |
Boolean |
A |
O |
O |
|
applyGroupBusyWhenTerminatingToAgent |
Boolean |
A |
O |
O |
|
networkClassOfService |
String |
A |
O |
O |
Network Class of Service name. |
active |
Boolean |
A |
O |
O |
The status of the service. |
Hunt Group Agents array¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
userId |
String |
A |
R |
Uniquely identifies a user. |
lastName |
String |
A |
R |
User’s last name. |
firstName |
String |
A |
R |
User’s first name. |
weight |
String |
A |
R |
User’s weighted distribution (the value is in percentage). |
phoneNumber |
String |
A |
R |
User’s phone number. |
extension |
String |
A |
R |
User’s extension. |
department |
Object |
A |
R |
An object as defined as Group department key attributes. |
emailAddress |
String |
A |
R |
User’s emailAddress. |
Agents weighted distribution¶
Name |
Type |
Method |
Description |
---|---|---|---|
PUT |
|||
userId |
String |
R |
Uniquely identifies a user. |
weight |
String |
R |
User’s weighted distribution (the value is in percentage). |
Hunt Group List Item¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
serviceUserId |
String |
A |
Uniquely identifies a user. |
name |
String |
A |
Service Instance Name for a service with a user id. |
phoneNumber |
String |
A |
Phone number. |
extension |
String |
A |
The extension. |
department |
Object |
A |
An object as defined as Group department key attributes. |
active |
Boolean |
A |
The status of the service. |
policy |
String |
A |
Policy for distributing calls within a hunt group or call center. |
Available User List Item¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
userId |
String |
A |
R |
R |
Unique name for the agent assigned to a call center. |
firstName |
String |
A |
F |
F |
User’s first name. |
lastName |
String |
A |
F |
F |
User’s last name. |
phoneNumber |
String |
A |
F |
F |
Phone number. |
extension |
String |
A |
F |
F |
The extension. |
department |
Object |
C |
F |
F |
An object as defined as Group department key attributes. Returned only if the user is part of a department. |
emailAddress |
String |
A |
F |
F |
User’s email address. |
Phone Directory List attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
name |
String |
A |
The name. |
emailAddress |
String |
A |
The email address. |
phoneNumber |
String |
A |
The phone number. |
mobilePhoneNumber |
String |
A |
|
department |
Object |
C |
An object as defined as Group department key attributes. |
extension |
String |
A |
|
groupId |
String |
A |
|
userId |
String |
A |
|
virtualOnNet |
Boolean |
A |
|
firstName |
String |
C |
|
lastName |
String |
C |
|
pager |
String |
C |
|
title |
String |
C |
|
timeZone |
String |
C |
|
location |
String |
C |
|
addressLine1 |
String |
C |
|
addressLine2 |
String |
C |
|
city |
String |
C |
|
state |
String |
C |
|
zip |
String |
C |
|
country |
String |
C |
Tenant Phone Directory List attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
name |
String |
A |
The name. |
emailAddress |
String |
A |
The email address. |
phoneNumber |
String |
A |
The phone number. |
mobilePhoneNumber |
String |
A |
|
department |
Object |
C |
An object as defined as Tenant department key attributes. |
extension |
String |
A |
|
groupId |
String |
A |
|
userId |
String |
A |
|
virtualOnNet |
Boolean |
A |
|
firstName |
String |
C |
|
lastName |
String |
C |
|
pager |
String |
C |
|
title |
String |
C |
|
timeZone |
String |
C |
|
location |
String |
C |
|
addressLine1 |
String |
C |
|
addressLine2 |
String |
C |
|
city |
String |
C |
|
state |
String |
C |
|
zip |
String |
C |
|
country |
String |
C |
Group Mobile Numbers attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
POST |
|||
phoneNumbers |
Array |
A |
O |
List of phone numbers. See Group Numbers list items. The GET returns a list of strings. |
result |
Object |
C |
F |
After POST. List of phone numbers with the status of the operation. See Group Numbers list items. |
available_numbers |
Array |
C |
F |
List (of strings) of the available phone numbers. |
assigned_numbers |
Array |
C |
F |
List of objects Group Assigned Mobile Numbers attributes. |
Group Assigned Mobile Numbers attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
phoneNumber |
String |
A |
The user phone number (See Phone Number). |
userId |
String |
A |
The unique user Id if the Main AS allows to specify it. |
firstName |
String |
A |
The user first name. (See First / Last name). |
lastName |
String |
A |
The user last name. (See First / Last name). |
department |
Object |
A |
An object as defined as Group department key attributes. |
extension |
String |
A |
The user extension. (See Extension). |
Trunk Device Endpoint¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
name |
String |
A |
R |
O |
Trunk Group name. |
linePort |
String |
A |
R |
O |
Identifies a device endpoint in standalone mode. Must be a valid SIP URI. |
contacts |
Array |
A |
O |
O |
A list of contacts (strings). |
Trunk Endpoint¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
trunkGroupDeviceEndpoint |
Object |
A |
O |
O |
An object as defined in Trunk Device Endpoint. |
enterpriseTrunkName |
String |
C |
O |
O |
Enterprise Trunk name. Uniquely identifies an Enterprise Trunk in an enterprise or group. |
alternateTrunkIdentity |
String |
C |
O |
O |
Alternate Trunk Identity. |
alternateTrunkIdentityDomain |
String |
C |
O |
O |
Domain of the Alternate Trunk Identity. |
physicalLocation |
String |
C |
O |
O |
Physical Location. |
Device in List attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
tenantId |
String |
A |
The unique id of the tenant of this device. |
isEnterprise |
Boolean |
A |
Indicate if the Tenant is of type Enterprise. |
groupId |
String |
C |
The unique id of the group of this device. If the device is not at group level, the groupId is not returned. |
deviceName |
String |
A |
See deviceName.from Access Device attributes. |
deviceType |
String |
A |
See deviceType.from Access Device attributes. |
netAddress |
String |
A |
See netAddress.from Access Device attributes. |
macAddress |
String |
A |
See macAddress.from Access Device attributes. |
status |
String |
A |
See status.from Access Device attributes. |
backendName |
String |
C |
The name of the Backend, only provided for a multi-as user, in a system search and if configured to return it. |
backendExternalName |
String |
C |
The external name of the Backend, same constraints as backendName. |
Device file attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
fileSource |
String |
A |
R |
The configuration mode. Value in: Default, Manual, Custom. |
configurationFileName |
String |
A |
F |
The name of the configuration file. |
accessUrl |
String |
A |
F |
The url to access the file. |
repositoryUrl |
String |
A |
F |
The url of the repository. |
templateUrl |
String |
A |
F |
The url of the template file. |
extendedCaptureEnabled |
Boolean |
A |
O |
If true, the extended capture is enabled. |
extendedCaptureURL |
String |
C |
F |
TODO. Only available in AS data mode. |
Device file in list attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
fileFormat |
String |
A |
The name and format of the file. |
isAuthenticated |
Boolean |
A |
TODO |
accessUrl |
String |
A |
The url to access the file. |
repositoryUrl |
String |
A |
The url of the repository. |
templateUrl |
String |
A |
The url of the template file. |
User connected to a Device attributes¶
Name |
Type |
Method |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
lastName |
String |
A |
O |
The user’s last name. |
firstName |
String |
A |
O |
The user’s first name. |
phoneNumber |
String |
A |
O |
The user’s phone number. (See Phone Number). |
userId |
String |
A |
R |
The user’s unique ID. |
userType |
String |
A |
O |
The user’s type. |
extension |
String |
A |
O |
The user’s extension. |
department |
String |
C |
O |
The department the user belongs to. An object as defined as Group department key attributes. |
emailAddress |
String |
A |
O |
The user’s email address. |
linePort |
String |
A |
R |
The device line port. |
endpointType |
String |
A |
O |
The device endpoint type. |
order |
Integer |
C |
R |
The order/ine/port of the user on the phone. Only if supported by that type of phone. |
primary |
Boolean |
A |
O |
The primary (main) device of the user or not. |
Numbers in list attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
tenantId |
String |
A |
The ID of the Tenant. |
phoneNumber |
String |
A |
The phone number. |
isEnterprise |
Boolean |
A |
Indicate if the Tenant is an Enterprise or a Service Provider. |
backendName |
String |
C |
The name of the Backend, only provided for a multi-as user, in a system search and if configured to return it. |
backendExternalName |
String |
C |
The external name of the Backend, same constraints as backendName. |
Number usage in list attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
tenantId |
String |
A |
The ID of the Tenant. |
phoneNumbers |
Integer |
A |
The number of phoneNumbers assigned to this Tenant. |
assignedToGroups |
Integer |
A |
The number of phoneNumbers assigned to Groups. |
percentageAssigned |
Integer |
A |
The percentage of the phoneNumbers assigned to Groups. |
isEnterprise |
Boolean |
A |
Indicate if the Tenant is an Enterprise or a Service Provider. |
activatedOnGroups |
Integer |
A |
Number activation status. |
backendName |
String |
C |
The name of the Backend, only provided for a multi-as user, in a system search and if configured to return it. |
backendExternalName |
String |
C |
The external name of the Backend, same constraints as backendName. |
Number usage instance attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
tenantId |
String |
A |
The ID of the Tenant. |
groupId |
String |
A |
The ID of the Group. |
userId |
String |
A |
The ID of the User. |
userType |
String |
A |
The type of the User. |
isGroupCallingLineId |
Boolean |
A |
TODO. |
active |
Boolean |
A |
True if DN is active. |
Phonelist CSV Results¶
Name |
Type |
Description |
---|---|---|
line |
Integer/String |
The line corresponding to the line of the csv file. In case of deletion, “-” is reported. |
name |
String |
The Name. |
phone_number |
String |
The Phone Number. |
status |
String |
The status:
|
message |
String |
The message:
|
Group & Tenant network class of service in list attributes¶
Name |
Type |
Methods |
Description |
|||
---|---|---|---|---|---|---|
GET |
POST |
PUT |
DELETE |
|||
name |
String |
A |
R |
F |
R |
The name of the network class of service. |
description |
String |
A |
F |
F |
F |
The description of the network class of service. |
default |
Boolean |
A |
O |
F |
F |
If true, this is the active network class of service. Only one NCOS at a time can be set as default. |
assignToAllUsers |
Boolean |
N |
O |
O |
F |
If true, the NCOS instance will be assigned to all users. Only one NCOS at a time can be set to true. |
assignToAllGroups |
Boolean |
N |
O |
O |
F |
If true, the NCOS instance will be assigned to all groups. Only one NCOS at a time can be set to true. Only available at tenant level. |
Group department in list attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
departmentName |
String |
A |
The name of the department. |
enterpriseDepartment |
Boolean |
A |
If true, it is and enterprise department. |
fullPathName |
String |
A |
The full path name of the department, containing the name of the parent department. |
cliName |
String |
C |
Department calling line name. |
cliPhoneNumber |
String |
C |
Department calling line phone number. |
Group department attributes¶
Name |
Type |
Method |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
departmentName |
String |
N |
M |
O |
The name of the department. |
parentDepartment |
Object |
O |
O |
O |
The parent department. |
cliName |
String |
O |
O |
O |
Department calling line name. |
cliPhoneNumber |
String |
O |
O |
O |
Department calling line phone number. |
Group department key attributes¶
Name |
Type |
Method |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
tenantId |
String |
A |
R |
O |
The ID of the Tenant which this department belongs. Will be taken from url if not provided. |
groupId |
String |
A |
R |
O |
The ID of the Group which this department belongs. Will be taken from url if not provided. |
departmentName |
String |
A |
R |
R |
The name of the department. |
fullPathName |
String |
C |
F |
F |
The complete path name of the department. |
Tenant department key attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
tenantId |
String |
A |
The ID of the Tenant which this department belongs. Will be taken from url if not provided. |
departmentName |
String |
A |
The name of the department. |
fullPathName |
String |
C |
The complete path name of the department. |
Group department available parent list attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
tenant_id |
String |
A |
The ID of the Tenant which this department belongs. |
group_id |
String |
A |
The ID of the Group which this department belongs. |
departmentName |
String |
A |
The name of the department. |
fullPathName |
String |
A |
The full path name of the department, containing the name of the parent department. |
Group communication barring profile list attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
profileName |
String |
A |
R |
Communication Barring Profile. |
Group virtual on net user in get list attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
lastName |
String |
A |
User’s last name. |
firstName |
String |
A |
User’s first name. |
phoneNumber |
String |
A |
User’s phone number. |
extension |
String |
A |
User’s extension. |
callType |
String |
A |
Virtual On Net call type name. |
Group virtual on net user in post list attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
POST |
|||
lastName |
String |
R |
User’s last name. |
firstName |
String |
R |
User’s first name. |
cliLastName |
String |
R |
User’s calling line id last name. |
cliFirstName |
String |
R |
User’s calling line id first name. |
phoneNumber |
String |
R |
User’s phone number. |
extension |
String |
R |
User’s extension. |
callType |
String |
O |
Virtual On Net call type name. If not provided, a default value will be set from settings (if present) The list of allowed callTypes can be retrieved using the API Display system’s call types. |
Group virtual on net user range in post attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
POST |
|||
lastName |
String |
R |
User’s last name. |
firstName |
String |
R |
User’s first name. |
cliLastName |
String |
R |
User’s last name. |
cliFirstName |
String |
R |
User’s first name. |
dnRange |
String |
R |
An object as defined as Group Numbers Range attributes. |
extensionRange |
String |
R |
An object as defined as Group Extensions Range attributes. |
callType |
String |
O |
Virtual On Net call type name. If not provided, a default value will be set from settings (if present) The list of allowed callTypes can be retrieved using the API Display system’s call types. |
Group feature access code attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
name |
String |
A |
Feature Access Code Name. |
code |
String |
O |
Feature Access Code. |
alternateCode |
String |
O |
Feature Access Code. |
Group Session Admission Control Group in list attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
DELETE |
|||
name |
String |
A |
A |
The name of the SAC group. |
default |
Boolean |
A |
N |
Specify whether this is the default SAC group. |
maxSessions |
Integer |
A |
N |
The maximum number of concurrent sessions enter the maximum number of concurrent sessions allowed for the SAC group. |
maxOrigSessions |
Integer |
O |
N |
The maximum number of concurrent user originating sessions |
maxTermSessions |
Integer |
O |
N |
The maximum number of concurrent user terminating sessions |
Group Session Admission Control Group attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
name |
String |
N |
R |
O |
The name of the SAC group. |
maxSessions |
Integer |
A |
R |
O |
The maximum number of concurrent sessions allowed for the SAC group. The number cannot exceed the maximum number of concurrent subscriber sessions allowed for the group as specified on the group’s capacity control. |
maxOrigSessions |
Integer |
O |
O |
O |
The maximum number of concurrent user originating sessions. |
maxTermSessions |
Integer |
O |
O |
O |
The maximum number of concurrent user terminating sessions. |
reservedSessions |
Integer |
A |
R |
O |
The maximum number of reserved sessions for the SAC group. To avoid situations where other SAC groups use up all the session resources. Value 0 means that the reservation mechanism is disabled. |
reservedOrigSessions |
Integer |
O |
O |
O |
The maximum number of reserved user originating sessions. |
reservedTermSessions |
Integer |
O |
O |
O |
The maximum number of reserved user terminating sessions. |
default |
Boolean |
A |
R |
O |
Specify whether this is the default SAC group. |
countIntraSACGroupSessions |
Boolean |
A |
R |
O |
To include the intra-SAC group sessions in the count of the total number of sessions for the SAC group. |
devices |
Array |
A |
O |
O |
An array of devices. See Access Device. |
blockEmergencyAndRepairCallsDueToSACLimits |
Boolean |
A |
R |
O |
To block emergency and repair calls when the call limit is reached for this SAC group. |
Group meet me conferencing ports attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
unlimited |
Boolean |
A |
O |
If true, the number of allocated ports is unlimited. If false, quantity must be specified. |
quantity |
Integer |
C |
O |
The limited number of allocated ports. |
Group call center agent threshold profile list attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
default |
Boolean |
A |
Specify if this profile is set as default. |
name |
String |
A |
Specify if the code is active or not. |
description |
String |
C |
Specify if the code is active or not. |
Agent threshold available agents item¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
userId |
String |
A |
Unique name for the agent. |
firstName |
String |
A |
User’s first name. |
lastName |
String |
A |
User’s last name. |
phoneNumber |
String |
C |
Phone number. |
extension |
String |
C |
The extension. |
department |
Object |
C |
Uniquely identifies a department system-wide. An object as defined as Group department key attributes. |
emailAddress |
String |
C |
User’s email address. |
agentThresholdProfile |
Integer |
A |
The threshold profile that is assigned to the agent. |
Group call center statistics range attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
start |
DateTime |
R |
The start date and time of the statistics. |
end |
DateTime |
C |
The end date and time of the statistics. |
Group call center queue statistics attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
numberOfBusyOverflows |
Integer |
A |
The number of calls received after the queue limit was exceeded. |
numberOfCallsAnswered |
Integer |
A |
The number of calls answered. |
numberOfCallsAbandoned |
Integer |
A |
The number of calls for which the caller hung up before a response. |
numberOfCallsTransferred |
Integer |
A |
The number of calls transferred. |
numberOfCallsTimedout |
Integer |
A |
The number of calls unanswered. |
averageNumberOfAgentsTalking |
Decimal |
A |
The average number of agents in the talking state. |
averageNumberOfAgentsStaffed |
Decimal |
A |
The average number of agents staffed. |
averageWaitSeconds |
Integer |
A |
The average number of seconds that callers wait for an available agent. |
averageAbandonmentSeconds |
Integer |
A |
The average number of seconds that callers wait for an agent before hanging up. |
User display names attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
lastName |
String |
A |
User’s last name. |
firstName |
String |
A |
User’s first name. |
hiraganaLastName |
String |
C |
Hiragana last name. |
hiraganaFirstName |
String |
C |
Hiragana first name. |
communication barring attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
POST |
|||
useGroupSetting |
Boolean |
A |
R |
If useGroupSetting is set to false, a profile name must be present. |
profileName |
String |
C |
O |
Profile name |
Call center agent statistics attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
numberOfCallsHandled |
Integer |
A |
The number of calls handled by the agent. |
numberOfCallsUnanswered |
Integer |
A |
The number of calls not answered by the agent. |
averageCallSeconds |
Integer |
A |
The average number of seconds that an agent spends on calls. |
totalTalkSeconds |
Integer |
A |
The number of seconds that the agent was busy handling calls. |
totalStaffedSeconds |
Integer |
A |
The number of seconds that the agent has joined the call center instance. |
Group call center agent statistics attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
agentUserId |
String |
A |
The agent user id. |
agentDisplayNames |
Object |
A |
The agent display names. See User display names attributes |
available |
Boolean |
A |
Specify if agent statistics are available or not. |
statistics |
Object |
A |
The agent statistics. See Call center agent statistics attributes. |
Group call center priority attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
userId |
String |
A |
R |
Unique userId for the call center. |
name |
String |
A |
F |
The call center name. |
priority |
Number |
A |
R |
The call center priority. When the setting ‘CC_ROUTING_PRIORITY_VALIDATION’ is True, the priority must be an integer value. Otherwise the priority can be either an integer or a float value with one decimal position. |
Group number activation status attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
phoneNumber |
String |
A |
R |
The phone number. |
activated |
Boolean |
A |
R |
Specify if the phone number is activated or not. |
Group number activation status attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
PUT |
|||
activated |
Boolean |
R |
Specify if the phone numbers in range must be activated or not. |
minPhoneNumber |
String |
R |
The min range phone number. |
maxPhoneNumber |
String |
R |
The max range phone number. |
Conference Host Instance¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
userId |
String |
A |
R |
R |
Unique name for the user. |
firstName |
String |
A |
F |
F |
User’s first name. |
lastName |
String |
A |
F |
F |
User’s last name. |
phoneNumber |
String |
A |
F |
F |
Phone number. |
extension |
String |
A |
F |
F |
The extension. |
department |
Object |
A |
F |
F |
An object as defined as Group department key attributes. |
emailAddress |
String |
A |
F |
F |
User’s email address. |
Conference duration¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
hours |
Integer |
A |
R |
O |
An integer representing hours within the range 0 to 23. |
minutes |
Integer |
A |
R |
O |
An integer representing minutes, may be one of these values: {0, 15, 30, 45} |
Meet-Me Conferencing Bridge Instance¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
bridgeId |
String |
A |
C |
C |
Uniquely identifies a bridge. See Service User Id for the ways it could be auto-generated. |
serviceInstanceProfile |
Object |
A |
R |
O |
Service Profile Information for a call center. See Service User Profile. |
allocatedPorts |
Object |
A |
A |
O |
Number of conference ports allocated to the bridge. Can either be unlimited or limited, see Group meet me conferencing ports attributes. |
networkClassOfService |
String |
C |
O |
O |
The Network Class of Service Name to assign to this conference bridge. |
securityPinLength |
Integer |
A |
R |
O |
Number of digits for the security pin that the participants must provide to join the conference. Must within the range 4 to 12. |
allowIndividualOutDial |
Boolean |
A |
A |
O |
Allows out-dialing to individual participants for conferences defined on this bridge. |
operatorNumber |
Integer |
C |
O |
O |
The phone number or SIP URI where calls to the operator during a conference are transferred. |
conferenceHosts |
Array |
A |
O |
O |
Assigned users as hosts on this bridge. An array of objects as Conference Host Instance. |
playWarningPrompt |
Boolean |
A |
R |
O |
When this option is defined, a warning announcement is played before the scheduled end of the conference. Minutes are set with ‘conferenceEndWarningPromptMinutes’. |
conferenceEndWarningPromptMinutes |
Integer |
A |
R |
O |
Set the minutes before the end of the conference when to play a warning announcement. Must within the range 0 to 23. |
enableMaxConferenceDuration |
Boolean |
A |
R |
O |
Allow a maximum duration for the conferences of this bridge. |
maxConferenceDurationMinutes |
Object |
A |
R |
O |
Set the maximum duration for the conferences of this bridge, in minutes. An object as Conference duration. |
maxScheduledConferenceDurationMinutes |
Object |
A |
R |
O |
Set the maximum duration for the scheduled conferences of this bridge, in minutes. An object as Conference duration. |
active |
Boolean |
A |
O |
O |
Specify if the conference bridge is active. |
Meet-Me Conferencing Bridge Instance in list¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
bridgeId |
String |
A |
R |
R |
Unique name for the conference bridge. |
name |
String |
A |
F |
F |
The name of the conference bridge. |
phoneNumber |
String |
A |
F |
F |
Phone number. |
extension |
String |
A |
F |
F |
The extension. |
department |
Object |
A |
F |
F |
An object as defined as Group department key attributes. |
allocatedPorts |
Object |
A |
F |
F |
Number of conference ports allocated to the bridge. Can either be unlimited or limited, see Group meet me conferencing ports attributes. |
active |
String |
A |
F |
F |
Specify if the conference bridge is active. |
Call center disposition code attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
code |
String |
F |
R |
F |
The name of the code. For GET and PUT it is an url parameter. |
active |
Boolean |
A |
O |
O |
Specify if the code is active or not. Default true. |
description |
String |
A |
O |
O |
The description of the code. |
Call center disposition code attributes when in list¶
Name |
Type |
Methods |
Description |
---|---|---|---|
GET |
|||
code |
String |
A |
The name of the code. For put it is an url parameter. |
active |
Boolean |
A |
Specify if the code is active or not. |
description |
String |
C |
The description of the code. |
level |
String |
C |
The level of the code (“CallCenter”, “Group”, “Tenant”). |
Group call center default disposition code attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
code |
String |
A |
R |
The name of the code. |
level |
String |
A |
R |
The level of the code. A value from list: [‘Tenant’|’Group’|’CallCenter’]. |
Group call center DNIS instance¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
name |
String |
N |
R |
O |
The unique name that identifies the DNIS. |
phoneNumber |
String |
A |
O |
O |
The DNIS phone number. |
extension |
String |
A |
O |
O |
The DNIS extension. |
useCustomCLIDSettings |
Boolean |
A |
R |
O |
Specify if to use custom CLID Settings. |
cliPhoneNumber |
String |
C |
O |
O |
The calling line id phone number. |
cliLastName |
String |
C |
C |
C |
The calling line id last name. Is required if ‘useCustomCLIDSettings’ is true. |
cliFirstName |
String |
C |
C |
C |
The calling line id first name. Is required if ‘useCustomCLIDSettings’ is true. |
useCustomDnisAnnouncementSettings |
Boolean |
C |
R |
O |
Specify if to use custom announcement Settings. |
priority |
Integer |
C |
R |
O |
The DNIS priority. A value in range 0 to 3, with 0 Highest priority and 3 Lowest priority. |
allowOutgoingACDCall |
Boolean |
C |
R |
O |
Allows the agent to use the DNIS number to make calls. |
Group call center DNIS List item attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
name |
String |
A |
See ‘name’ from Group call center DNIS instance. |
phoneNumber |
Object |
A |
See ‘phoneNumber’ from Group call center DNIS instance. |
extension |
Boolean |
A |
See ‘extension’ from Group call center DNIS instance. |
priority |
Object |
A |
See ‘priority’ from Group call center DNIS instance. |
primary |
Object |
A |
Indicates if it is the primary DNIS of the call center. |
Agent DNIS in list Item¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
userId |
String |
A |
Unique name for the agent. |
firstName |
String |
A |
Agent’s first name. |
lastName |
String |
A |
Agent’s last name. |
phoneNumber |
String |
A |
Phone number. |
extension |
String |
A |
The extension. |
department |
Object |
A |
Uniquely identifies a department system-wide. An object as defined as Group department key attributes. |
emailAddress |
String |
A |
Agent’s email address. |
Group Custom Ringback Audio File¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
name |
String |
A |
R |
The announcement name. |
mediaType |
String |
A |
O |
The announcement media type. If not provided, the default media type will be used. |
Group number activation status attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
name |
String |
N |
R |
O |
The unique name that identifies the call park group. Used in the put requests modifies the current name. Is not returned in the get instance response, only in the get list one. |
recallTo |
String |
A |
R |
O |
Determines where the parked call is sent when the recall timer expires. A value from list: [‘parkingUserOnly’|’parkingUserThenAlternateUser’|’alternateUserOnly’] *parkingUserOnly: to alert only the user who parked the call. *parkingUserThenAlternateUser: to first recall the user who parked the call and the alternate user if the parking user does not answer the recall. With this selection the ‘recallAlternateUserId’ must be provided. *alternateUserOnly: to alert only the alternate user. With this selection the ‘recallAlternateUserId’ must be provided. |
recallAlternateUserId |
String |
C |
C |
C |
The user Id of the alternate recall user (hunt group). It is nillable only if ‘recallTo’ is set to ‘Parking User Only’. |
users |
Array |
A |
O |
O |
The assigned users in the order they will try to be parked on. The get response is an array of objects as defined as User common object. For put and post requests only the ‘userId’ is requested for each object. For put is a replacement list. |
Available alternate recall user¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
userId |
String |
A |
Unique name for the user. |
firstName |
String |
A |
User’s first name. |
lastName |
String |
A |
User’s last name. |
Group call center default disposition code attributes¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
action |
String |
A |
C |
The routing policy processing action to execute. Call Center Standard: a value from list [‘None’|’Busy’|’Transfer’]. Call Center Premium: a value from list [‘None’|’Busy’|’Transfer’|’Night Service’|’Ringing’|’Announcement’]. |
transferPhoneNumber |
String |
C |
C |
The transfer phone number, it is mandatory if action is set to ‘Transfer’. |
Immediate Trunking Connectivity Numbers Range attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
DELETE |
|||
minPhoneNumber |
String |
A |
R |
R |
The min range phone number. |
maxPhoneNumber |
String |
A |
R |
F |
The max range phone number. |
groupId |
String |
A |
F |
F |
The unique id of the group. |
userId |
String |
A |
F |
F |
The unique id of the user. |
lastName |
String |
A |
F |
F |
The last name of the user. |
firstName |
String |
A |
F |
F |
The first name of the user. |
phoneNumber |
String |
A |
F |
F |
The phoneNumber name of the user. |
extension |
String |
A |
F | F | The extension of the user. |
||
emailAddress |
String |
A |
F | F | The email address for the user. |
||
enterpriseTrunk |
String |
A |
F |
F |
TO DO |
active |
Boolean |
A |
F |
F |
Specify if the range is active or not. |
extensionLength |
String |
C |
F |
F |
Specify the length of the extension. Introduced with patch from rel 23. |
Immediate Trunking Connectivity Available Numbers Range attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
minPhoneNumber |
String |
A |
The min range phone number. |
maxPhoneNumber |
String |
A |
The max range phone number. |
active |
Boolean |
A |
Specify if the range is active or not. |
extensionLength |
String |
C |
Specify the length of the extension. Introduced with patch from rel 23. |
Immediate Trunking Connectivity Prefixes attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
DELETE |
|||
prefix |
String |
A |
R |
R |
The prefix number. |
active |
Boolean |
A |
N |
N |
Specify if the range is active or not. |
groupId |
String |
A |
F |
F |
The unique id of the group. |
userId |
String |
A |
F |
F |
The unique id of the user. |
lastName |
String |
A |
F |
F |
The last name of the user. |
firstName |
String |
A |
F |
F |
The first name of the user. |
phoneNumber |
String |
A |
F |
F |
The phoneNumber name of the user. |
extension |
String |
A |
F | F | The extension of the user. |
||
emailAddress |
String |
A |
F | F | The email address for the user. |
||
enterpriseTrunk |
String |
A |
F |
F |
TO DO |
extensionRangeStart |
String |
C |
F |
F |
Specify the starting range of the extension. Introduced with patch from rel 23. |
extensionRangeEnd |
String |
C |
F |
F |
Specify the starting range of the extension. Introduced with patch from rel 23. |
Immediate Trunking Connectivity Available Prefixes attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
prefix |
String |
A |
The prefix number. |
active |
Boolean |
A |
Specify if the range is active or not. |
extensionRangeStart |
String |
C |
Specify the starting range of the extension. Introduced with patch from rel 23. |
extensionRangeEnd |
String |
C |
Specify the starting range of the extension. Introduced with patch from rel 23. |
Group instance¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
groupId |
String |
A |
The unique id of the group. |
tenantId |
String |
A |
The unique id of the tenant that owns the group. |
Flexible Seating Host in list attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
serviceUserId |
String |
A |
Uniquely identifies a flexible seating host. |
name |
String |
A |
The flexible seating host name. |
cliLastName |
String |
C |
The calling line id flexible seating host last name. |
cliFirstName |
String |
C |
The calling line id flexible seating host first name. |
phoneNumber |
String |
A |
The flexible seating host phone number. |
extension |
String |
A |
The flexible seating host extension. |
department |
object |
A |
The assigned department. An object as defined as Group department key attributes. |
language |
String |
C |
The flexible seating host language. |
timeZone |
String |
C |
The flexible seating host timeZone. |
timeZoneDisplayName |
String |
C |
The flexible seating host timeZone display name. |
defaultAlias |
String |
C |
The flexible seating host default alias. |
aliases |
array |
C |
The flexible seating host aliases. An array of strings identifying aliases. |
publicUserIdentity |
String |
C |
The flexible seating host public user identity. |
cliPhoneNumber |
String |
C |
The calling line id flexible seating host phone number. |
password |
String |
C |
The flexible seating host password. |
endpoint |
object |
C |
The flexible seating host endpoint. An object as defined as Access Device Endpoint for Flexible Seating. |
networkClassOfService |
String |
C |
The flexible seating host network class of service. |
active |
String |
A |
Specifies if the flexible seating host is active. |
guestInfo |
String |
C |
The guest info. An object as defined as Flexible Seating Guest Info. It is only returned when guest_info is sent within the request as true. |
policiesInfo |
String |
C |
The policies info. An object as defined as Flexible Seating Policies Info. It is only returned when policies_info is sent within the request as true. |
Flexible Seating Host attributes¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
serviceUserId |
String |
C |
O |
F |
Uniquely identifies a flexible seating host. |
name |
String |
C |
O |
O |
The flexible seating host name. |
cliLastName |
String |
C |
O |
O |
The calling line id flexible seating host last name. |
cliFirstName |
String |
C |
O |
O |
The calling line id flexible seating host first name. |
phoneNumber |
String |
C |
O |
O |
The flexible seating host phone number. |
extension |
String |
C |
O |
O |
The flexible seating host extension. |
department |
object |
C |
O |
O |
The assigned department. An object as defined as Group department key attributes. |
language |
String |
C |
O |
O |
The flexible seating host language. |
timeZone |
String |
C |
O |
O |
The flexible seating host timeZone. |
aliases |
array |
C |
F |
O |
The flexible seating host aliases. An array of strings identifying aliases. |
publicUserIdentity |
String |
C |
F |
O |
The flexible seating host public user identity. |
cliPhoneNumber |
String |
C |
O |
O |
The calling line id flexible seating host phone number. |
password |
String |
C |
O |
O |
The flexible seating host password. |
endpoint |
object |
C |
O |
O |
The flexible seating host endpoint. An object as defined as Access Device Endpoint for Flexible Seating. |
networkClassOfService |
String |
C |
O |
O |
The flexible seating host network class of service. |
active |
String |
C |
O |
O |
Specifies if the flexible seating host is active. |
guestInfo |
String |
C |
F |
O |
The guest info. An object as defined as Flexible Seating Guest Info. |
policiesInfo |
String |
C |
F |
O |
The policies info. An object as defined as Flexible Seating Policies Info. |
Flexible Seating Guest Info¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
enforceAssociationLimit |
Boolean |
A |
C |
Specify if to define an association limit that is defined with associationLimitHours. |
associationLimitHours |
Integer |
A |
C |
The hours limit for the guest association. |
accessLevel |
String |
A |
C |
The access level of a flexible seating GUEST. |
lastName |
String |
C |
F |
The guest last name. |
firstName |
String |
C |
F |
The guest first name. |
phoneNumber |
String |
C |
F |
The guest phone number. |
extension |
String |
C |
F |
The guest extension. |
locationDialingCode |
String |
C |
F |
The guest location dialing code. |
associationDateTime |
String |
C |
F |
The guest association date time. |
removeGuestAssociation |
Boolean |
N |
C |
Specify if to remove the guest association. |
Flexible Seating Policies Info¶
Name |
Type |
Methods |
Description |
|
---|---|---|---|---|
GET |
PUT |
|||
allowEmergencyCalls |
Boolean |
A |
C |
Specify if to allow emergency calls. |
allowCallsToVoicePortal |
Integer |
A |
C |
Specify if to allow calls to the voice portal. |
Access Device Endpoint for Flexible Seating¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
accessDevice |
Object |
A |
R |
R |
An object as defined in Access Device. In “advanced mode”: it is not returned within the GET and it is forbidden within the PUT. |
contacts |
Array |
C |
F |
F |
An array of contacts. |
deviceType |
String |
A |
C |
F |
In the POST it is mandatory if no accessDevice is provided. Else it is ignored. |
staticRegistrationCapable |
Boolean |
A |
F |
F |
Specifies if the device is capable of static registration. |
useDomain |
Boolean |
A |
F |
F |
The user’s line number, depending on the identity/device profile type you selected. Only used by devices with static line ordering. |
linePort |
String |
C |
O |
C |
The device line port. In “advanced mode”: it is forbidden when there is already a host assigned, it is optional when no host is assigned. |
lineNumber |
Integer |
C |
O |
C |
The device line number. |
staticLineOrdering |
String |
C |
O |
C |
The device static line ordering. |
Group route point DNIS instance¶
Name |
Type |
Methods |
Description |
||
---|---|---|---|---|---|
GET |
POST |
PUT |
|||
name |
String |
N |
R |
O |
The unique name that identifies the DNIS. |
phoneNumber |
String |
A |
O |
O |
The DNIS phone number. |
extension |
String |
A |
O |
O |
The DNIS extension. |
useCustomCLIDSettings |
Boolean |
A |
R |
O |
Specify if to use custom CLID Settings. |
cliPhoneNumber |
String |
C |
O |
O |
The calling line id phone number. |
cliLastName |
String |
C |
C |
C |
The calling line id last name. Is required if ‘useCustomCLIDSettings’ is true. |
cliFirstName |
String |
C |
C |
C |
The calling line id first name. Is required if ‘useCustomCLIDSettings’ is true. |
useCustomDnisAnnouncementSettings |
Boolean |
C |
R |
O |
Specify if to use custom announcement Settings. |
allowOutgoingACDCall |
Boolean |
C |
R |
O |
Allows the agent to use the DNIS number to make calls. |
Group route point DNIS List item attributes¶
Name |
Type |
Method |
Description |
---|---|---|---|
GET |
|||
name |
String |
A |
See ‘name’ from Group route point DNIS instance. |
phoneNumber |
Object |
A |
See ‘phoneNumber’ from Group route point DNIS instance. |
extension |
Boolean |
A |
See ‘extension’ from Group route point DNIS instance. |