Docs › Connect channels › Embed the WebChat

Embed the WebChat on your website

The WebChat widget is a branded chat bubble at the bottom right of your website. Visitors message you directly; the messages land in the same inbox as email, WhatsApp & co. Embedding takes 2 minutes and is free on every plan.

⏱ approx. 2–5 min · Permission: settings.manage (admin) · Free & Paid · no external account needed · As of version 1.1.53

Settings → Channels → WebChat card with Try it now, chat link & QR code and “Visitors become contacts”
The “WebChat” card: test it yourself, chat link & QR code, add it with a guide, and “Visitors become contacts”.

Step by step

  1. Open WebChat. Settings → Channels → “WebChat” card. It runs right away, no setup needed (status “Running”). With multiple brands, pick the right brand at the top.
  2. Test it yourself. “Try it now – message yourself” opens the chat; your message lands in the Inbox within seconds, and your reply shows up in the chat window right away.
  3. Copy the embed code. Expand “Add it to your website – with guides for WordPress, Wix & co.”. There you'll find the embed code — a one-line script:
    <script src="https://crm.the-y.at/webchat/<your-company>/widget.js" async></script>
    Click "Copy". <your-company> is your account's address and is already filled in; with several brands the code applies to the brand selected at the top.
  4. Insert it on your website. Add the script on every page where the chat should appear, right before the closing </body> tag. For WordPress, Wix, Jimdo, Shopify and Squarespace the card shows three short steps each (see below).
  5. Test. Reload your website — the chat bubble appears at the bottom right. Click it, send a test message: it shows up immediately in the inbox and you can reply right away.
No build, no restart: switching on/off takes effect immediately. Switch the channel off and the bubble disappears (the script then serves nothing); the chat page then says “Chat not available” — without any company or brand name.

Get the web chat onto your website — even without code

Since 1.1.53 the WebChat card helps you bring the chat to where your customers are:

Customize the look (branding)

The bubble automatically adopts your brand design. Under Settings → Logo & colours (formerly “Design”) you set the accent color, app/brand name and initials per brand — this applies to the bubble, the chat window, the login and the public pages (help portal, booking). On the free plan the chat header shows your company name, with “Powered by The-Y” below (since 1.1.52). Since 1.1.53 the chat page's browser tab shows your company or brand name instead of “The-Y CRM”.

Business hours & auto-reply

Under Settings → Opening hours & holidays one weekly plan applies to all channels; the web chat can get its own hours. Plus an auto-reply within (e.g. "We'll be right with you") and outside (e.g. "We'll get back to you tomorrow"). The auto-reply is sent only on a visitor's first message. On holidays the “outside hours” text goes out. More on opening hours

Chatbot & AI deflection (optional)

Visitors become contacts automatically

Since 1.1.53 everyone who writes in the web chat automatically gets their own contact — with name, email or phone number if they mention them in the chat (e.g. after “leave your email address”). Without details the contact is called “Web chat visitor …”; automatic messages still greet them neutrally. So flows like “Create deal” work from the first message.

Inbox: web chat conversation with the note “Maybe the same person as …”, Merge and Not the same person
In the inbox: “Maybe the same person as …” with “Merge” or “Not the same person”.
Until you merge them there are two contacts with the same address — an email campaign can then arrive twice. So merge matching contacts soon.

Multiple brands

Each brand (workspace) has its own embed code with its own slug and its own branding. That way you run separate chats for multiple websites — all in one instance, one bill.

Troubleshooting

The chat bubble doesn't appear

Check: is the WebChat channel active? Is the script really before </body> and the brand slug correct? Clear the browser/site cache and reload. Open the developer console (F12) and check whether widget.js loads (status 200).

The chat should appear only on certain pages

Insert the script only on the desired pages/templates (not globally). Conversely: for the whole website, put it in the shared footer template.

I see two contacts with the same email address

That's a web chat visitor who mentioned the address of an existing contact. The new contact shows “Maybe the same person as …” — check briefly and click “Merge” or “Not the same person”.

Privacy / cookie notice

The WebChat stores a session identifier in the visitor's browser so the conversation history is preserved. Mention the chat in your privacy policy; treat chat content like any other customer communication.

What's next