What custom parameters do

Custom parameters let your website send useful context to the assistant when a visitor opens or uses the widget. They can help the assistant understand the page, visitor state, account type, platform, or current product area without asking the visitor to repeat it.

Automatic page context

The widget automatically captures the current page URL, page title, referrer, and path. If the visitor moves to another page during an active chat, the widget updates the conversation context so your team can see where the visitor is now and where each message was sent from.

Add custom context with JavaScript

Place the context object before the widget script when possible:

window.HelpSupportDeskWidgetContext = { loggedIn: true, customerType: 'trade', platform: 'trade_portal', accountStatus: 'existing_trade_customer' };

Add custom context with script attributes

You can also add small values directly to the widget script:

<script src="https://portal.help-support-desk.com/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-context-logged-in="true" data-context-customer-type="trade" data-context-platform="trade_portal" async></script>

What not to send

Do not send passwords, tokens, API keys, payment card details, session cookies, or private commercial notes. The widget filters sensitive-looking names, but the safest setup is to only pass customer-safe labels and statuses.

How operators see it

Conversation review shows the captured visitor page, page title, page path, latest page seen, and custom context values so the team can understand the enquiry before replying.