This guide explains how to add a HelpScout chat widget to your Discourse site, allowing users to initiate one-on-one chats with your team.
Required user level: Administrator
Summary
This guide will walk you through the process of integrating a HelpScout chat widget into your Discourse site. This integration enables your users to start direct conversations with your team, enhancing user support and engagement.
Setting up HelpScout
- Create an account at https://www.helpscout.com/
- Complete the steps to set up your account and mailbox
- Click on
Set Up Beacon
- Configure your Beacon settings
- Copy the provided scripts using the
Copy
button
Adding the HelpScout widget to Discourse
- Navigate to your Discourse admin panel:
admin
>customize
>themes
>components
- Click on
Install
- Select
+Create new
- Enter a name for the component (e.g., “HelpScout Chat Widget”), ensure the Type is set to “Component”, and click
Create
- Select the theme(s) where you want to add the new component to activate it
- Click on
Edit CSS/HTML
- Go to the
common
>/head
tab - Paste the HelpScout script you copied earlier
- Click
Save
Configuring Discourse site settings
- In your Discourse site settings, search for “content security policy script src”
- Add the following URL to the allowlist:
https://beacon-v2.helpscout.net/
Verifying the integration
- Return to your Discourse homepage
- You should now see the chat icon in the bottom right corner, visible to both visitors and registered users
- If you don’t see the icon, perform a hard refresh of the site
Using the HelpScout chat widget
Once integrated, your users can initiate one-on-one chats with your team:
You can access and respond to received messages from the HelpScout dashboard and mailbox.
Last edited by @jessii 2024-08-05T18:55:30Z
Check document
Perform check on document: