The Out of Office app is a tool for managing the availability of an agent in Zendesk Support, and ensuring that tickets assigned to unavailable agents are properly handled if updated by a customer.
This article covers the following topics to help you install, use, and extend the app:
- How the app works
- Installing the app
- Changing the app settings
- Using the app
- Understanding the 'agent_ooo' tag
- Known limitations
- Troubleshooting
How the app works
The Out of Office app displays the availability status of the agent assigned to tickets in Zendesk Support.
For administrators, it also displays a list of agents and their availability.
The app prevents tickets from being accidentally assigned to an agent who is unavailable. When this occurs, a pop-up notification is displayed to the agent.
Installing the app
To install the Out of Office app
- In the Zendesk App Marketplace search bar, search for Out of Office, and select the app from the results list.
- Click Install in the upper-right corner.
- Select or unselect the Confirm status change checkbox. Unselecting this option disables the status change confirmation message. As a result, you cannot choose to unassign an agent's open tickets when marking them as unavailable.
- Select or unselect the Force unassign tickets checkbox. Enabling this setting unassigns an agent's open tickets automatically when their status is changed to unavailable. This option is disabled by default, allowing the unassign action to be run on a case-by-case basis.
- Select or unselect the Prevent assignment checkbox. Disabling this option allows tickets to be saved if they're assigned to an agent who's unavailable. A warning is still displayed that the assignee is unavailable, and agents can assign tickets to themselves regardless of their status.
- Select or unselect the Surface errors encountered
when bulk updating tickets? checkbox. Enabling this option causes the unassign process to take longer. Some tickets may still not get updated by Out of Office even with this setting turned on. This setting simply verifies the ticket updates and surfaces any errors encountered whilst updating tickets. - If required, select and configure role restrictions and group restrictions.
- Click Install to complete the setup.
Changing the app settings
You can modify the app's default behavior by changing the app settings.
To change the app settings
- In Admin Center, select Apps and integrations > Zendesk Support Apps.
-
In the Out of Office app icon, select Change Settings from the dropdown options menu.
- Modify your settings and click Update.
Using the app
An agent can modify their status using the app in the ticket sidebar or accessing their user profile.
To modify your availability
- Open a ticket in Zendesk Support. Alternatively, select your user profile icon the upper right, and then click View Profile.
- In the ticket app sidebar, under the Out of Office app, select the Availability toggle button. A confirmation dialog box opens to confirm the change.
- Click Set as Available to enable availability, or Set as Unavailable to set your status as unavailable.
An administrator can access the Out of Office dashboard to view the availability of agents and modify an agent's status.
To view and modify an agent's availability
- In Support, select the Out of Office icon in the left navigation bar. The dashboard opens.
- Click on the Availability toggle button next to agent. A confirmation dialog box opens to confirm the change.
- Click Set as Available to enable availability, or Set as Unavailable to set an agent's status as unavailable.
Changing the availability status either adds or removes the agent_ooo tag from tickets. For more information, see Understanding the agent_ooo tag below.
When a pending or on-hold ticket is reopened by an end user and the assignee is unavailable, a trigger fires that returns the ticket to the unassigned ticket queue.
The app checks the status of the assignee each time a ticket is saved. If the assignee is unavailable, the app warns the updater that the assignee is unavailable. If the Prevent assignment setting is enabled, it also prevents tickets from being saved if the new assignee is unavailable.
The following functions and behavior can occur when using the Out of Office app in Zendesk Support:
-
An agent can assign a ticket to themselves if they are unavailable. The following warning is displayed after the ticket is saved:
- An agent cannot update a ticket if they're not the assignee and the assignee is unavailable. A warning notification is displayed that the current assignee is unavailable:
- Tickets that are assigned to an unavailable agent with a Pending and On-Hold status, but are updated to Open, are reassigned to the respective ticket's parent group. However, the Assignee field becomes empty. Status changes from Pending or On-Hold occurs when an end-user replies to an email notification.
Understanding the agent_ooo tag
When the Out of Office app is installed, it automatically creates in Zendesk Support the following items:
- A user field that applies an agent_ooo tag to users marked as unavailable
- A trigger to handle the unassign action on a ticket based on the agent_ooo tag
- A trigger to remove the agent_ooo tag from a ticket when it's assigned to a different agent
Note: These items are required for the app to work. Don't delete or modify them.
Changing the availability status either adds or removes an agent_ooo tag on tickets based on the following rules:
- When an agent marks themselves as unavailable, the agent_ooo tag is added to the agent's user profile in the Agent Out? user field.
- Adding or removing the agent_ooo tag, or selecting/deselecting the Agent Out? field doesn't change the agent's availability. Availability can only be changed using the Availability toggle button.
- When the agent changes their status to unavailable, the tag is added to all tickets assigned to the agent with a Pending, On-Hold, or Solved status.
- When the agent changes their status to available, the tag is removed from these tickets.
- Any open tickets with the tag are unassigned on update.
- If the ticket assignee is changed, then the tag is removed.
- If the tag is removed from a ticket, no other tags are removed.
Limitations
The Out of Office app has the following limitations:
- Agents require permissions to edit ticket tags to mark themselves out-of-office. Without this permission, agents can use the Availability toggle to modify their availability, but their tickets will not be updated with the tag. If ticket tag editing permissions cannot be enabled for agents requiring out-of-office functionality, admins must manage their out-of-office status on their behalf.
- The app does not reassign tickets if the agent's out of office status is changed outside of the Out of Office app.
- The app does not work on Side Conversations.
- The app does not prevent assigning tickets unless the ticket is updated individually through the Zendesk interface. Triggers, Mail API, REST API, and bulk editing will be able to bypass the assignment restrictions.
- Agents can still self assign/take ownership of tickets while they are out of office. The app will not prevent this. The app also can't prevent tickets being assigned to agents while they are out of office when done through outside the Zendesk interface.
- Agents without administrator rights can't change their status using the app dashboard in the left navigation bar of the agent interface.
- Agent statuses doesn't affect Out of Office app functionality.
- If the Prevent assignment setting is disabled and a ticket is assigned from one unavailable agent to another unavailable agent, the agent_ooo tag will be lost. This means that the ticket will not be unassigned if it is reopened.
- Groups with only one agent:
- Agents are able to assign a ticket to a group with only one agent even if the sole agent in that group is unavailable.
- If there is only one agent in a group that can be assigned tickets, all tickets assigned to that group will automatically be assigned to that one agent. Some agents in groups, such as light agents, do not have permission to be assigned tickets.
- If an agent is the only agent in a group and the agent goes out of office, the assigned tickets will not be re-assigned back to the group. This is due to the inborn system ticket rules.
- The agent_ooo tag is added to solved tickets. If the ticket is closed while the tag is applied, however, the tag will not be removable because Tickets in the closed status cannot be updated. This may be undesirable for reporting purposes. If so, the system automation that closes solved tickets should be modified to remove the agent_ooo tag before closing the ticket.
- When a ticket assigned to an out of office agent gets updated, the ticket is assigned back to the parent group with a null Assignee value. The trigger working in the background during this action does not currently send an email notification to the agents in the group
- In some instances, if an agent is downgraded to an end user while unavailable, they will retain the agent_ooo tag until it is removed manually. Any tickets that the end user creates also inherits the agent_ooo tag.
- Follow-up tickets are not unassigned when the Copy original group and assignee to follow-up ticket and Force unassign tickets settings are turned on, and the agent is unavailable; they are added to the original assignee's queue.
- API Limits:
- When updating a large amount of tickets API rate limits can be encountered causing the update process to take longer than usual. Please be patient and allow the app to finish the update process. The update process is finished when the app no longer displays "Updating..." in lieu of the agent's OOO status
- The volume of tickets associated with an Agent will impact app performance and updating a large amount of assigned tickets can fail resulting in the agent_ooo tag not being added to all the tickets resulting in tickets not being assigned back to the parent group
- When marking an agent as OOO and un-assigning all open tickets, only some of the tickets will actually get unassigned
- If an agent closes the browser tab in the midst of an update or if there is a network issue, OOO updates may be lost causing incomplete updates to tickets.
- The framework within which the Out of Office app is built in has inherent limitations in terms of resolving errors and retrying. In cases where it encounters errors updating tickets or API limits can result in issues such as: some or all of the assigned tickets missing the agent_ooo tag when an agent changes their status to "Unavailable". The following workarounds can be tried to resolve such issues.
- Enable the Surface errors encountered when bulk updating tickets app setting. This will notify if any errors were encountered when updating the assigned tickets - either removing or adding the agent_ooo tag. By default this setting is disabled.
- Toggle the status in the app to "Available" and toggle the status to "Unavailable" (again) - or vice versa.
- Bulk update all tickets and add the agent_ooo tag if the agent is going to be "Unavailable" or remove the agent_ooo tag if the agent is going to be "Available"
Troubleshooting
If you cannot install the Out of Office app, and get and error "agent_ooo has already been taken", review the following steps:
- Remove the user field that has the field key agent_ooo - most likely named "[Out of Office] Agent Out" or the user field is in inactive state
- If you get an error while removing the user field, check your triggers or automations and remove any references to this user field
46 comments
Julia DiGregorio
Megan Leach - Hello Megan are you talking about an out of the box feature or still the Out Of Office Application. I uninstalled OOO application as is it didn't work on new or open tickets. Based upon your post I looked but didn't see and Agent Out option on the profile
0
Megan Leach
Julia DiGregorio - I believe it's a part of the out-of-office app. So before, agents who are part of a group that the OOO app is enabled for, can go into any ticket and toggle on/off their availability. They can also do this by going into their profile and using the app on the right-hand side.
However, recently, in an agent's profile (all agents regardless of if they are in the OOO app group or not) on the left-hand side, there's a checkbox. This isn't listed anywhere in the article and acts differently than the app.
I want to better understand what this checkbox does as it doesn't demonstrate the same functionality as described above (i.e. no pop-up where the agent can select to unassign tickets).
0
Julia DiGregorio
Megan Leach thanks for the clarification. I tried the app last year and found it very limiting and didn't like the fact you couldn't change the triggers for Open and New Tickets
1
Chris Wooten
I may be off but did the triggers lose fields for the assignee in one of the latest updates?
My trigger now references the requestor instead of the user? Is this correct? I am getting reports of tickets not moving when they reopen. I have had this set up for over a year with no changes. This option in my trigger history is not even available now. Has anyone else seen this?
This is what it was.
This is what is says now.
0
Jürgen Wagenbach
Hi
The "Out of office" app works fine for almost any of our agents. There are just "Restricted agents" which fail to use it.
The agent group which has troubles in using the "Out of office" app is the only one of our company which is defined as so-called "Restricted agents", i.e. all agents of this group just has access to "Tickets in agent's groups", see below:
It seems that the "Out of office" app does not work properly for such "restricted agents". They get stuck in a never-ending message "Loading agents" when the "Out of office" icon is clicked. They never get the agent list to modify their own availability status.
Is it a known restriction of the "Out of office" app that it cannot be used by "Restricted agents"?
I did not find any information about such a restriction in the "Known limitations" section of this document.
Do "Restricted agents" of other companies run into same "Endless loading agents" issue when they try to use the "Out of office" app?
Thanks for bringing some light into this.
Juergen
0
Ivan Miquiabas
Thanks for reaching out! When you say "restricted agents" are you referring to role and group restrictions? We would need further checking on your issue, Screenshots and HAR file, Thus I would encourage you to send us a ticket following your options here.
Cheers!
0
Jürgen Wagenbach
Hi Ivan
I am surprised to read that it seems not to be fully clear what "Restricted agent" means because this term is defined by Zendesk ;-).
Please find Zendesk's "Restricted agents" definition below:
"A restricted agent doesn't have access to all of the tickets within a Zendesk account. They're only able to view and edit tickets within their organizations and groups. If an agent is restricted they're also unable to edit or create end users."

See "Restricted agents" also explained in these links of Zendesk documents:
-> https://support.zendesk.com/hc/en-us/articles/4803993367706
-> https://support.zendesk.com/hc/en-us/articles/4408883763866
The Zendesk documents explain clearly what I meant with "Restricted agent". It is agent which belongs to an agent group which has just the right to access tickets of his own group. My already copied in screenshot shows this configuration quite clearly:
The screenshot shows that the agent belongs to the agent group "Measurement Technology" and he / she has just access to tickets assigned to the group "Measurement Technology". The agent can add "Notes and Replies" to any ticket assigned to this support team group but he / she has no access (and cannot see) tickets assigned to other support groups. We use this configuration to keep the "Measurement Technology" group away from viewing tickets which they are not in charge of.
I am afraid that there are no other screenshots which might be useful or can be shared. If such a "Restricted agent" clicks the "Out of office" palm icon, he / she gets permanently the message "Loading agents" but this list is never loaded.
It just seems to be possible for "Restricted agents" to modify their "Out of office" status directly in their account using the app via the selection (but not via the "Palm" icon):
P.S.:
If you need such a file, please let me know what it is and how to create it.
Thanks
Juergen
0
Ivan Miquiabas
Apologies for the confusion what I meant was on the on the restriction on the app itself, explained on this article. I was about to ask what is the current set up on the app itself not specifcally the defined general term in Zendesk which you are correct it was explained thoroughly, but there are also what we called "Role restriction" and "Group restriction" settngs on the app settings. I wanted to ask if this s enabled on your Out of office app or not?
But anyway, I created a ticket on your behalf so that this can be checked further, this is the ticket number: 12437690
Cheers!
0
Jürgen Wagenbach
Hi Ivan

Thanks for creating a ticket.
There had been no(!) role or group restrictions enabled in the "Out of office" app configuration:
0
Hannah Lucid
Hello,
We've encountered an issue that contradicts this segment of the documentation:
Tickets that are assigned to an unavailable agent with a Pending and On-Hold status, but are updated to Open, are reassigned to the respective ticket's parent group. However, the Assignee field becomes empty. Status changes from Pending or On-Hold occurs when an end-user replies to an email notification.
While doing testing, we found that when an Agent takes a ticket in a Pending/On-Hold status and updates the Assignee to an Agent who is unavailable (out of office) and submits as Open (changing the status from Pending/On-Hold to Open), the ticket will not update. We DO have Prevent Assignment flagged. Is this causing the conflict? If not, can someone help resolve the issue? :)
0
Hannah Lucid
Also! I feature request: It would be amazing to be able to add a Available/Unavailable (out of office, in office) column to views. This way, Team Leads and quickly identify tickets and agents that are out of office. :) I know there is a setting the unassign tickets when a person goes out of office but we don't want to utilize that feature.
0
Hannah Lucid
Checking in on this.
0
Morten Frisch
Will this decade old problem be solved with the release of unified statuses? Add a custom status called Out of Office, and let the agent custom status be included as options in triggers and automations. Problem solved.
1
Jay Pliskow
Our organization does not want Open tickets to be unassigned as our Agents are highly focused and specialized. However, we use the agent_ooo tag to keep track of customer responses and reply as needed to tickets on behalf of the assigned Agent while they are OOO.
The app however, only applies the agent_ooo tag to tickets that are pending, on-hold, and solved. It does not apply them to open tickets. Why is this? Is this the expected behavior?
@John DiGregorio seems to have submitted this issue back in May, 2023. Was there some resolution?
0
Henrik Eijsink
My team is having many of the same issues that I can see has been complained about many times for many years. Is it possible to share the github of this project, that way we are able to fork the projects, and implement our own version of the app. I found the github for the old version already, but I have not managed to find the new version
0
Steven Granner
I am also here to express my interest in allowing non-Admins to toggle the status of other agents on the behalf. It would be great to be able to specify which Roles have this ability!
0