Overview
Conversation starters let you:- Reduce blank-page hesitation by showing users what they can ask
- Guide users toward common topics with pre-defined openers
- Customize the initial agent context with an optional system prompt per starter
- Track engagement to see which starters are most popular
How It Works
- You create conversation starters in the admin interface
- Depending on the starter’s settings, it can be triggered three ways (the starter must be Active in every case):
- Via a shareable link (
/?starter=<id>) - Displayed as a clickable card on the home page and widget welcome screen (when Show on home is also enabled)
- Auto-triggered when a widget user opens the widget with no active conversation (when Widget auto-starter is also enabled — one starter only)
- Via a shareable link (
- The initial message is sent to the agent, starting a new conversation
- If the starter has an additional prompt, it is injected as system context for that conversation
Creating a Conversation Starter
- Navigate to Settings > Conversation Starters
- Click Create
- Fill in the starter details:
- Click Save
Managing Starters
Editing
Click any starter in the list to edit its fields. Changes take effect immediately.Showing on the home page
Toggle Show on home on any active starter to display it as a card on the chat home page and the widget welcome screen. The card shows the starter’s description, and clicking it sends the initial message.Setting a widget auto-starter
Toggle Widget auto-starter on a starter to automatically send its initial message when a widget user opens the widget with no active conversation. Only one starter can be the widget auto-starter at a time — setting a new one automatically removes the previous one.Deactivating
Toggle Active off to hide a starter without deleting it. Deactivated starters retain their configuration and engagement data.Deleting
Click Delete on a starter to permanently remove it. This also removes its engagement history.Engagement Metrics
Each conversation starter tracks:- Click count — How many times users have clicked the starter
- Conversations created — How many conversations were started from the starter
Interaction with Other Features
- Suggested Actions: Conversation starters appear on the home page before a conversation begins. Suggested Actions appear during a conversation to guide follow-up responses.
- Home Page: Starters are displayed on the chat home page alongside other home page elements you’ve configured.
- Permissions: When a starter is linked to a specific agent, its home-page card and widget auto-trigger only appear for users who have access to that agent — same access rules as the agent itself (active status, public, or shared permission). If the linked agent is inactive or otherwise inaccessible, the starter is hidden everywhere except its shareable link.
- Shareable links: The
/?starter=<id>link always works for active starters — anyone with the URL can start the conversation, regardless of agent visibility.
