Install Live Chat on your website

Create a Chat App, allow your website, copy the installer, and verify that the Protodesk launcher appears correctly.

Updated

Live Chat lets website visitors contact your team without leaving your site. Messages from the widget appear in Threads alongside conversations from your other connected channels.

Enable Live Chat

  1. Open Settings.
  2. Select Live Chat.
  3. Select Enable Live Chat if no website Chat App exists yet.
  4. Confirm that the Website chat widget is enabled.
  5. Choose whether anonymous visitors may start conversations.

Allow your website

In Allowed websites, enter one exact HTTPS origin per line, for example:

https://www.example.com
https://app.example.com

Do not include a path such as /support, and do not use wildcards. Add every production origin that will load the widget. Use local or preview origins only in an appropriate test Chat App.

Install the script

Under Install on your website, select Copy. Paste the generated script before the closing </body> tag on each page where the launcher should appear.

A minimal installer has this shape:

<script
  defer
  src="https://chat.protodesk.io/widget.js"
  data-protodesk-app-id="<YOUR_PUBLIC_CHAT_APP_ID>"
></script>

Use the generated code from Protodesk rather than manually copying an ID. It can also include your selected colour and theme.

Verify the installation

  1. Save and deploy your website change.
  2. Open the site from an allowed HTTPS origin.
  3. Confirm that the launcher appears in the chosen corner.
  4. Start a test conversation.
  5. Verify that the message arrives in Threads and that a reply returns to the widget.

If the launcher does not appear, confirm that the Chat App is enabled, the exact website origin is allowed, and no content-security policy blocks https://chat.protodesk.io.

Related articles