Questions? We are here to help!

Install a Live Chat widget on your website

Add the HEDESU Live Chat widget to your website so visitors can start a conversation with your team.

Before you begin

Use the Admin role in the space that will receive the conversations. You also need access to edit your website’s HTML or its custom-code settings. Live Chat must be available on your workspace’s plan.

Connect Live Chat

  1. Open the intended space, go to its settings and select Channels.
  2. Select Connect channel, then Connect on the Live Chat card.
  3. Enter a Channel name of up to 30 characters.
  4. Under Allowed domains, enter each website hostname on a separate line, such as example.com and www.example.com. Use hostnames without a page path. A wildcard such as *.example.com allows its subdomains; add example.com separately for the main domain. Leaving the field empty allows all domains.
  5. Review the widget’s basic appearance. You can keep the other settings at their defaults for an initial installation.
  6. Select Connect Live Chat.
  7. Open the new channel’s menu in Channels and select Edit to reach Manage Live Chat. Confirm that the channel is Active.

If the channel already exists, open its Edit page instead of creating another one. Save any changes to Allowed domains with Save changes.

Install the code

  1. In Manage Live Chat, find Install on your website.
  2. Copy the complete Website embed code.
  3. Add it before the closing </body> tag on the pages where the widget should appear. If your website uses a shared layout or custom-code area, use the location that inserts code at the end of the page body.
  4. Save and publish the website change, then reload a page that contains the code.
  5. Open the chat launcher and check that the expected header and welcome message appear.

The Widget connection key is already included in the code. It identifies the channel and is not a password.

Check the first conversation

Use a controlled test visitor on your own website. If CAPTCHA is enabled, complete verification first. Then complete any visitor details the widget requests and send a clearly identified test message. In HEDESU, open Chats, select the intended space and Live Chat channel, and confirm that the message arrives in the expected conversation. See Handle Live Chat conversations in Chats for the staff workflow.

CAPTCHA is optional. To connect your own Cloudflare Turnstile keys, follow Configure Live Chat visitor details and limits. You do not need to replace the embed code when enabling CAPTCHA.

If the widget does not work

  • Check that the complete current embed code is present in the published page, then reload it.
  • If verification cannot load or expires, select Retry verification. If it keeps failing, ask your website administrator to check the Turnstile keys, registered website hostnames and website script restrictions. Sending remains blocked while enabled verification is incomplete.
  • Check the channel’s status and any plan restriction shown in HEDESU.
  • Compare the website hostname with Allowed domains, including any www or other subdomain.
  • If your website blocks the widget script, ask the person managing the website to inspect its script-loading restrictions and use the code supplied by HEDESU.

Use Generate new key only when replacing the installation. The change takes effect after saving the channel; existing installations then need the updated embed code. It is not a routine troubleshooting step.