Plan availability
For Observe tools (Heatmaps and Recordings): Available on all Observe plans For Observe tools (Heatmaps and Recordings): Observe , Observe
For Ask tools (Surveys): Ask , Ask
Enabling this integration requires Admin permissions in Hotjar
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 Hotjar Microsoft (MS) Teams integration enables you to forward Survey 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 Survey to start forwarding responses.
Generating a Webhook URL in MS Teams
Important note for existing MS Teams integrations
Formerly, the integration relied on webhooks attached to MS Teams “Connectors“ that are now deprecated by Microsoft. Any existing integration that uses Connectors webhooks has to be migrated to Workflows webhooks as described below.
From your MS Teams workspace, select Workflows from the channel menu where you’d like to receive responses.
From the workflows templates, search for webhook, find and click Post to a channel when a webhook request is received.
Enter a new name for the workflow and click Next.
Details of the workflows are pre-filled and you should not have to edit those. If needed, you can still update the target Channel here. When you’re fine with the details, click Add workflow.
Click the copy icon to copy the generated webhook URL, then click Done.
Specific configuration for private channels
By default, the workflow configured above will send the message as a “Flow bot”. However, a Flow bot cannot publish in a private channel.
If you want to send messages in a private channel, you must update the workflow configuration to send messages on behalf of the user who owns the workflow.
Please follow the steps below to adapt the configuration.
Select Workflows from the channel menu as described above, and click Manage.
Find the workflow that publishes messages to your private channel, open the options and click Edit.
Click on the second step of the workflow called Send each adaptive card to expand the options.
Click and expand Post card in a chat or channel.
Select User in the Post As dropdown, then click Save.
Setting up forwarding of Survey responses
Inside Hotjar, create a new Survey, or edit an existing one.
You can edit an existing Survey by clicking on the vertical ellipsis menu next to a specific Survey and then clicking Edit.
In the Survey edit view, click on the Forward Response section.
Toggle on the option to receive 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 from your Integrations page. If you've enabled MS Teams from your Integrations page, you'll still need to set up forwarding responses in a specific Survey 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 to be forwarded.
Click Confirm.
Send a test message from Hotjar to check the connection to MS Teams is working correctly
In the Forward Response section of your Survey, click on Send test message. This will send a test message from Hotjar to the MS Teams channel to check the connection.
You can choose which responses you'd like forwarded to MS Teams by selecting the relevant survey question.
Make sure the status is set to Active, then click Save changes for your Survey.
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.