Unified Agent Status API
The Zendesk Unified Agent Status APIs allow admins to query all existing unified statuses for the account, and also update the unified status for agents.
A unified agent status represents an agent's availability for each channel of work. As such it includes statuses (such asonline) for each channel (such asmessaging) and the unified status id.
Available unified statuses include default unified statuses that are provided by Zendesk, as well as custom unified statuses created by your account admins.
The following are default unified statuses provided by Zendesk which you can use without any additional configuration.
| Name | Description | Channel Mapping | Id |
|---|---|---|---|
| Offline | 不能接收工作 | All channelsoffline |
2 |
| Online | Can receive work | All channelsonline |
3 |
| Away | Can only receive email tickets | All channelsoffline |
4 |
| Transfers Only | Can only receive work from other agents | All channelstransfers only |
5 |
You can use the Unified Agent Status APIs to enhance or develop monitoring, reporting, or routing functionality.
Run in Postman
If you use Postman, you can import the Unified Agent Status API endpoints as a collection into your Postman app, then try out different requests to learn how the API works. Click the following button to get started:
If you don't use Postman, you can sign up for a free account on thePostman websiteand download the app. For more information about using Postman with Zendesk APIs, seeExploring Zendesk APIs with Postman.
Response format
This API is based on theJSON:APIspecification, and this documentation assumes that you are familiar with that specification. It supportscursor pagination, and does not supportoffset pagination.