GitHub for Zoho Desk

GitHub for Zoho Desk

GitHub is a developer platform that lets you manage projects and teams, follow projects, host code, and maintain documentation. Using the GitHub extension for Zoho Desk, customer support agents can easily track and manage issues added to GitHub repositories without leaving Zoho Desk.

Installing the extension

You can install the GitHub extension either from the Zoho Marketplace or from your Zoho Desk account.

To install from Zoho Desk:
  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.

Upon successful installation, the extension can be accessed from the right panel of the ticket detail page.

Linking issues to tickets

With the GitHub extension, you can link any existing issues within a repository in Github with a ticket in Zoho Desk. You can even link multiple issues to a single ticket.

To link an issue:
  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. Select the desired issue from the drop-down to link with the ticket.
  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

With this extension, you can create new issues for a ticket, link issues to tickets, and remove issues from tickets, all from within Zoho Desk. Any issues created in Zoho Desk will be reflected in Github, but issues removed in Desk will not.

To create an issue:
  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.
To link an issue:
  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.
To remove an issue:
  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

You can manage the actions triggered in the extension in the Settings tab anytime. To manage the 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.

    • Related Articles

    • Setting up Zoho Projects Integration

      Encourage collaboration between your customer support and product teams by integrating with Zoho Projects. The integration enables you to automatically create tasks and submit issues in Zoho Projects from inside support tickets. For example, if your ...
    • Highrise for Zoho Desk

      View customer details and deals from Highrise in Zoho Desk. Manage contacts, deals, and activities between Highrise and Zoho Desk. Add new customers and deals to Highrise from Zoho Desk. This integration makes it easy to understand customer's details ...
    • Zoho Sprints Extension for Zoho Desk

      Zoho Sprints is an online agile project management solution designed to help teams plan their project, track their progress, and deliver great products on time. It also enables people to discuss, collaborate, and iterate on their products to achieve ...
    • Asana Extension for Zoho Desk

      Asana, a simple project management tool enables you to break down goals and ideas into actionable tasks, assign these tasks to teammates, and communicate to move projects forward. The Asana extension for Zoho Desk helps you quickly address customer ...
    • Predefined and Custom Task Views

      Task List Views are used to group your tasks based on a defined set of criteria. For example, you can see a list of the tasks that were completed or of those that are due today. Besides these, you can use the Task Views to change owner or update two ...