Install our conversational widget on your website to provide community-driven help to your customers, right where they need it. The conversational widget floats above the page, and can be activated by clicking a trigger. It’s quick and easy to install - you just need to enter basic information about your website in Control, then add your unique embed code to your webpages. Follow the steps below to install and activate the conversational widget.
How To Install The Conversational Widget On Your Website
- Go to Control → Integrations → EMBEDDABLE WIDGET Installation.
- Press Copy code to copy your unique embed code to your clipboard.
- Paste this code just before the closing body tag on all pages of your website where you want to display the widget.
- Go to Control → Integrations → EMBEDDABLE WIDGET Setup.
- Add the domains of the websites you want to install the widgets on under Trusted domains, and press Save changes.
- The widget will immediately become active on your website.
Here's a few ways you can add the embed code to your webpages (step 3):
- Email the embed code to your favourite web developer, along with the above instructions, and work with them to install it on the pages you want.
- Use your CMS (Content Management System) to directly add the code to the pages you want.
- Use Google Tag Manager to add the embed code with a Custom HTML tag.
The embeddable widgets will only execute on domains you’ve added to ‘Your Trusted Domains’ (i.e. whitelisted domains). If you don’t add any trusted domains, then the widgets won’t be allowed to load anywhere.
Before you enable the widgets on your website, remember to customize the look and feel of the conversational widget to match your brand, and set up configuration to optimise the search results of the widgets.
The embeddable widgets only display if content is found for the current page (to avoid your users seeing a blank widget). If no automatic topic suggestions are found for a page that you want to display the widgets on, use our content configuration tool to pin some topics in the widget for that URL.
If you’re using a Content Security Policy (CSP) on your website, you may need to whitelist the source URLs used by the widgets in order to get them working. Signs that your CSP is interfering with the widgets include: the widgets don't display on the page after following the steps above, or the widgets appear, but no search results display.
Click to see the base URLs of the sources used by the widgets:
- https://embeddable-widgets.insided.com- the endpoint used to retrieve the widgets themselves.
- https://conversational-eu-west-1.api.insided.com - the search endpoint used by the widgets if your community is hosted in the EU.
- https://conversational-us-west-2.api.insided.com - the search endpoint used by the widgets if your community is hosted in the US.