Add a chat to your website

Create a website chat widget, add one line of code to your site and answer visitors from the inbox in real time.

For owners and admins

On this page
  1. 1. Create the widget
  2. 2. Add it to your website
  3. Allowed websites
  4. 3. Make it yours
  5. Before the chat starts
  6. Away message
  7. Extras
  8. Typing indicators
  9. Proactive messages
  10. Replies by email
  11. Identity verification (optional)
  12. Turn off or delete
  13. Troubleshooting

Website chat puts a chat button on your website. Visitors' messages land in the inbox with your other channels, and your team or an AI Employee answers in real time. There's no platform approval and no 24-hour reply window.

You need permission to manage connected accounts (workspace owners and managers have it). Each widget counts as one connected channel on your plan.

1. Create the widget

  1. Open Connect a channel and click Set up on the Website chat tile. You can also go to Workspace settings → Website Chat and click Create a website chat (or New website chat).
  2. Fill in:
    • Channel name: shown in the inbox, for example "Main website".
    • Your website: where the chat will appear, one address per line, for example https://www.example.com.
  3. Click Create website chat.

If Website Chat isn't in your workspace settings, your Luminobot administrator hasn't turned it on yet.

2. Add it to your website

The widget's page opens with Add it to your website. Click Copy code and paste the snippet just before </body> on every page that should show the chat, or add it with Google Tag Manager. It looks like this:

<script src="…/webchat/widget.js" data-key="wc_…" async></script>

Always copy your own snippet: the data-key is unique to the widget.

If your website sends a Content-Security-Policy, allow the address shown on the page in script-src, connect-src and img-src.

Allowed websites

The chat only appears on the websites listed under Websites allowed to show the chat. On any other site it stays hidden.

  • Enter one address per line, for example https://www.example.com. You can add up to 20.
  • https://*.example.com covers every subdomain, such as www.example.com and shop.example.com. It doesn't cover example.com itself, so add that line too if your site uses it.
  • example.com and www.example.com are different addresses. List each one your visitors use.

3. Make it yours

Under Look and greeting, set the Header title, Header subtitle, Greeting, Colour and Button position (Bottom right or Bottom left). The Live preview on the right updates as you type. Messages you send from the preview are real and appear in your inbox.

Click Save changes. Changes reach your website within a minute.

Before the chat starts

Under Before the chat starts, choose Ask for name and Ask for email: Don't ask, Optional or Required.

  • Required fields show a short form before the visitor can chat.
  • An optional email is asked for after the visitor's first message.
  • Consent notice adds a line such as "By chatting you agree to our privacy policy."

Away message

Tick Show the away message outside business hours to show a notice while you're closed. Leave Away message empty to use "We're away right now and will reply {next_open}.", or write your own; {next_open} is replaced with when you open next.

The hours come from your workspace's Business hours (linked from this section). Without business hours, the chat always shows as open. To also send an automatic away reply to each message while you're closed, turn on the away reply for this chat on the Business hours page.

Extras

  • Visitors can send images and files: lets visitors attach pictures (JPEG, PNG, WebP or GIF) and documents (PDF, Word .docx, Excel .xlsx, .txt or .csv, up to 10 MB). Web pages, SVG files, archives and programs are refused.
  • Visitors can email themselves the conversation: lets visitors send themselves a copy of the chat by email.
  • Email replies to visitors who left the page: see Replies by email.

You can also send files from the inbox: attach an image or a PDF, Word, Excel, .txt or .csv file to your reply. Documents show up in the chat as a download link with the file's name.

Typing indicators

While a visitor types, the conversation in the inbox shows "name is typing…" above the reply box. While you type a reply, the visitor sees three dots in the chat. Typing in the private note box is never shown to the visitor, and what anyone types is never sent before they press Send.

Proactive messages

A proactive message opens the chat with a greeting after a visitor has spent some time on a page. Use it to offer help on pages where people often have questions, such as pricing or checkout.

  1. On the widget's page, open Proactive messages and click Add a proactive message.
  2. Fill in:
    • Name: only your team sees it, for example "Pricing page".
    • Greeting: what the visitor sees, up to 500 characters.
    • Show after (seconds on the page): from 0 to 600.
    • Only on pages matching: leave empty for every page, or enter a path such as /pricing. A * matches anything, so /blog/* covers every blog post. You can paste a full address; only its path is used.
  3. Click Add message. You can add up to 10, and turn each one off or back on.

How visitors see them:

  • The first message whose page matches is used. Each visitor sees each message at most once a day, and not while they are already chatting.
  • Visitors can click Don't show again to stop proactive messages in their browser.
  • On phones, and for visitors who asked their device for reduced motion, the chat doesn't pop open: the chat button shows a badge instead.
  • Nothing reaches your inbox until the visitor replies. Then the conversation starts with your greeting, marked "Automatic greeting on the website", followed by their reply.

Replies by email

When a visitor who gave their email leaves the page, they don't see your answer. With Email replies to visitors who left the page on, your reply is emailed to them when their chat has been closed for a few minutes, with a link back to the page they were on.

  • Replies sent within about a minute of each other go in one email, and a conversation gets at most one email an hour.
  • Only replies from your team or an AI Employee are emailed, not away messages, satisfaction surveys or automations.
  • Every email has an unsubscribe link. Visitors who unsubscribe, or contacts who opted out of email, get no more of these emails.

Identity verification (optional)

Anyone can type any email address into the chat, so a typed email never joins the chat to an existing contact. If your website knows who is signed in, it can pass their email with a signature. A verified email joins the chat to the contact with that email.

  1. Open Identity verification (optional) and copy the secret. Keep it on your server only, never in the browser.
  2. On your server, compute the signature: the hex HMAC-SHA256 of the lower-cased email, using the secret as the key.
  3. Add data-email, data-name and data-signature to the snippet:
<script src="…/webchat/widget.js" data-key="wc_…"
  data-email="jane@example.com" data-name="Jane" data-signature="<signature>" async></script>

In Python:

import hashlib, hmac


def chat_signature(secret: str, email: str) -> str:
    return hmac.new(secret.encode(), email.strip().lower().encode(), hashlib.sha256).hexdigest()

In Node.js:

const crypto = require("crypto");
const signature = crypto.createHmac("sha256", secret).update(email.trim().toLowerCase()).digest("hex");

Create a new secret replaces the secret. The old one stops working at once, so update your website straight away.

Turn off or delete

  • Turn off hides the chat on your website and keeps all conversations. A widget that is off doesn't count toward your plan. Turn on brings it back.
  • Delete this website chat removes the widget and all of its conversations from the inbox. Type the channel name to confirm. To keep the conversations, turn the chat off instead.

Troubleshooting

The chat doesn't appear on my site. Check that the widget is On, that the page's exact address (with https:// and www. if used) is in the allowed websites, and that the snippet is on that page. If your site has a Content-Security-Policy, allow the address shown under Add it to your website.

"These aren't website addresses: …" Enter full addresses such as https://www.example.com.

"You've reached your plan's limit…" Each widget uses one account slot. Disconnect an account you no longer use, turn off another widget, or upgrade your plan.

Chats aren't linked to my existing contacts. Only verified emails are matched. Set up identity verification.