Enabling this integration requires Admin permissions in Hotjar and create connector permissions in Microsoft Teams
See your Hotjar Team page to check who in your team has the required Admin or Account Owner permission levels to enable this integration.
The initial setup also requires Microsoft Teams create connector permissions. You can adjust this in Microsoft Teams under Settings > Member permissions > Allow members to create, update, and remove connectors.
The Hotjar Microsoft (MS) Teams integration enables you to forward Survey and Feedback responses to one or more channels in your MS Teams workspace, including Private and Public channels. This article provides common use cases and steps through how to enable the MS Teams integration.
- Common use cases for the MS Teams integration
- Enabling the MS Teams integration
- Enable the Microsoft Teams integration on a Recordings Segment
Common use cases for the MS Teams integration in Hotjar
The following are some example use cases for the MS Teams integration:
- Follow ongoing product feedback specific to a team, delivered directly to an MS Teams channel.
- Identify the early signs of an incident through real-time user feedback.
- Monitor and discuss user responses to understand the impact of recent product changes and find improvement opportunities.
Enabling the MS Teams Integration
The MS Teams integration is not available on the Microsoft Marketplace and needs to be configured in Hotjar
The Hotjar MS Teams integration relies on MS Teams Webhooks, meaning it needs to be configured from within Hotjar. It's not possible to entirely configure the MS Teams integration from within MS Teams and this integration is also not available on the Microsoft Marketplace.
The Hotjar MS Teams integration uses a Webhook URL generated for a specific channel inside MS Teams. After generating the Webhook URL, you'll need to paste this in the edit view for a Hotjar Survey or Feedback widget to start forwarding responses.
Generating a Webhook URL in MS Teams
From your MS Teams workspace, select Connectors from the channel menu where you'd like to receive responses.
From the connectors list, find Incoming Webhook and click Add.
Click Add again to confirm you want to add the Incoming Webhook to the channel.
Reopen Connectors from the channel menu, and click Configure next to the Incoming Webhook connector.
Enter a name for the Webhook, and click Create.
Click the copy icon to copy the generated Webhook URL, then click Done.
You're now ready to forward Hotjar Survey and Feedback responses by following the next section on Setting up forwarding of Survey and Feedback responses.
Setting up forwarding of Survey and Feedback responses
Inside Hotjar, create a new Survey or Feedback widget, or edit an existing one.
You can edit an existing Survey or Feedback widget by clicking on the vertical ellipsis menu next to a specific Survey or from within a Feedback widget and then clicking Edit.
In the Survey or Feedback edit view, click on the Forward Feedback section.
Turn on Receive feedback responses in Microsoft Teams.
If it's not already enabled inside Hotjar, click Connect Microsoft Teams.
The MS Teams integration can be enabled while editing a Survey or Feedback widget or from your Integrations page. If you've enabled MS Teams from your Integrations page, you'll still need to set up forwarding feedback in a specific Survey or Feedback widget to send responses to MS Teams.
Paste the Webhook URL generated in MS Teams in the Webhook URL field.
A Webhook URL is required to use the MS Teams integration and can be generated from inside MS Teams. For details on generating this Webhook URL, see the section above on Generating a Webhook URL in MS Teams.
You can add more than one MS Teams channel where you'd like responses from the specific Survey or Feedback widget to be forwarded.
Click Confirm.
Send a test message from Hotjar to check the connection to MS Teams is working correctly
In the Forward Feedback section of your Survey or Feedback widget, click on Send test message. This will send a test message from Hotjar to the MS Teams channel to check the connection.
With Surveys, you can choose which responses you'd like forwarded to MS Teams by selecting the relevant survey question. This option isn't available with Feedback widgets.
Make sure the status is set to Active, then click Save changes for your Survey or Feedback widget.
Enable the Microsoft Teams integration on a Recordings Segment
The Microsoft Teams integration allows you to push Recordings to Microsoft Teams based on Recording Segments. This can be enabled on existing Recording Segments, or if you want to create a new Segment, follow these steps:
Enable the Microsoft Teams integration on a new Recordings Segment
Go to your Recordings dashboard.
Add Recording Filters
Add Recording Filters to determine which kinds of sessions you want to push to Microsoft Teams. Once the desired filters have been applied, you can save this group of filters as a Recording Segment.
Click the Save as Segment button.
Name your Segment and enable the Microsoft Teams integration.
Toggle the Microsoft Teams switch to enable the integration. Paste the Webhook URL and click Confirm.
Click Send test message to verify the integration and click Save segment.
Enable the Microsoft Teams integration on an existing Recordings Segment
Go to Recordings.
Select a Segment.
Click the three-dot menu next to the Segment name and click Microsoft Teams to forward recordings to Microsoft Teams.
Toggle the Microsoft Teams switch to enable the integration and add the Webhook URL.