Skip to main content

​
Basic setup

Add the following script tag to your website, just before the closing </body> tag: 
<script src="https://YOUR_BOOKSTER_URL/widget.js?customer=YOUR_CUSTOMER_SLUG"></script>
The widget will automatically:
  • Validate that your domain is in the allowed domains list
  • Generate a secure session token
  • Render the chat button in the bottom-right corner of the page

​
Parameters

ParameterRequiredDescription
customerYesYour account slug, found in Settings in the admin dashboard

​
How it works

When the script loads, it:
  1. Checks the current page’s domain against your allowed domains list
  2. If allowed, generates a signed token valid for 24 hours
  3. Creates an iframe containing the chat widget
  4. Renders a floating chat button on your page
The widget runs inside an iframe for security isolation — it cannot access your page’s DOM or cookies, and your page cannot access the widget’s internal state.

​
URL parameters

You can control the widget via URL query parameters on your page: 
https://yoursite.com?chat=open&message=I'd+like+to+book+a+haircut
ParameterDescription
chat=openAutomatically opens the widget when the page loads
message=TEXTSends an initial message to the booking assistant
This is useful for linking directly to the chat from emails, ads, or other pages.

​
Multiple pages

The script is safe to include on every page of your site. The widget maintains its state across page navigations within the same session.