Create and comment on Aha! records from Slack

Aha! Roadmaps

This integration is simple to configure, and brings key Aha! functionality into your Slack account. Use it to optimize how your team works — capture new ideas, add comments, and assign tasks without interrupting the flow of conversation. You can even subscribe to receive updates on specific Aha! records to stay informed about the exact work you need to track.

Slack conversation discussing a new Aha! idea, and a thread open showing the idea's creation.

Click any of the following links to skip ahead:

Prerequisites

Integration type

  • One-way (Slack to Aha! Roadmaps )

You can enable an additional integration to send Aha! notifications to Slack.

Integration level

  • Account level

Required user permissions: Configuration

Required user permissions: Use integration

Associated records

Use Slack to create:

  • Initiatives

  • Notes

  • Whiteboards

  • Releases

  • Epics

  • Features

  • Ideas

  • To-dos

  • Comments on existing records

Top

How it works

After you configure it, use the integration to create records, comment on them, or subscribe to Aha! record update notifications. There are two ways to send information to your Aha! account from Slack. Hover over an existing message in Slack and use the Add record or Add comment shortcuts in the More actions menu. Choose your workspace and fill in any additional details you need.

You can also use slash commands to take action. The slash commands available to you depend on your Aha! user permissions:

User permissions

Slack commands

Effect

Workspace owners and contributors

  • /aha to-do

  • /aha feature

  • /aha epic

  • /aha release

  • /aha note

  • /aha whiteboard

  • /aha idea

  • /aha comment

  • /aha to-do

  • Creates a record

  • Comments on an existing record

Reviewers

  • /aha idea

  • /aha comment

  • Creates an idea

  • Comments on an existing record

Viewers

  • /aha to-do

  • Creates a to-do

All users

  • /aha help

  • /aha change account

  • /aha subscribe

  • Lists the Slack commands available

  • Allows you to change the Aha! account where you want to create or comment on records

  • Subscribes to specific Aha! record updates

When you create a record through the integration, Slack will ask you to choose the workspace where you want to create the record, and then show you the record's create layout — including custom fields — so you can capture the same critical information you would if a user had created the record directly in your Aha! workspace.

When you comment on a record through the integration, Slack will ask you to choose the record type and the record itself, then have you add your comment. The text editor for adding comments supports Markdown shortcuts, but not attachments.

Subscribe to Aha! record updates

Get notified about specific Aha! records directly in Slack. You can tailor automatic updates so everyone stays in the know about critical work without creating unnecessary noise. To receive focused Aha! record updates in your Slack channel:

In Slack:

  1. Invite the Aha! bot (which delivers updates from Aha! to Slack just like a human channel member) into this channel using the /invite aha command.

  2. Type /aha subscribe to open the Subscribe to record updates modal.

  3. Choose which record type you want to subscribe to from the dropdown menu.

  4. Find your record under Select record to subscribe to updates.

  5. Select the Notification types you would like to receive. This field includes popular options such as Comment added, Deleted, and Status updated, but you can specify other types of notifications you want to receive.

  6. Click Subscribe.

Now, everyone in your Slack channel will automatically receive a message whenever someone modifies an Aha! record with an update that matches your notification criteria.

You can edit your subscription or unsubscribe from record updates at any time by clicking the More options menu in the upper-right corner of your Aha! record notification.

Top

Configuration

  1. Navigate to Settings ⚙️ -> Account and click on the Integrations+ button and select the Slack [to Aha!] integration. You will need to be an administrator to do this.

  2. Within the integration configuration, simply click the Add to Slack button. This will take you to Slack where you can chose which Slack Team you want to connect to.

  3. You will be redirected back to Aha! Roadmaps where you can click the Enable check box to finalize the setup and turn the integration on.

  4. Once enabled, users will be asked to authenticate to their Aha! Roadmaps account when they use the integration for the first time. Afterwards, they will be able to begin creating and commenting on records. Afterward, they will be able to create and comment on records and can subscribe to notifications about specific Aha! records directly in Slack.

Top

Manage your integration

If you have multiple Slack integrations that you need to manage, use the Manage integrations report, located in:

  • Settings ⚙️ -> Account -> Integrations for account-level integrations.

  • Settings ⚙️ -> Workspace -> Integrations for workspace-level integrations.

Otherwise, if you run into any trouble with the integration process, please reach out to our Customer Success team. They are all product experts, and respond very quickly.

Top

Troubleshooting

To help you troubleshoot an error, we provide detailed integration logs below the integration's configuration page.

Still stuck? Please reach out to our Customer Success team and we would be happy to help.

Top

If you get stuck, please reach out to our Customer Success team. Our team is made up entirely of product experts and responds fast.