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.
To troubleshoot these issues, follow the steps below:
- Capture the errors
- Generate a list of installed apps
- Identify the app
- Generate a HAR file
- Use the apps API
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.
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
Generate a list of all the apps installed in the account.
The API endpoint List App Installations generates a JSON list of installed apps. The 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
Selectively deactivate apps to find the culprit. 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
The HAR file is a standard format for tracking information and events between a browser and a website. 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 leveraging 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:
If you want information on how to build a Support app from scratch, see this article: Build your first Support app - Part 1: Laying the groundwork. If you need information about how to build a server-side app, see this article: Building a server-side app - Part 1: Core concepts.