Chat Widget
Customise your website chat widget's look, launcher, contact form and proactive pop-up messages. Add allowed domains, get your embed code and track results.
Chat Widget controls how the chat bubble looks and behaves on your website, who is allowed to show it, and how to add it to your pages.
Find it in the left menu under Settings > Chat Widget. It has two tabs: Configuration (everything below) and Tracking.
Click Save Widget Configuration at the bottom of the Configuration tab when you're done. You'll be warned if you try to leave with unsaved changes. To preview changes safely, use Widget Playground.
Look and feel
| Setting | What it does |
|---|---|
| Launcher Style | Floating circle (a round button in the corner), Bottom-right bar (a wide bar attached to the bottom right) or Centre-left bar (a vertical bar in the middle of the left edge). |
| Launcher Content | Icon only, Text only or Icon + text. |
| Launcher Text | The label on the launcher when text is shown, for example "Chat with us". |
| Theme | Light or Dark chat window. |
| Position | Bottom Right, Bottom Left, Top Right or Top Left. |
| Widget Color | The main colour for the button, highlights and active states. Use the picker or type a hex code such as #3B82F6. |
| Header Font Colour | Colour of the company name in the open chat header. Choose a dark colour if your widget colour is light. |
Greeting, pictures and branding
- Greeting Message: the first thing visitors see when the chat opens. Keep it friendly.
- Avatar URL (optional): a picture for your AI assistant. Square images around 200 by 200 pixels work best. The address must be publicly reachable.
- Header Icon URL (optional): a small square icon that replaces the default chat icon in the header.
- Header Wordmark URL (optional): a wide logo image that replaces your company name text in the header.
Your company name and brand colour also come from Branding.
Hide "Powered by"
Tick Hide "Powered by" disclaimer to remove the small Autoch.at line at the bottom of the widget. This needs the White Label add-on. Without it the box is greyed out and says "White Label add-on required to hide the disclaimer." If it's available for purchase, a Purchase White Label button appears next to it.
We recommend telling visitors somewhere on your site that they may be talking to AI. You are responsible for any disclosure rules that apply where you operate.
What visitors must share first
Contact information decides what a visitor must enter before they can send their first message:
- Name only
- Name and email
- Name and phone number
- Name, email, and phone number
A name is always collected. Asking for an email or phone helps you follow up later, but each extra field may put some visitors off.
Returning visitors
Conversation reuse window (hours) sets how long a returning visitor continues the same conversation. The default is 24. Enter 1 to 168 hours since their last message, or 0 to keep reusing the conversation until the system closes it after it goes quiet.
Proactive messaging
A proactive message is a small bubble above the chat button that invites visitors to chat. Clicking it opens the chat with that text as the assistant's first message.
Turn it on
Tick Enable proactive messaging. If it's greyed out, the feature isn't switched on for your account yet. Contact support.
Write the message
Enter the Message Template, for example "Hi! How can we help you today?"
Pick how noticeable it is
Under Visibility level choose Subtle (small, gentle fade, good for content pages), Standard (balanced, with a notification dot) or Bold (large, bouncing, pulsing launcher, good for pricing or checkout pages). A preview shows the result. Open Advanced visibility to fine-tune Bubble size, Entrance animation, Launcher emphasis, Accent style and Repeat attention pulse until dismissed. Changing the level resets those fine-tuned choices.
Choose when it appears
Under Trigger Conditions tick any that suit you:
- Time delay (seconds): after the visitor has been on the page for this long.
- Scroll percentage: after they scroll this far down.
- Idle time (seconds): after they stop interacting for this long.
- Exit intent: when the mouse heads toward the top of the page, as if leaving.
Optionally react to clicks and hovers
Click Add Custom Event, choose Hover, Click or Focus, and enter the CSS selector of the element, for example #pricing-button or .cta-link. Ask your web developer if you need help finding the selector.
Limit repeats
Show only once per session is ticked by default so visitors aren't pestered. Untick it only if you want the bubble to appear again.
Allowed domains
The widget only loads on websites you approve.
Add your website
Type your domain, for example example.com, choose the Workspace it belongs to, and click Add Domain.
Add every address you use
Add each site or subdomain separately, for example both example.com and shop.example.com, to be safe.
Each domain shows as Active. Use the dropdown to move it to another workspace, or Remove to stop it working.
Add the widget to your website
Generate a token
Click Generate token, then Copy token if you need it.
Copy the snippet
Under Embed snippet, click Copy snippet.
Paste it into your site
Paste the code just before the closing </body> tag on every page where the chat should appear. If you use WordPress, Shopify, Wix or similar, look for a "custom code" or "footer scripts" area, or send the snippet to your web developer.
If the widget ever stops appearing, check that the page's domain is in Allowed Domains, then generate a fresh token and snippet.
Tracking tab
Use Tracking to send chat outcomes, such as a qualified lead, to your own website analytics. It only covers the embedded chat widget, not SMS, email or voice.
- Tracking Configuration: switch on Enable Chat Widget Tracking, choose a PII mode (how much personal detail may be included), and set Event Mappings. Click Add standard mappings for the usual ones. You need at least one enabled mapping before outcomes such as Lead Qualified appear.
- Widget Tracking Health: shows recent events and failures for the Last 1 hour, Last 24 hours or Last 7 days, split By Event Type.
- Tracking Code Templates: ready-made snippets for your web developer to paste where your analytics scripts run. Autoch.at doesn't run this code inside the widget.