Integrate Aha! with FogBugz (Integrations 1.0)

This integration allows you to push your features, activities and requirements in Aha! into FogBugz and get status changes back.

Because this is a two-way integration, your product or marketing strategy can flow from Aha! to your development team in FogBugz, and receive status updates back as they complete the work. 

You can also create multiple integrations per workspace to accommodate how the engineering team is split up. Note: Make sure you give each integration a unique name to keep the teams straight.

Configure this integration in Settings > Product or Settings > Workspace. You need to be product owner or marketing owner in Aha! to set it up.

Features of the integration

Aha! features and activities map to Fogbugz issues, and Aha! requirements map to Fogbugz sub-cases. 

From Aha! to FogBugz

When Aha! sends a feature or activity to FogBugz, it sends the following fields: name, description, requirements, attachments, and tags.

We'll describe the integration here using the language of products in Aha! (features, releases, etc.) but the same functionality exists for marketing workspaces (activities, schedules, etc.).

  • One Aha! workspace is associated with one or more FogBugz projects.
  • Individual features can be sent to FogBugz using the Send dropdown on the Aha! feature detail drawer.
  • All features in a release that have not already been implemented or sent to FogBugz previously can be sent to FogBugz using the Send to FogBugz option in the Send dropdown on the release page.
  • When a feature is copied to FogBugz, one issue will be created for the feature.
  • Only the description of a feature is sent and its requirements are created as sub-cases. No tasks or comments are included.
  • Attachments of a feature and requirements are also sent.
  • Tags on a feature in Aha! will become tags in FogBugz.
  • After a feature is first sent to FogBugz, changes to the name, description, and tags can also be sent to FogBugz using the Update FogBugz option from the More options button. Find this next to the link to the FogBugz record on the features page. If an attachment is deleted on the Aha! side, the corresponding attachment in FogBugz is not deleted.

From FogBugz to Aha!

Changes in the status of a story in FogBugz will be reflected in Aha! This allows you to track which stories have been completed.

Create the integration

Note: you will need an API token to use the FogBugz integration. Find out how to get an API token here.

In Aha!

  1. In Aha!, navigate to the product or workspace you wish to integrate.
  2. Under Settings > Product or Settings > Workspace, click the + icon next to Integrations, then click on FogBugz.
  3. Enter your FogBugz URL and API token. Click the Test connection button.
  4. After a short delay, you will be able to choose which projects the cases will be created in.
  5. Enable the integration.
  6. Test the integration by going to one of your features or activities in Aha! and selecting the Send to FogBugz option in the Send dropdown on the feature's or activity's detail drawer. You should then look at your FogBugz project and see that the feature or activity was properly copied to a case.

In FogBugz

  1. Copy the Hook URL from the integrations page in Aha!
  2. In FogBugz, open the settings and select Webhooks.
  3. Create a new trigger and select Case Events.
  4. Paste in the Hook URL and append "?case_number={CaseNumber}"
  5. Select Post.
  6. Name your trigger "Aha!" and create it.

To help you troubleshoot any errors, we provide the detailed integration logs. Contact us at support@aha.io if you need further help.


Was this article helpful?
0 out of 0 found this helpful