How can I debug the Zendesk Apps framework (ZAF)?
The Zendesk Apps framework allows you to build apps with complex functionalities and features. This article provides guidelines on how to approach issues in the most common scenarios.
Capture the errors
Use the browser's developer tool
If an app shows unexpected behaviors, gather a list of errors for further research from the developer's tool of the browser.
To access the developer tool in different browsers
- Chrome: Open Chrome DevTools
- Firefox: Web Console
- Safari: Use the developer tools in the Develop menu in Safari on Mac
- Microsoft Edge: Open Microsoft Edge DevTools
The console displays any errors or warning messages. For network request errors, take a look at the network tab of the tool.
Generate a list of installed apps
Use query parameters
Generate a list of all the apps installed in the account.
The API endpoint List App Installations generates a JSON list of installed apps. Properties included can be used for the
app_ids query parameters discussed later:
- enabled: indicates whether or not an app is currently active
- app_id: the ID of the app. This is needed when using the
- installation ID: the installation ID of the app. This can optionally be used for the
noappsparameter. Apps can be installed multiple times if the app allows it. Each install will have a different installation ID but have the same app ID.
To access the endpoint
- Use curl
- Or append
/api/v2/apps/installations.jsonto the account's subdomain URL:
You must be an agent in the Zendesk account
Identify the app
Deactivate apps to find the culprit
Selectively activate and deactivate apps.
To deactivate an app
- In Support, follow the instructions in this article: Managing your installed apps.
- Or, append the
?noappssuffix to the ticket URL:
Generate a HAR file
Troubleshoot the issue by tracking information
The HAR file is a standard format used to track information and events between a browser and a website. It is always a good idea to record the network events in a HAR file to troubleshoot performance or rendering issues.
To generate a HAR file, see this article: Generating HAR file for troubleshooting.
Use the apps API
Troubleshoot the issue using the apps API
Leverage the API endpoint List App Installations to generate a list of the installed apps. Among the properties contained in the JSON response, use the installation ID as a query parameter for
noapps to disable multiple apps at the same time:
How to install and use ZAT on macOS, Windows, and Linux:
How to build a Support app from scratch:
- Build your first Support app - Part 1: Laying the groundwork
- Build your first Support app - Part 2: Designing the user interface
- Build your first Support app - Part 3: Creating and inserting templates
- Build your first Support app - Part 4: Getting data
- Build your first Support app - Part 5: Installing the app in Zendesk Support
How to build a server-side app
- Building a server-side app - Part 1: Core concepts
- Building a server-side app - Part 2: Display server-side content in a Zendesk app
- Building a server-side app - Part 3: Access external APIs
- Building a server-side app - Part 4: Access framework APIs
- Building a server-side app - Part 5: Deploy the app
- Building a server-side app - Bonus part: Secure the app
Please sign in to leave a comment.