The GET /presence-definitions gets a list of all the presence definitions
| Panel | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
Parameters
No parameters other than authorization parameters required.
Responses
Responses to the endpoint returns a list of presence definitions.
Successful response
For information about successful responses, see Success response code and parameters in Responses (Agents API).
Example response
Presence definitions returned
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"presenceDefinitions": [
{
"presenceId": "4060362d-1ab1-11ec-a0c4-066a9ef411a8",
"selectable": false,
"category": {
"categoryType": "ExtendedAway",
"description": "Extended Away"
},
"description": "Extended away"
},
{
"presenceId": "734966bb-e646-46c3-a122-617765e92f89",
"selectable": true,
"category": {
"categoryType": "Ready",
"description": "Ready"
},
"description": "Ready"
},
{
"presenceId": "501ba176-4f62-4cbd-aa4d-dbaa4ed5411e",
"selectable": true,
"category": {
"categoryType": "Away",
"description": "Away"
},
"description": "Away"
},
{
"presenceId": "6bbbebbd-f160-4d8d-96db-411b755a18a4",
"selectable": true,
"category": {
"categoryType": "Away",
"description": "Away"
},
"description": "Break"
},
{
"presenceId": "399ae1f1-4bb7-4792-9d00-f2aa5889de6a",
"selectable": true,
"category": {
"categoryType": "Away",
"description": "Away"
},
"description": "Comfort Break"
},
{
"presenceId": "10be450a-4a19-4500-a474-67d6967f6c7f",
"selectable": true,
"category": {
"categoryType": "ExtendedAway",
"description": "Extended Away"
},
"description": "Paperwork"
},
{
"presenceId": "ee1de097-d0e3-4dce-9976-5958d807c1d6",
"selectable": true,
"category": {
"categoryType": "ExtendedAway",
"description": "Extended Away"
},
"description": "Lunch"
},
{
"presenceId": "ef8575b7-accd-4e70-9a9c-7c51fb4d59b6",
"selectable": true,
"category": {
"categoryType": "ExtendedAway",
"description": "Extended Away"
},
"description": "Training"
},
{
"presenceId": "a641ac39-a871-496a-9d2e-a86f4d71e25e",
"selectable": true,
"category": {
"categoryType": "ExtendedAway",
"description": "Extended Away"
},
"description": "Team Meeting"
},
{
"presenceId": "7af7f36f-bab6-498b-871e-468a4ee8a19a",
"selectable": true,
"category": {
"categoryType": "Ready",
"description": "Ready"
},
"description": "Ready (Outbound)"
},
{
"presenceId": "1253ee5f-799a-40f4-98d1-3dae65523a1f",
"selectable": true,
"category": {
"categoryType": "LoggedOut",
"description": "Logged Out"
},
"description": "Logged Out"
}
]
} |
where:
presenceDefinitions. Presence definition list.presenceId. A presence definition identifier. The presence definition ID is unique within the account.selectable. Indicates if this presence has been configured to appear for Agents to select.category. Category of the presence definition.categoryType. Type of presence definition category. Possible values: LoggedOut, Away, ExtendedAway, Readydescription. Description of the presence category. Used for display purposes only.
description. Description of the presence definition. Used for display purposes only.