How to Connect GitHub Issues With Zepel

Github issues are a great way to let end users of your code report bugs, ask for new features, and discuss enhancements to the code.

By Integrating Github with Zepel, you can now funnel all these requests into Zepel where you will be able to consolidate and prioritize them and also delegate them to your squads.

Follow the steps shown below to connect GitHub Issues with Zepel and work on building better software products painlessly.


Before you begin: Make sure you’re logged in to your GitHub account and have Streams subscription enabled in your Zepel account.

IN THIS PAGE

  1. Connecting GitHub Issues with Zepel
  2. Creating a Zepel Streams Request from GitHub Issues

Connecting GitHub Issues with Zepel

  • Go to the User Settings in GitHub.

  • Click on the Developer Settings tab.

Developer Settings Tab in GitHub

  • Select the Personal access tokens tab and click Generate new token.

  • On the page that appears, give your access token a name and select the scope - user:email.

New Access Token Page in GitHub

  • Copy the access token that has been generated.

Access Token in GitHub

  • Move to the Zepel Streams page, click the Add Source button, and then select GitHub from the list of integration sources.

  • Paste the copied access token and click the Enable GitHub toggle button.

  • Copy the webhook url that appears in the popup once the integration has been enabled.

Webhook URL for GitHub Issues  in Zepel Streams

  • Go back to the GitHub homepage, select the desired repository, and click on settings.

  • Select Webhooks from the left sidebar and click on the Add webhook button.

  • Paste the copied webhook url in the space provided, select the relevant options you need but ensure that you have enabled the webhook event topic Issues.

  • Click on the Add webhook button.

Add Webhook in GitHub


Creating a Zepel Streams Request from GitHub Issues

  • Go to your desired repository in GitHub and select the Issues tab.

  • Click on the New issue button to create a new request.

  • Give the request a title and a description and click on Submit new issue.

Create New Issue in GitHub Issues

Tip: Use the label option to create a label called zepel to help you organize all your requests from GitHub Issues within Zepel Streams.

Zepel Label in GitHub Issues

Note: You can view all the issues from GitHub Issues as requests under the Requests section on the Zepel Streams page.

And voila! You’ve successfully created your request. You can now organize these requests using tags, prioritize them, and link them to a feature/item within Zepel.


Tip: Use the available filters and sort options to view specific requests based on their source and status.