Microsoft has recently deprecated the ability to add connectors to Teams. Existing integrations should not be affected, but the deprecation might prevent new integrations between your Aha! account and Microsoft Teams. Please see this idea for progress on our ability to accommodate this change.
Aha! Roadmaps | Integrate with Microsoft Teams
Aha! Roadmaps powers your strategic planning so your strategy can inform every conversation you have about managing and prioritizing cross-functional work. Most of those conversations happen directly in Aha! Roadmaps, but many teams also rely on Microsoft Teams for real-time collaboration across the company.
Teams conversations are quick and immediate, but to be useful, they need strategic context. Aha! Roadmaps offers a one-way integration with Microsoft Teams so you can create an Aha! Roadmaps activity stream in Teams to funnel your roadmapping updates into one Teams channel.
In this article, we will cover the prerequisites and a brief overview of each integration.
![A features channel in Microsoft Teams with Aha! integration](https://images.ctfassets.net/4zfc07om50my/7FmJjdjqsct3tHC5qK2fjh/a3a17b6ddbb2815567e6a09d2a3bde74/_support_roadmaps_integrations_microsoft-teams_microsoft-teams-integration.png?w=750&h=391&q=90&fm=png&bg=transparent)
Click any of the following links to skip ahead:
Prerequisites
Integration type |
|
Aha! Roadmaps level |
|
Required user permissions: Configuration | |
Required user permissions: Use integration |
Access
The Microsoft Teams integration can be added at the account level, or you can set it up for a specific workspace.
Account-level integrations require administrator access with customization permissions.
Workspace-level integrations require workspace owner permissions.
Setup
Two steps are required to set up this integration: Create an incoming webhook in Microsoft Teams and create the integration in Aha! Roadmaps for your account or workspace.
In Microsoft teams
Open Microsoft Teams and select App.
Choose Incoming Webhook.
Enter your Microsoft Team and click Open.
Select the channel where you want to receive updates and click Set up.
To receive updates, the channel you select must be Public.
Name your webhook (e.g. "Aha! Roadmaps updates").
Download the Aha! Roadmaps avatar and upload it as the webhook image.
Click Create.
Copy the webhook URL. Click Done.
![Microsoft Teams configuration for Aha! integration](https://images.ctfassets.net/4zfc07om50my/1XxkLqrxIdJFwnf76mcKX3/e9bc4598dfdf8fcdef38093d6230031a/_support_roadmaps_integrations_microsoft-teams_microsoft-teams-integration.png?w=1057&h=701&q=90&fm=png&bg=transparent)
In Aha! Roadmaps
Start by adding the integration using the + icon located at Settings ⚙️ Account or Settings ⚙️ Workspace Integrations for your account or workspace.
Enter the URL into the Webhook URL field.
Click the Test connection button. After a moment, you should see a message appear in the Microsoft Teams channel you chose in Step 1.
Customize the integration by selecting the types of updates that you would like sent to your Microsoft Teams channel. You can also choose to filter the updates to only show changes from certain users.
Check the Enable checkbox.
Consider renaming this integration with your Microsoft Teams channel name for easy future reference. Something like, "Microsoft Teams: #Aha! Roadmaps updates". You can do this by clicking the Microsoft Teams text in the heading of the Integrations page.
![Microsoft Teams integration settings](https://images.ctfassets.net/4zfc07om50my/3muvJIJ7jjwVVqe3eulMUY/78ef08790ebbe44cd7c1a83cf5b91a97/Screen_Shot_2021-01-29_at_3.14.23_PM.png?w=750&h=418&q=90&fm=png&bg=transparent)
Use the integration
Once the integration has been set up, updates from Aha! Roadmaps will begin flowing into the Microsoft Teams channel that you chose during setup. Updates will come through to Microsoft Teams about five minutes after updates in Aha! Roadmaps are made. In Microsoft Teams, click View in Aha! to navigate directly to the Aha! Roadmaps record.
Any text that is added to Aha! Roadmaps records will come through as bolded text and any text that was removed will come through with strikethrough text.
![A general channel in Microsoft Teams with an Aha! integration](https://images.ctfassets.net/4zfc07om50my/38OWIYbESabzw4vxiL4Ta9/a8f4f6b5de9ebb0949fea901df29e303/_support_roadmaps_integrations_microsoft-teams_microsoft-teams-integration.png?w=1199&h=613&q=90&fm=png&bg=transparent)
If you get stuck, please reach out to our Customer Success team. Our team is made up entirely of product experts and responds fast.