Installation
Add the widget script, verify public configuration, and confirm the storefront can enter the queue.
Installation has two parts: loading the widget script and confirming the app can return public widget configuration for the tenant.
Add the widget script
Add the script near the end of the storefront body.
<script src="https://video-shopping-saas.magic.brightcodecanvas.in/widget.js" async></script>If the storefront uses a tag manager, publish the tag only on pages where live shopping should be available.
Confirm the public config
Open the widget page in a clean browser session and confirm:
- The widget loads without console errors.
- The tenant and website are recognized.
- Available agents or callback fallback state is shown.
- Queue join creates a request only once per customer session.
Expected result
The customer can open the widget, enter details, and either join a live queue or create a callback request. If no agents are available, the fallback state should explain the next step instead of failing silently.
Troubleshooting
| Symptom | Check |
|---|---|
| Widget does not appear | Confirm the script URL is reachable and not blocked by CSP. |
| Widget opens but config fails | Check tenant ID, website assignment, and /api/public/widget/... response. |
| Queue join fails | Check customer form validation and public queue API logs. |
| Agent never sees request | Check agent online status, website assignment, and realtime connection. |