Question

Can I get specific usage data on macros, triggers, and automations?

Answer

Disclaimer:This article is provided for instructional purposes only. Zendesk does not support or guarantee the code. Post any issues you have in the comments section or try searching for a solution online.

It is not possible to pull usage date for a specific date. However, you can obtain usage data for specific time ranges using the API: last hour, 24 hours, 7 days, or 30 days.

Whilemanaging your triggers, you can view or add columns that display how often the trigger has fired in the last 24 hours, 7 days, or 30 days. Managing macros or automations allows you to view how often they have been executed in the last 7 day period.

Option 1: Filtered API Request

Make a filtered request for each. The parameters described below are supported when filtering this information via the API.

usage_1h
usage_24h
usage_7d

Example:

https://yoursubdomain.zendesk.com/api/v2/macros.json?sort_by=usage_1h,usage_24h,usage_7d

Make sure you're logged in, then select your subdomain from the dropdown below to be redirected directly to this API call in your account.

.zendesk.com

Option 2: Sideload API Request

Make a sideload request to obtain the usage data for each. Sideloading gives you an option for tracking usage over a larger amount of time by allowing you to add the parameter of 30 days to the request. The sideloading parameters described below are currently supported.

usage_1h
usage_24h
usage_7d
usage_30d

Example:

https://yoursubdomain.zendesk.com/api/v2/macros.json?include=usage_1h,usage_24h,usage_7d

Note:使用参数宏与Su访问pport Enterprise and Professional plan levels, as well as Suite Growth and above plans, as suggested in thedeveloper documentation.

The API calls yield all macros, triggers, and automations in your account. The usage is displayed by the number of times that object was used during each parameter set. For more information on using the API to track usage data, see the developer documentation onmacros,triggers, andautomations.

Note:These API requests only display personal macros for the user that is making the request. To track the use of all personal macros, each user has to make a separate API call for their own personal macros.

5 Comments

Kirill Akimov
- January 26, 2022 09:51
Hi all!

Does zendesk dev team have plans for adding business rules analysis (triggers, automations ...) to Explore?

13
Nick Totarella
- May 30, 2022 12:22
This would be useful

0
Andrei Kamarouski
- October 26, 2022 18:22
Community Moderator
Hi all,
Take a look at the advancedMacros Reporting appto get a powerful macro usage analytics tool.

0
Liam Kelly
- April 07, 2023 17:12
So no way to see what tickets caused what triggers to fire? It would make troubleshooting a whole lot easier.

0
Viktor Osetrov
- April 11, 2023 10:49
Zendesk Customer Care
Hello James,

Agree with you. It will be handy to see what tickets caused what triggers to fire. Unfortunately, the "Triggers" tab doesn't provide information about that.
As a technical alternative, I would like to recommend for you the following workarounds:

-Viewing all events for ticket updates. However, using this method you can check tickets only step-by-step.

- Adding special tags for each trigger into action fields and analysing a special list ofwhat triggers to fire via "Tags" tab:

Hope it helps

0