Department
- 05 Jul 2022
 - 1 Minute to read
 
- Print
 - DarkLight
 
Department
- Updated on 05 Jul 2022
 - 1 Minute to read
 
- Print
 - DarkLight
 
Article summary
Did you find this summary helpful?    
Thank you for your feedback!
You need the Manage Site permission to manage departments.
Departments- Departments ManageGET global/sites/{siteId}/departments- Get site Departments
Department JSON Format
Department is represented as simple flat JSON objects with the following keys:
| Name | Type | Description | 
|---|---|---|
id | guid | Id of the department. | 
name | string | Name of the department. | 
description | string | Description of the department. | 
isAvailableInLiveChat | bool | When the value is false, the department will not be displayed in the Pre-chat window, department drop down list, routing rules, chat transfer rules etc. Default: true. | 
isAvailableInTicketingAndMessaging | bool | When the value is false, the department name will not be displayed in the 'Assigned Department' field. Default: true. | 
offlineMessageMailTo | string | Allowed values are "toAllAgents", "toEmailAddresses". | 
offlineMessageEmailAddresses | string | The specified email addresses that offline messages are sent to. Available and required when Offline Message Mail Type is "toEmailAddresses". | 
agentIds | array | ID of the agents in this department. | 
isDeleted | bool | Whether the department is deleted or not. | 
chatbotSmartTriggerActionIds | array | The guid array of chatbot smart trigger actions for the selected departments. | 
shiftIds | array | The guid array of shifts for the selected departments. | 
segmentIds | array | The guid array of segmentations for the selected departments. | 
Get site Departments
GET global/sites/{siteId}/departments
Parameters:
| Name | Type | in | Required | Description | 
|---|---|---|---|---|
keywords | string | query | no | Filter by keywords in name of the department. | 
include | string | query | no | Allowed value is "agent". | 
siteId | int | query | yes | Id of the Site. | 
Response:
An array of Department
Example
Sample Request:
curl https://partnerapi.comm100.io/v4/global/sites/100/departments \ 
    -X 'GET' \ 
    -H 'Authorization: Bearer {access_token}' \ 
Response:
HTTP/1.1 200 OK
[
  {
      "id": "a0831b44-a2d0-4bed-96c4-43f7eb69b095",
      "name": "markting",
      "description": "markting departments",
      "isAvailableInLiveChat": true,
      "isAvailableInTicketingAndMessaging": true,
      "offlineMessageMailTo": "toAllAgents",
      "offlineMessageEmailAddresses": "andy@comm100.com",
      "isDeleted": false,
      "agentIds": [
          "3CA2EF45-7D46-EB11-8100-00155D081D0B"
      ],
      "chatbotSmartTriggerActionIds": [],
      "shiftIds": [],
      "segmentIds": []
  }
] 
Was this article helpful?