Overview

Live chat lets visitors talk to your team directly from your website. With the SparrowDesk chat widget, conversations show up in your SparrowDesk workspace alongside your other channels, so your team can respond without switching tools.

What you need

You embed a small JavaScript snippet from your SparrowDesk account. The same snippet can be reused on multiple sites or domains if you allowlist each domain (see below).

Get your widget code

1. In SparrowDesk, open Settings → Chat Widget → Installation.
2. Click Copy Code to copy the install snippet.

For step-by-step instructions, screenshots, and troubleshooting, see the Help Center guide: Installing Chat Widget.

Where to place the snippet

Paste the code just before the closing </body> tag on every page where you want the widget. If your site uses a shared layout, header, or footer template, put the snippet there once so it loads on all pages.

Verify installation

After publishing your changes, return to Settings → Chat Widget → Installation in SparrowDesk. The app checks whether the widget loaded; when it succeeds, you will see Widget Installed.

Allowlist trusted domains

To stop others from loading your widget on unrelated sites, restrict it to domains you control:

1. Go to Settings → Chat Widget → Make your Chat Widget Secure.
2. Add full hostnames (for example support.example.com, help.example.com).
3. Use a wildcard for all subdomains: *.example.com.
4. Separate multiple entries with commas.

You do not need https:// or a trailing slash. If you add no domains, the widget can be embedded on any site that has the snippet—SparrowDesk recommends allowlisting for production.

Programmatic control

After the widget script loads, your page can open or close the widget, listen for open/close events, pre-fill fields, and more via window.sparrowDesk. See JavaScript API.