Installing the extension

1. Log in to your Zoho Desk account with Administrator privileges.
2. Click the Setup icon (  ) in the top bar.
3. Under Marketplace, click All.
4. Search for 'GitHub' in the search bar on the right.
5. Select the GitHub for Zoho Desk extension, then click Install.
6. Under General Settings, select the department and profiles whose agents can access the extension in Zoho Desk.
   
   
7. Agree to the Terms of Use, then click Install.
8. Click Authorize, then click Accept to authorize Zapps to activate the extension.
9. Click Authorize, then click Accept to authorize your Zoho OAuth service.
   
   
10. Click Authorize, and authorize with your Github credentials.
11. Under Configuration, provide your githuborgname.
12. Click Save.
    
    

Linking issues to tickets

1. Go to the Tickets module.
2. Click on the ticket you want the issue to link with.
3. In the widget, you will be asked to configure the github repository.
4. Click Ok.
   
   
5. Select the desired repository to link from the drop-down.
6. Click Save Changes.
   
   
7. In the Search box, search for the desired issue using a keyword.
   All the issues matching the keyword will be fetched from the repository and listed.
   
   
8. Add labels for the issue, if required.
   
   
9. Click Link issue.
   The issue will be linked with the ticket and the details will be shown as a comment.
   
   

Managing issues in tickets

1. Go to the Tickets module.
2. Click on the ticket for which you want to create an issue.
3. Click # (create issue) icon.
4. The selected GitHub repository will be shown by default.
5. Enter an Issue Title.
   
   
6. Provide a Description for the ticket.
7. Add Issue Labels.
8. Add Assignees to the issue.
9. Click Submit.
   The issue will be created and linked with the ticket, and the details will be shown as a comment.

1. Go to the Tickets module.
2. Click on the ticket for which you want to link an issue.
3. Click the Link icon.
   
   
4. Select the desired issue from the drop-down to link with the ticket.
5. Add labels for the issue, if required.
6. Click Link issue.
   The issue will be linked with the ticket and the details will be shown as a comment.

1. Go to the Tickets module.
2. Click on the ticket for which you want to remove an issue.
3. Click the  (edit) icon.
   The issues that are linked to the ticket will be listed.
   
   
4. Click Remove next to the issue title.
5. Click Confirm.

Manage extension settings

1. Click  (Settings) icon in the widget.
2. In Create Desk Ticket Comments, choose the comments to be public or private.
3. In Choose which list sections user can see, select the sections that can be visible to the user.
4. In Display linked issue, select the fields to be while listing the issues in the widget.
5. Click Save Changes.
   
   

Note: To view the Commits & Affected files information for an issue, the commit title should contain keyword in the below format.

                  zd#<Desk ticket number>space<commit name> (zd#577 commit 1)

Uninstalling the extension

1. Click the Setup icon () in the top bar.
2. In the Setup Landing page, click All under Marketplace.
3. In the Marketplace page, click Installed Extensions.
4. Choose GitHub for Zoho Desk from the list of extensions.
5. Click the More icon () in the upper-right corner of the GitHub for Zoho Desk extension setup page.
6. Select Uninstall Extension.
7. Click Confirm.