New Microsoft Teams Integration Setup

~ minute read

Microsoft is retiring the old Office 365 connectors within Teams. To keep your UserVoice notifications working, you must transition to their new Workflow system. This change requires you to replace your current connector with a new Workflow Webhook URL to ensure a permanent and supported connection.

Note: This process requires an admin of Microsoft Teams and an admin of UserVoice to fully implement UserVoice for MS Teams.

Transitioning an Existing Setup

Important: Webhook URLs are unique to each channel. If you have UserVoice connected to multiple Teams channels, you must repeat these steps to generate a unique Workflow URL for every channel individually.

  1. Create a new Workflow-based webhook following the official Microsoft instructions.

  2. In the UserVoice Admin Console, navigate to Settings → Integrations → Microsoft Teams.

  3. Edit your existing integration by finding the specific channel and clicking the pencil icon.

  4. Update the webhook URL by deleting the old link and pasting the new Workflow URL into the Incoming Webhook URL field.

  5. Save your changes to finalize the transition and resume your notification stream.

New Setup

  1. In Microsoft Teams, use the Workflows app to create a new incoming webhook for the Channel you wish to implement the Teams Integration. Click here for the step-by-step instructions.
  2. Once you have created the incoming webhook, you will see a URL to copy. Copy this URL to share with the UserVoice Admin.
    Screenshot shows the unique webhook URL.
  3. Inside UserVoice, the UserVoice Admin will navigate to Integrations -> Microsoft Teams, and click the "Create" button.
     
  4. Paste the previously created webhook URL into "Incoming Webhook URL". 
    Screenshot 2025-05-13 at 7.11.02 PM.png
  5. Insert the Channel Name and Team Name.
     
  6. Select the Forums/Categories via the drop down menu, and Events you want to have streamed into the Channel you selected previously. 
     
  7. Repeat these steps for each channel implemented with the UserVoice's Team Integration as these URLs are all unique.

You’re done! The events you selected in UserVoice will now be streamed directly into your selected MS Teams channels!

Removing a Configuration

To remove your connection or configuration entirely:

  1. Open the configuration in Teams via your configured apps and select the one you want to remove.

  2. Make sure you are signed in to UserVoice to ensure the configuration is removed from both Teams and UserVoice simultaneously.

  3. Click Remove to delete the integration.

  4. Confirm removal in UserVoice if you were not signed in during Step 2 by navigating to Settings → Integrations → Microsoft Teams and clicking the trash can icon.

 

Related articles