github-freshdesk

Integrate issues on github with tickets in freshdesk.

This project creates a node based web service to receive webhook calls from Github and from Freshdesk for the purpose of integrating the issue tracking between the two systems. Freshdesk being a more appropriate forum for customer facing issues, including those that may result in code changes. In those cases it would be desirable to "hand off" the Fresh Desk ticket into a "developer issue" which is better tracked in github. It would also be good to synchronize additional notes from Freshdesk back to github as well as notify the freshdesk ticket at appropriate lifecycle points for the github change.

Installation

• You will need to host this node/express application on the public internet somewhere such that webhook calls from both github and freshdesk can find your application.

• You will need to create a config.json file in the main directory with the following configuration options:

   {
     "repo": "your-github-repo-to-link-to",
     "githubUser": "yourgithubusername",
     "githubPassword": "yourgithubpassword",
     "fd_api": "Your freshdesk API key",
     "fd_url": "https://youruniqueurlto.freshdesk.com",
     "fd_customfield": "name of custom field you're using to track github issue number",
     "fd_customdevstatus": <integer> of your custom FreshDesk status that triggers a linkage to github
   }
  

• FreshDesk's API doesn't provide an automated way to lookup the status. Look at the drop-down in a ticket for the status and count your custom status' position from the top (including the emtpy status of ...) starting at 1 (not zero). That count is what you'll put in fd_customdevstatus.