Integrate Aha! with GitHub
GitHub is the best place to share code with friends, co-workers, classmates, and complete strangers. Over eight million people use GitHub to build amazing things together. With the collaborative features of GitHub.com, our desktop apps, and GitHub Enterprise, it has never been easier for individuals and teams to write better code, faster.
This two-way integration allows you to push your features and requirements in Aha! into Github as issues and get status updates back. When you have completed your product roadmap and feature planning in Aha! you can move features into Issues for the engineering team to work on. You can send them individually or in bulk for a sprint or release. This makes it easy for product management to set brilliant product strategy and share visual roadmaps while engineering can continue to work in GitHub Issues.
You need to be a Product Owner in Aha! to set up this integration.
Please carefully follow these instructions to ensure that the integration is properly configured.
Step 1: Create the integration in Aha!
- Enter your Github username and password. Consider using a Github Personal Token rather than a password here. A token is essential if you use two-factor authentication with your Github account. Click the Test connection button
- After a short delay, you will be able to choose the repository the issues will be created in.
- Enable the integration.
- Test the integration by going to one of your features in Aha! and using the Send to Github Issues item in the Actions menu on the features page. You should then look at your repository in Github and see that the feature (and any requirements) were properly copied to issues.
Step 2: To receive updates when an issue is changed on Github you have to setup a webhook for the Github repository.
- In Aha!, copy the Webhook URL from the Github issues integration settings.
- On Github, go to the settings page of the Github repository and click on the Webhooks & Services tab.
- Add a new webhook.
- Paste the Webhook URL into the Payload URL field. Choose application/json as content type and leave the secret field blank.
- Select Let me select individual events. and then check only Issues.
- Finally, click Add webhook.
In the Github issues integration settings, you can choose to which Aha! status the "Open" or "Closed" state of an issue should map.