Using Hotjar with Slack

The Hotjar Slack integration allows Slack users to push data from the following Hotjar tools to channels within their Slack workspace:

• Incoming Feedback
• Surveys
• Recordings

Before getting started, be aware of the following requirements:

• The Hotjar Slack integration is only available to Hotjar Business customers. Not on Business? Learn how to upgrade your plan in-app.
• Only an Admin or the Account Owner of your Hotjar account can enable the Slack integration in Hotjar, while in Slack, only your Slack admins can enable it. 
• The Hotjar Tracking Code needs to be installed on your site before Hotjar can collect any data.
• You'll need to have one of the tools mentioned above actively targeting users on your website in order to collect the data that can be pushed to Slack.

The Slack integration can be enabled in your Hotjar site settings, or by enabling it through a new or existing Incoming Feedback widget, Survey, or Recordings Segment. We'll go through each method below. Scroll down or click on the desired option to get started:

• Enable the Slack integration in your Hotjar Site settings
• Enable the Slack integration on an Incoming Feedback widget or Survey
• Enable the Slack integration on a Recordings Segment

Additional resources:

• How to verify the integration was enabled successfully
• Limitations
• Slack OAuth Scopes

Back to top

Back to top

Back to top

Back to top

Back to top

---

How to verify that the Hotjar Slack integration is successfully enabled

To verify that the integration is working properly, we suggest following the steps to create a new Incoming Feedback widget and submit a feedback response yourself.

Create an Incoming Feedback widget. 

On the Forward Feedback Step, toggle the switch to receive feedback responses via Slack.

Select which Slack channel(s) you would like to send your responses to, then click Next.

Set your widget as Active and click Save.

Go to your website and submit a response through the widget you've created.

The Incoming Feedback response will appear in the corresponding Slack channel(s).

Viewing feedback responses in Slack

Once the integration is complete, you’ll see the following data appear in Slack for feedback responses:

• Respondent's email address (if provided)
• Response message text
• URL of the page where the response was submitted
• Emoticon to display rating (Hate Dislike Neutral Like Love)
• Full response button - will link to response within your Hotjar dashboard

Viewing recording sessions in Slack

When pushing recordings to Slack, the following information will be shown:

• Segment name
• Session duration
• Number of pageviews
• Number of actions
• Referrer URL (if available)
• Landed URL
• Exited URL
• U-Turn, Rage Click, Incoming Feedback sentiment, and NPS score (if applicable)

Example of a recording pushed to Slack:

 

Limitations

• Not compatible with Private channels in Slack: At the moment this integration will only be able to push data to public channels in your Slack workspace. If the private channel option is enabled, Hotjar will not be able to push data to those channels. A private channel can be recognized by the lockbox icon next to the channel name.

• Email address used with Slack should match the email address used in Hotjar: In order to view the "Preview" option for Incoming Feedback responses pushed to Slack, you need to be logged into Slack with an email address that also has access to the corresponding Hotjar Organization. If you're using a different email address than what you use to login to Hotjar, you'll see a prompt like this:

"You need to be a member of the Organization for _______ to view insights in Hotjar. Go ahead and nicely ask one of your Admins for Hotjar access"

• Recording segments containing User Attributes will not be sent to Slack: The current Slack integration does not allow Recording segments to be sent if User Attributes are enabled and collected in Recordings. This is a current limitation that our team will consider addressing as we make improvements to the integration.

 

Slack OAuth Scopes

To be able to interact with the Slack API we need to make an OAuth request asking for permission to a set number of scopes. Below are the scopes we request, as well as a summary of why we need it:

Scope	Used For
CHANNELS:READ	Provides access to the channels of a Slack Workspace, so we can provide a useful list of channels to connect to.
CHANNELS:HISTORY	Provides details of when a message is being replied to, allowing us to track usage metrics of the integration.
CHAT:WRITE	Lets us send messages to the Slack channels of a Workspace when we a channel is being connected, or disconnected, as well as notifications of new data that has been subscribed to (Recordings or Responses).
FILES:WRITE	Lets us upload screenshots of Incoming Feedback Responses and attach to the messages.
IM:WRITE	Lets us send messages to admins if a user doesn’t have access to a Hotjar organization.
REACTIONS:READ	Provides details of when a message is being reacted to, allowing us to track usage metrics of the integration.
USERS:READ	Provides access to the users of a workspace, allowing us to match Workspace users with Hotjar admins for message purposes.
USERS:READ.EMAIL	Lets us look up Slack users by the e-mail address they’ve registered in Hotjar.
USERS.PROFILE:READ	Lets us view the Slack user profile so we can match with the Hotjar user.

 

Having trouble?

Be sure that you're meeting all the requirements listed at the top of this article. If you're still having trouble, contact support and we'll be glad to help!

Back to top