Use Web Widget Deployment When You Need To
- add an always-available assistant to your website
- support visitors with voice, chat, or both
- launch different widget experiences for different pages
- let marketing or operations teams manage the website experience without rebuilding the agent
Create Your Widget
Create a new widget
Click Create Widget and provide:
- Widget name - Internal label for your reference
- Agent - Select which agent powers this widget
Configure the widget
Use the visual editor tabs to configure Setup, Appearance, Content, Features, Actions, Privacy, Export, and Share. The editor includes a live preview that updates as you make changes. See the Widget Configuration guide for full details on each editor tab.
Get Your Embed Code
Once your widget is configured, copy the embed script from the Export tab. The Export tab includes:- Embed script - Your unique loader URL to copy and paste
- Platform guides - Step-by-step instructions for Google Tag Manager, WordPress, Webflow, Shopify, and Squarespace
Deploy Your Widget
Test in the preview
Use the live preview on the right side of the editor to test your widget before deploying. Click the refresh icon if needed.
Add to your website
Paste the script just before the closing
</body> tag on your website, or ask your web developer to add it.Configuration changes you make in the dashboard automatically apply to your embedded widget. No need to update the embed script. If changes don’t appear immediately, do a hard refresh (Ctrl+Shift+R or Cmd+Shift+R).
Deployment Notes
- HTTPS required for microphone access (except localhost)
- Mobile responsive - The widget automatically adapts to mobile screens
- Create separate widgets for different sites or branding needs
Troubleshooting
Widget not appearing
Widget not appearing
- Ask whoever manages your site to check for website script errors if needed
- Verify allowed domains include your site
- Ensure script is placed before
</body>tag - Check Content Security Policy settings
Microphone access denied
Microphone access denied
- HTTPS required (except localhost)
- Visitors must grant permission manually
- Check browser microphone settings
- Some browsers block on first visit
No audio or poor quality
No audio or poor quality
- Audio issues may be caused by network restrictions. Try from a different network, or ask your IT team to allow voice connections.
- Corporate VPNs may block audio
- Test from a different network or browser
- If it works elsewhere, the issue is usually a local network or device policy
Changes not updating
Changes not updating
- Save from the Unsaved changes bar in the editor
- Hard refresh your site (Ctrl+Shift+R or Cmd+Shift+R)
- Clear browser cache if needed
- Verify you’re editing the correct widget
Next Steps
Widget Configuration
Full guide to the widget editor: appearance, content, features, actions, and privacy
Web Widget Implementation
Deploy widgets cleanly across environments with the right domain and privacy setup
Trust Center
Manage account-wide data privacy and compliance
Production Checklist
Learn how to maintain and scale your widget deployment