Bold360 and BoldChat Developer Center

getSetupItems

Returns setup items on the account for a specified folder type.

Input parameters

Parameter Type Required Description
FolderType integer Yes Related data item type. See output description under Return values below.

Request format

curl "https://api.boldchat.com/aid/$accountID/data/rest/json/v1/getSetupItems?auth=$authHash&FolderType=$FolderType"

Return values

Parameters are provided in alphabetic order. See Sample code for probable output.

Parameter Type Description
Data JSON array A JSON array of JSON objects with the mappings of fields to values.
AccessKey string Keyboard shortcut that inserts a canned message into an active chat.
AccountID numeric - ID code Bold360 product account.
Created date - ISO/UTC Date and time when the target resource was created.
Data text - heading JSON array heading that precedes report data output.
Deleted date - ISO / UTC Date and time when the item was deleted. The value is null if the item was not deleted.
DeletedBy string (max) The name of the agent who deleted the item. <None> or null value indicates that the <resource> was not deleted.
FolderID numeric The ID of the folder.
FolderType integer Related data item type:
  • 2 - Contacts
  • 3 - Tickets
  • 4 - Email
  • 5 - Chats
  • 6 - Visits
  • 7 - Reports
  • 8 - Canned messages for chats
  • 9 - Canned messages for emails
  • 10 - Brandings
  • 11 - Contact user categories
  • 12 - Chat button definitions
  • 13 - Invitation definitions
  • 14 - Chat window definitions
  • 15 - Departments
  • 16 - Email accounts
  • 17 - Agents
  • 18 - Contact user statuses
  • 19 - Website definitions
  • 20 - Chat user categories
  • 21 - Chat user statuses
  • 22 - Email user categories
  • 23 - Email user statuses
  • 24 - Ticket user categories
  • 25 - Ticket user statuses
  • 26 - Customer user categories
  • 27 - Customer user statuses
  • 28 - Permission groups
  • 29 - Chat invitation template variants
  • 30 - Contact custom fields 1
  • 31 - Contact custom fields 2
  • 32 - Chat custom fields 1
  • 33 - Chat custom fields 2
  • 34 - Email custom fields 1
  • 35 - Email custom fields 2
  • 36 - Ticket custom fields 1
  • 37 - Ticket custom fields 2
  • 38 - Customer referrers
  • 39 - Customer entry locations
  • 40 - Conversion codes
  • 41 - Conversions
  • 42 - Call user categories
  • 43 - Call user statuses
  • 44 - Call custom fields 1
  • 45 - Call custom fields 2
  • 48 - Call button definitions
  • 49 - Call window definitions
  • 50 - Calls
  • 51 - Call invitation template variants
  • 55 - External CRMs
  • 57 - Active Assists
  • 58 - Latitude and longitude coordinates
  • 59 - Co-browse bookmarks
  • 60 - Scheduled reports
  • 61 - Email redirects
  • 62 - XMPP clients
  • 65 - Knowledge Bases
  • 66 - Discussions
  • 67 - Languages
  • 73 - SMS
  • 74 - Text receiver
  • 75 - Canned messages for text messages
  • 76 - Text user categories
  • 77 - Text user statuses
  • 78 - Text custom fields 1
  • 79 - Text custom fields 2
  • 80 - Floating chat button definitions
  • 81 - Floating call button definitions
  • 82 - Twitter
  • 83 - Twitter accounts
Internal Boolean Shows internal versus external initiation of a chat session.
IsActive Boolean Shows whether a resource (operator, department) is active or not.
Language code - ISO 639 Language preference and setting for the operator.
Name string(30) The name of the folder as defined in the system.
SetupItemID numeric - ID Canned message identifier.
Status codes - set values "Success" when the call completes; "Error" when the call fails.
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.
Updated date - ISO / UTC Date and time when the <event/record> was most recently modified.

Sample code

{	
"Status": "success",	
"Truncated": false,	
"Data": [	
	{
	"SetupItemID": "445200406241354432",
	"Name": "welcome",
	"FolderType": 8,
	"FolderID": null,
	"AccountID": "447307266697849894",
	"Created": "2020-09-25T13:57:08.023Z",
	"Updated": "2020-09-25T13:57:08.023Z",
	"Deleted": null,
	"AccessKey": 196695,
	"IsActive": 1,
	"DeletedBy": null,
	"Language": null,
	"Internal": 0
	}
]	
}