A macro is a prepared response or action that an agent can manually apply when they are creating or updating tickets (see About macros). If you created macros for support requests that can be answered with a single, standard response or action, agents can evaluate tickets and apply macros manually as needed.
This article contains the following sections:
Related articles:
Macros to get you started
There are a number of macros you can use to get started, including:
-
Close and redirect to topics
This sets the ticket status to Closed. If it is an incident of a known problem, the requester will be informed via a comment that the ticket has been closed and recommended that they visit the forums for more information about the incident.
-
Customer not responding
This is a reminder that can be sent to the requester if they have not responded to a request for more information on a pending ticket.
-
Downgrade and inform
This tells the requester that the priority of their request has been downgraded to low and that there may be some delay in resolving their request.
-
Take it!
This macro is a shortcut for agents to assign a new request to themselves.
Applying macros from the menu
You can manually apply one or more macros to a ticket at the same time. Keep in mind that what one macro does can easily be undone by another macro.
Just as you can make bulk updates to many tickets at once, you can also apply a macro to more than one ticket using your views. See Managing tickets in bulk.
So why would you apply more than one macro? A typical use case is a ticket that contains more than one question or issue—let's say two in this example. You might have set up two macros that both insert a comment into a ticket to answer each issue separately. By applying each macro to the ticket, you add two comments and address both issues in a single response.
You can view which macros were applied in the ticket's events log.
To apply a macro from the menu
- In a ticket, click Apply macro in the bottom toolbar.
- Select a macro from the list. You can filter the list by typing the beginning of a
macro's name.
Typically, your five most commonly used macros from the past week appear at the top of the macros list. The most-used macros display can be disabled, in which case, you'll only see the all macros list. See Disabling the most-used macros option.
If your macros are categorized, you can click through the levels of categorization to apply a macro.
Note: Macros cannot be set up for specific channels.The actions defined in the macro are applied. If the macro updated the ticket comment, you can edit the text before submitting the ticket.
In the Zendesk Agent Workspace, if you have a macro that inserts text into a ticket comment, you can set an insertion point in the ticket comment first, before you apply a macro. This enables you to control exactly where the macro text appears.
Note: If the macro updates the ticket comment but the tab the ticket is open in is closed before the ticket is submitted, the text of the macro will still appear in the composer when you return to the ticket. However, after submitting the ticket, only the comment is updated and the macro isn't shown in the events log for the ticket. - To apply another macro, click Apply macro again and select another macro.Tip: Check out how we use macros to manage tickets with Brett Bowser's Improve escalation workflows using macros.
- Submit the ticket.
Applying macros with a keyboard shortcut
If you have Agent Workspace activated, you can apply macros using a keyboard shortcut in a ticket comment. Using a macro keyboard shortcut can save you typing time by applying a macro to a ticket with just a few keys.
Macro keyboard shortcuts are activated by default. To deactivate macro keyboard shortcuts, see Activating and deactivating macros keyboard shortcuts.
For more information about other keyboard shortcuts, see Viewing and deactivating keyboard shortcuts.
To apply a macro with a keyboard shortcut
- In a ticket, type a slash (/) in the ticket’s comment.Note: If you want to exit the Macros menu after typing a slash (/), press the space bar.
Typically, your seven most used macros from the past week appear at the top of the macros list, including both shared macros and any personal macros you may use.
Note: If your account has Chat or Messaging activated, the list displays both macros and shortcuts. See Using shortcuts in Chat. - Select one of these or begin typing a macro name to filter the list.
- Click the macro name to apply it to the ticket.
The actions defined in the macro are applied. If the macro updated the ticket comment, you can edit the text before submitting the ticket.
- To apply another macro, type a slash (/) in the ticket comment.
Previewing macros
You can preview a macro from the Apply macro menu before applying it to a ticket.
To preview and apply a macro from the menu
- In a ticket, click Apply macro in the bottom toolbar.
- Find the macro you want to use in the list.
- Click the Open preview icon ().
Alternatively, hover your cursor over the macro to display its description tooltip. From the tooltip, you can view the macro's description (if one exists) and access its preview by pressing Shift + Enter.
The preview shows the macro's title and description (if one exists), as well as the fields and elements the macro will change, add, or remove, including:
- Ticket fields
- Comments, replies, or notes (including placeholders and dynamic content)
- Attachments
- If the macro looks correct, click Apply Macro.
You can also click Cancel to return to the ticket screen, or click Open in Settings to view the macro's settings in Admin Center.
Using macros to update problem and incident tickets
Use caution when applying macros with placeholders to problem and incident tickets. It's easy to accidentally populate the wrong values in ticket comments when using macros with placeholders in this scenario. To avoid this, you often need use a backward slash (\) to escape the placeholder so that it populates the appropriate value within the related incident tickets.
For example: Hello
\{{ticket.requester.first_name}}