URL customization
The hosted page reads query parameters to override agent behavior on a per-link basis. Useful for campaigns, A/B tests, or context-specific entry points.
text
https://livelayer.app/a/your-agent-slug?mode=widget&greeting=Welcome%20Acme
Supported parameters
| Name | Type | Description |
|---|---|---|
| mode | "widget" | "embedded" | "fullscreen" | Override the experience mode set in the dashboard. widget = floating bubble; embedded = inline; fullscreen = takeover. |
| greeting | string | URL-encoded custom greeting the agent says on connect, overriding the configured one. |
| theme | "light" | "dark" | Force light or dark theme regardless of system preference. |
| ref | string | Free-form referrer tag stored on the conversation. E.g. ?ref=email-campaign-2026-q2. |
| visitor | string | Pass a known visitor ID from your CRM. The agent will resolve to that visitor's history if it exists. |
| autoplay | boolean | When true, auto-starts the conversation. Subject to browser autoplay policies — may require visitor click on iOS. |
Common patterns
Security note
Query parameters are visible in URLs, browser history, and server logs. Never put sensitive data (auth tokens, secrets, email addresses) in query params. For visitor identification, use opaque IDs that map to your CRM server-side.