Helpway Docs

Customization

Change brand color, avatar, widget position, and welcome message — all from the dashboard, applied live to every visitor within seconds.

Every visual aspect of the default Helpway widget is controlled from the dashboard, not hard-coded in your app. That means you can tweak colors, upload a new avatar, or reposition the launcher without redeploying — the widget re-fetches its config on every visitor bootstrap.

Where to find it

  1. Open app.helpway.ai
  2. Click AI Agent → Playground in the sidebar
  3. Scroll to the Customize section on the right-hand config pane

What you can customize

Identity

FieldWhat it does
Agent nameShown as the author of every AI-sent message. Default: Better AI.
AvatarA clickable round thumbnail next to every AI message.
Welcome messageThe big greeting visitors see when they open the widget for the first time.
SubtitleExpectations line below the welcome (e.g., "Usually replies in minutes").

Widget behavior

FieldOptions
PositionBottom Right · Bottom Left
Launcher styleIcon · Bubble · Help
Bubble styleRounded · Square · Pill
Show Messages tabToggles the bottom-nav "Messages" entry in the widget footer
Ask for emailRequire a visitor email before starting a conversation

Handoff

When the AI can't help, it escalates. Control who gets assigned:

  • Workspace owner — simplest, always works, best for small teams.
  • Specific members — pick a handful of people. Round-robin if more than one is online.
  • Round-robin (all) — every available teammate gets rotated.
  • Notify all (no assignment) — blast the team, first to claim takes the conversation.

How fast changes propagate

Widget config is edge-cached. After you save in the dashboard:

  • New visitors see the new config on their next bootstrap (< 1 minute worldwide).
  • Existing open widgets keep whatever they booted with — they pick up the new config on the next refresh.

Advanced: custom UIs

If the dashboard knobs don't give you enough control, skip the default widget entirely and build your own UI on top of the headless hooks. Same infrastructure, zero design constraints.