# 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

<!-- omitted: ParamsTable -->

## Common patterns

**Email campaign tracking:**

```text
https://livelayer.app/a/sales-assistant?ref=email-2026-q2-promo&greeting=Hi%2C%20welcome%20back
```

The conversation is tagged with `ref=email-2026-q2-promo` so you can filter analytics by source.

**QR code on a flyer:**

```text
https://livelayer.app/a/booth-agent?mode=fullscreen&autoplay=true
```

QR scanned on phone → fullscreen agent + autoplay → instant conversation.

**Personalized link:**

```text
https://livelayer.app/a/sales-assistant?visitor=vis_abc123&greeting=Welcome%20back%2C%20Jordan
```

The visitor's CRM ID is threaded through; the agent says "Welcome back, Jordan" on connect.

## 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.