Skip to main content
The Chat Widget is a real-time web chat tool that lets website visitors start a conversation with your team instantly. All messages flow into the HoopAI Platform Conversations tab, so your team can respond from one place without jumping between tools.

How the chat widget works

  1. You create and configure a chat widget in Sites > Chat Widget.
  2. You embed the widget on your website, funnel pages, or client portal.
  3. When a visitor sends a message, a conversation thread is created in Conversations, tagged as a Live Chat.
  4. Your team responds from the Conversations tab. The visitor sees the reply in real time on the website.
  5. If no agent is available, the widget can collect the visitor’s contact info for follow-up.

Creating a chat widget

1

Navigate to Sites > Chat Widget

Click Sites in the left sidebar, then select Chat Widget. Click + New Chat Widget.
2

Configure general settings

Set:
  • Widget name — internal label for the widget
  • Welcome message — the greeting text shown to visitors when they open the chat
  • Away message — shown when no agents are online
  • Agent display name and avatar — what the visitor sees as the sender
3

Customize appearance

  • Position — bottom-right or bottom-left corner of the page
  • Bubble color — the color of the chat button bubble
  • Bubble icon — choose from preset icons or upload a custom one
  • Widget header color — the color of the chat window header
4

Set availability hours

Configure the days and times your team is available for live chat. Outside these hours, the away message is shown and the widget can switch to an offline form mode to collect contact info.
5

Configure the pre-chat form (optional)

Show a form before the chat starts to collect the visitor’s name, email, and phone number. This ensures every conversation is tied to a contact record, even if the visitor leaves before an agent responds.
6

Get the embed code

Click Get Code to copy the JavaScript snippet. Paste it into the <head> or before the </body> tag of any external website, or use the Chat Widget element in the HoopAI page builder.

Responding to live chats

All live chat conversations appear in Conversations and can be filtered using the Live Chat quick filter:
  1. Navigate to Conversations.
  2. Click Quick Filters and select Live Chat.
  3. Click any conversation to open it and type a reply.

Manual actions in live chat

From inside a live chat conversation, agents have two additional action buttons:
  • End Live Chat — close the conversation when the issue is resolved
  • Request Contact Details — send the visitor a form to collect their name, email, and phone number mid-conversation

Multiple widgets

You can create multiple widgets for different pages or purposes:
WidgetUse case
Main website widgetGeneral support and inquiries
Pricing page widgetSales-focused conversations
Client portal widgetAccount support for existing clients
Funnel page widgetReal-time lead conversion assistance

Notifications

Ensure your team receives notifications for incoming chats:
  1. Go to Settings > Notifications.
  2. Enable New Conversation notifications for the channels your team monitors (email, browser push, or mobile app push).
The Live Chat widget requires an active internet connection on the visitor’s device. Messages sent when the visitor is offline are queued and delivered when they reconnect.
Add a chat widget to high-intent pages like your pricing page, checkout page, or proposal page. These are where visitors have the most questions and are closest to converting.
Last modified on March 4, 2026