GitHub

ClearFeed has a robust integration with GitHub that allows agents and responders to file GitHub issues against requests.

Integrate GitHub

ClearFeed can be integrated with GitHub Organization accounts. You can read more about GitHub Organization accounts here.

1. You will need to be the GitHub organization admin to approve this access.

2. You can integrate GitHub by heading over to the Account settings →Integrations tab→ GitHub.

3. Press the Connect button against the GitHub section

4. You will be redirected to the GitHub login page, where you’ll need to log in and install the ClearFeed App.

5. You can select the app to be installed in all repositories or select specific repositories where it will be installed. (Note - if installed to specific repositories, only these repositories will be available to file GitHub issues).

6. Once the above steps are completed - ClearFeed's App will be installed into the GitHub organization account and you will be redirected to the ClearFeed web app to finish the setup.

Installing the ClearFeed App directly from the GitHub Marketplace

ClearFeed App can be installed from the GitHub Marketplace and post-installation, the integration can be completed.

1. Follow the link to get the ClearFeed app on GitHub Marketplace.

2. Click on Set up a plan.

1. Enter account and installation details and click on Complete order and begin installation.

1. Once the installation is complete, you will be redirected to the ClearFeed Web App.

2. Upon redirect, login to the ClearFeed Web App (if not logged in already) and you should get a success message which indicates that integration is completed.

Escalating to GitHub

Once you have integrated Github to ClearFeed, GitHub issues can be filed against a request from Slack using two ways:

1. ClearFeed Actions

2. More Actions from Triage Channel

ClearFeed Actions:

Against the message/thread from the request channel you want to file a GitHub issue, select ClearFeed actions from shortcuts.

Select “File a GitHub issue” option from ClearFeed Actions

Select the messages in the thread you want to be displayed in the GitHub issue. Note: Any attachments such as images selected to be filed will only be sent as a slack link

You can choose the repository in which you want to file the issue in. You can also edit the Title and description. You can also assign any user from GitHub to the issue.

Any labels and milestones from the GitHub organization can also be added while filing.

If the below check-box is selected, then updates from GitHub will be posted back to the same Slack thread when the Status of the issue has been changed.

Once the issue is closed, a message will be sent on the thread. On closure, a similar message will be sent.

Only Status updates on the filed issue will be posted back to the slack thread, which can be enabled or disabled while filing.

More Actions on Triage:

Similar to the request channel, you can file a GitHub issues from the triage channel easily by using the More Actions button on the triage channel. Read more about triage more actions here.