getOperators
Returns operators (agents) for an account.
Input parameters
None.
Request format
curl "https://api.boldchat.com/aid/$accountID/data/rest/json/v1/getOperators?auth=$authHash"
Return values
Parameters are provided in alphabetic order. See Sample code for probable output.
Parameter | Type | Description |
---|---|---|
AssignmentPriority | integer | A weighting that can be applied to departments or operators for
ACD assignments:
|
AsyncService | text - heading | Messaging header. |
Available | Boolean | T/F - Shows whether a service - SMS, Twitter, Facebook, etc. - is available for access and use. |
Capacity | integer | Quantity of chat assignments that can be made concurrently for a given service. |
ChannelName | string | Name of the messaging channel in Bold. |
ChatService | text - heading | Data header for a JSON array. |
Data | text - heading | JSON array heading that precedes report data output. |
DepartmentID | numeric - ID code | ID of the department. |
Departments | text - heading | Heading for an array of department data. |
Disabled | Boolean | Shows the operator's disabled status. Disabled operators cannot login. |
string - legal email | Email address of the message's sender, if available. Must contain an @ character. | |
EmailName | string | A personal name for the Operator in the From address of emails the operator sends. |
EmailService | codes - set values | Data header showing an integer field, Capacity, and a Boolean field, Available. |
FacebookService | text - heading | Data header for the Facebook service. |
LoginID | numeric - ID code | Operator's Bold360 login ID. |
Name | string(30) | The name of the folder as defined in the system. |
OmniQueueService | text - heading | Header for Omni-queue channels available for the Operator. |
PermissionGroupID | numeric - ID code | Unique ID for the billing system permission group. |
Priority | integer | Indicates the priority/urgency of a chat as defined by the rules
engine:
|
SmsService | text - heading | Header for SMS Service reporting. |
SSONameID | string | The single sign-on ID of the operator. |
Status | codes - set values | "Success" when the call completes; "Error" when the call fails. |
TicketService | text - heading | Header for Bold360 Ticket Service reporting. |
Truncated | Boolean | TRUE if results were shortened to fit the report, FALSE if full results for the report criteria were returned. If TRUE, you can filter down the results set or contact us to try to find a way to get at the data you are looking for. |
TwitterService | text - heading | Header for Twitter Service reporting. |
UserName | string (max) | The user name of the Operator. Note: It cannot be changed later and must be
unique.
|
Sample code
{
"Status": "success",
"Truncated": false,
"Data": [
{
"LoginID": "445201225474815444",
"UserName": "bot_447307266697849894",
"ChatName": "Bot",
"Name": "Bot",
"Email": "bot_447307238097849894@bold360ai.com",
"EmailName": null,
"SSONameID": null,
"Disabled": null,
"PermissionGroupID": null,
"OmniQueueService": {
"Capacity": 0,
"Available": false
},
"AsyncService": {
"Capacity": 0,
"Available": false
},
"Departments": [],
"TwitterService": {
"Capacity": 0,
"Available": false
},
"SmsService": {
"Capacity": 0,
"Available": false
},
"EmailService": {
"Capacity": 0,
"Available": false
},
"FacebookService": {
"Capacity": 0,
"Available": false
},
"TicketService": {
"Capacity": 0,
"Available": false
},
"ChatService": {
"Capacity": 0,
"Available": false
}
},
]
}