IMPORTANT: You MUST refresh the entire browser window that is currently running Zendesk; do not click simply click the "reload all apps" button, as this will re-start the authorization process
To associate a GitHub commit or issue, all you have to do is include the Zendesk ticket number in a GitHub commit comment or GitHub issue description, prefaced by "gz#"; in the below example, the Zendesk ticket number is 12345:
this is a comment for gz#12345
You may add more than one ticket number in the same commit (or issue) comment; both tickets will have the commit (or issue) added to it in Git-Zen.
gz#12345 and gz#67890 were affected by this commit
You may add commits from different repositories to the same ticket; this is especially useful when a solution to a ticket is spread across multiple projects, such as a when a change is required to both a database schema and a web application in order to solve an issue.
Git-Zen installation is quick and easy; Git-Zen will step you through the process. Git-Zen requires two different access points in order to function:
Once the Git-Zen application is installed in Zendesk, open any Zendesk ticket. Then, open the "Apps" sidebar. The Git-Zen application should be visible. You will be directed to begin the authorization process:
When you click "Authorize", a separate window will open requesting access to your Zendesk account; this is accomplished through a Zendesk OAUTH token (which can be revoked at any time in your Zendesk user account "security" settings tab). If you are not logged in to Zendesk, you will be asked to log in at this point.
After clicking "Allow" on the Zendesk authorization screen, you will be taken to the authorization screen for your GitHub repositories. If you are not logged in to GitHub, you will be asked to log in here.
Once you authorize Git-Zen to access GitHub, the authorization window will close. Return to your Zendesk window, and refresh the Zendesk window. IMPORTANT: You MUST refresh the entire browser window that is currently running Zendesk; do not click simply click the "reload all apps" button, as this will re-start the authorization process.
You should now see the full Git-Zen application in the app sidebar. There will be a "Link GitHub" icon on the Git-Zen menu bar.
Click this icon to view your available GitHub repositories, and select which repositories you wish to have active for Git-Zen. Then, click the "Save Changes" button.
Git-Zen is ready to use!
If you do not wish to authorize Git-Zen to access your GitHub repositories automatically, you can still use Git-Zen by adding webhooks manually to your GitHub repostories. To do this, you will need your webhook URL from the Git-Zen menu.
IMPORTANT: Git-Zen cannot create GitHub issues without oAuth access; if you manually create webhooks, you can still link GitHub issues by adding a "gz#" comment in the issue comments, but you cannot create an issue directly from the Zendesk application.
First, complete the above steps (including the Zendesk authorization), but close the window when you are asked to authorize GitHub. Then, refresh your Zendesk browser window. Click on the "Webhooks" menu at the top of the Git-Zen application:
On the subsequent settings screen, find the section titled "Manual GitHub Configuration". This section will have a unique webhook URL for you to use.
Copy this URL to your clipboard, and then follow these steps:
Repeat these steps for each repository that you wish to use with Git-Zen. The same URL is used for every repository.