🧪 AI Assistant Widget - Bypass Parameters Test
Test Purpose: This page demonstrates the bypass parameters feature that allows skipping the guest registration modal.
The widget can automatically generate guest credentials when bypassName=true is set in the URL.
The bypass parameters feature is useful for scenarios where you want to provide instant access to the chat widget
without requiring users to enter their name and email. This is particularly helpful for:
- Quick demos and testing
- Anonymous support channels
- Embedded widgets in authenticated applications
- Kiosk or public display scenarios
Available Bypass Parameters
bypassName=true - Automatically generates a guest name (e.g., "Guest 1234")bypassEmail=true - Skips email collection (currently not used separately)userName=John - Pre-fills the name field (still shows modal)userEmail=john@example.com - Pre-fills the email field (still shows modal)
Test Case 1: Normal Flow (No Bypass)
Standard widget initialization - user must enter name and optional email
widget.html?assistantId=689af21ee1b7c40d053d014d&assistantName=Tommy.AI&theme=light
Normal Flow
Test Case 2: Bypass Name (Auto Guest)
Widget automatically generates a guest name and skips the registration modal
widget.html?assistantId=689af21ee1b7c40d053d014d&assistantName=Tommy.AI&theme=light&bypassName=true
Auto Guest Mode
Test Case 3: Pre-filled Name (Shows Modal)
Name is pre-filled but user can still modify it before continuing
widget.html?assistantId=689af21ee1b7c40d053d014d&assistantName=Tommy.AI&theme=light&userName=TestUser
Pre-filled Name
Test Case 4: Dark Theme with Bypass
Demonstrates bypass functionality works with different themes
widget.html?assistantId=689af21ee1b7c40d053d014d&assistantName=Tommy.AI&theme=dark&bypassName=true
Dark Theme + Auto Guest
Implementation Notes
When bypassName=true is set, the widget:
- Automatically generates a random guest name (e.g., "Guest 5478")
- Creates a guest session with this auto-generated name
- Immediately connects to the chat without showing the registration modal
- Stores the session for future visits (standard behavior)
Production Usage Example
https://widget.tommytalk.ai/widget.html?assistantId=YOUR_ASSISTANT_ID&assistantName=Your+Assistant&theme=light&bypassName=true
Security Note: The bypass feature is ideal for public-facing widgets where anonymous access is desired.
For scenarios requiring user identification, use the pre-fill parameters (userName and userEmail)
instead to maintain user accountability while streamlining the registration process.