ZAT doesn't run in Windows
Problem: ZAT is a Ruby gem that requires Ruby 2.1 or later to run. However, the Windows installer for Ruby 2.4 and later has a dependency issue that prevents ZAT from running in Windows.
Solution: Install and use Ruby 2.3, or consider using Ubuntu for Windows 10 as your development environment. To install Ubuntu, see Setting up a Bash shell in Windows 10.
App doesn't load when ZAT server is running
To test your app locally, ZAT runs a local http server and inserts the app in the Zendesk Support https page. This results in mixed content.
After starting the ZAT server and opening a ticket with ?zat=true in the URL, clicking the Apps button does nothing. The browser is blocking your local app from loading in Zendesk Support.
To load the app, click the shield icon in the browser's Address bar and agree to load an unsafe script (Chrome) or to disable protection on the page (Firefox). In Firefox, the shield icon is located on the left side of the Address bar.
Click the Reload Apps icon in the upper-right side of the Apps panel.
Safari users: Starting with version 9, the Safari browser no longer supports mixed content and doesn't offer a way to turn this blocking off.
"Failed to build gem native extension" error in macOS or Linux
Installing ZAT on macOS may fail with the error shown below:
Building native extensions. This could take a while... ERROR: Error installing zendesk_apps_tools: ERROR: Failed to build gem native extension.This can occur if you don't have a C compiler installed on your Mac. To fix this issue, download and install Xcode, and then install the Xcode command line tools. If you need help installing the Xcode command line tools, please see this guide on macports.org for more information.
After installing Xcode, try installing ZAT again.
Install rake separately with $ gem install rake, then update ZAT with $ gem install zendesk_apps_tool.
"Failed to build gem native extension" error in Windows
Validate not working in Windows