If you followed along in the series, you should now have a working Zendesk app that you built from scratch. In this tutorial, you'll install the app in your Zendesk Support instance. The tutorial will also show you how to test and validate the app, and then package it for uploading.
- Testing and validating the app
- Packaging the app
- Uploading and installing the app in Zendesk Support
You can only upload and install private apps in Zendesk Support on the Professional or Enterprise plan. If you're on the Essential or Team plan, Zendesk offers developers a free, sponsored Enterprise account for testing and debugging apps. We ask only that you don't use it to provide actual support. See Request a sponsored test account .
This tutorial is part of a series on building a Zendesk app:
Testing and validating the app
Thoroughly test your app with the ZAT server. For example, open different tickets and switch between tickets.
Test the app
If your ZAT server is not already started, use the command line to navigate to the
xr_app folder and start the server.
$ zat server
If your test ticket is not already open, use a browser to navigate to any ticket in
Zendesk Support, append
to the ticket URL, and reload the page. The URL
should look something like this:
- If you see a shield icon in the Address bar, click the shield icon and agree to load an unsafe script (Chrome) or to disable protection on the page (Firefox).
- Click the Reload Apps icon in the upper-right side of the Apps panel.
- Try different tests.
- When you're finished, shut down the ZAT server by pressing Control+C.
Once you're satisfied the app is stable, run the ZAT validation tool to catch any problems before uploading the app to Zendesk Support. The ZAT validation tool runs the same tests that are run when an app is uploaded to the Zendesk App Market.
Validate your app
Use the command line to run the following command in your xr_app folder:
$ zat validateNote: If the command prompt isn't displayed, make sure you shut down the ZAT server by pressing Control+C.
- Fix any problems reported by the tool, then run validate again.
Packaging the app
The next step is to package the app in a zip file that can be uploaded to your instance of Zendesk Support.
Package your app
Run the following command in your xr_app folder:
$ zat package
The ZAT tool packages the app in a zip file and saves it in a tmp folder. Example:
Uploading and installing the app in Zendesk Support
At last you're ready to upload and install the app in your instance of Zendesk Support. You need to sign in to Zendesk Support as an admin. You must be on the Professional or Enterprise plan, or you must have a free sponsored account for developers .
Upload and install the app
- In Zendesk Support, click the Admin icon ( ) in the sidebar, then select Manage from the Apps category.
- Click Upload App on the page.
- Enter the name of your app (Requester X-ray).
and select the zip file of your app.
The ZAT tool placed the zip file in the tmp folder in your xr_app folder.
- Click Upload to upload the app to Zendesk Support.
When prompted, click
Note: If you want to restrict access to your app to just administrators or just agents, click Enable Role Restrictions before installing and choose the users.
When the process is complete, your app should appear as a private app in your list of installed apps on the page.
Your support team is ready to use the app. Open a ticket, click the Apps button in the upper-right corner, and click Refresh.
If you build an app that other support organizations might find useful, consider making it publicly available in the Zendesk Apps Marketplace. See the branding guidelines . When your ready to submit your app, visit apps.zendesk.com .