Skip to main content
The web widget lets visitors interact with your AI agent through voice, chat, or both at the same time. Configure everything through the visual editor—no coding required—then copy and paste a single embed script.

​
Create Your Widget

Create Widget dialog showing Widget Name field with placeholder text 'Enter widget name', Agent dropdown to select which agent powers the widget, Cancel and Create Widget buttons
Create Widget dialog showing Widget Name field with placeholder text 'Enter widget name', Agent dropdown to select which agent powers the widget, Cancel and Create Widget buttons
1

Open the widget manager

Navigate to Web → Widgets in the dashboard
2

Create a new widget

Click Create Widget and provide:
  • Widget name - Internal label for your reference
  • Agent - Select which agent powers this widget
3

Configure the widget

Use the visual editor tabs to customize your widget (see sections below)
4

Save your changes

Click Save Changes in the bottom-right to persist all updates
5

Get the embed code

Go to the Export tab and copy your unique embed script

​
Configuration Tabs

The widget editor includes six tabs on the left with a live preview on the right that updates as you make changes.
Widget configuration interface showing left sidebar with Setup, Appearance, Content, Features, Actions, Privacy, and Export tabs, main configuration panel with Widget Name field, Agent dropdown, Display Name field, and Allowed Domains input, live preview panel on right showing widget appearance
Widget configuration interface showing left sidebar with Setup, Appearance, Content, Features, Actions, Privacy, and Export tabs, main configuration panel with Widget Name field, Agent dropdown, Display Name field, and Allowed Domains input, live preview panel on right showing widget appearance
  • Widget name - Internal label shown in your widget list
  • Agent - Switch to a different agent anytime
  • Display name - Customer-facing name shown in the widget
  • Allowed domains - Restrict where the widget can load (leave empty to allow all domains)
Theme Presets
  • Start from curated color palettes
  • Scroll through preset options
Layout
  • Position: bottom-left or bottom-right
  • Widget size and offsets from edges
  • Initial state: collapsed, expanded, or always open
Avatar
  • Animated “AI Pulse” effect
  • Upload custom image
  • Link to external image URL
Colors & Gradients
  • Backgrounds and CTA colors
  • Transcript bubble styling
  • Status colors and orb gradients
Border Radius
  • Launcher button roundness
  • Chat window corners
  • Message bubbles
  • Input field and CTA button
Animations
  • Optional wiggle or ripple effect on call button
Language Presets
  • Pre-configured English and German bundles
  • Sets all widget labels and legal copy
Welcome Messages
  • Welcome prompt text
  • Placeholder text
  • Status messages (listening, speaking, thinking, connecting)
Feedback Copy
  • Feedback prompt
  • Submit button text
  • Thank you message
Label Overrides
  • Customize individual UI strings
  • Groups: Chat, Controls, Transcript, Audio, Accessibility
  • Chat-only mode - Disable voice, chat only
  • Allow text during call - Keep text input active during voice calls
  • Transcript toggle - Show/hide live transcript
  • Mute control - Show mute button to allow user to mute their microphone
  • Call timer - Display elapsed time
  • Branding - Show/hide “Powered by itellicoAI”
  • Skip greeting - Avoid greeting if user types first
  • Feedback collection - Enable post-call feedback (not stored yet, coming soon)
Configure client-side tools that your agent can invoke during conversations to show links, open pages, or trigger phone calls in the user’s browser.
Client Tools: Unlike API actions that run on your server, client tools execute directly in the user’s browser. The LLM decides when to call these tools based on the conversation context and the trigger description you provide.
Add up to five client tools:
  • Button text - Label shown to the user (e.g., “View pricing”, “Call support”)
  • URL - Web link (https://) or phone number (tel:)
  • Trigger - Describe when the agent should invoke this tool (e.g., “When user asks about pricing”, “When user wants to speak to a human”)
  • Behavior:
    • Auto-click - Automatically open the link when tool is invoked
    • Wait for response - Show button and wait for user to click (with optional timeout)
    • End call on click - Automatically end the conversation after user clicks
Phone number links (tel:) automatically end the call after the user clicks.
Terms & Privacy
  • Markdown editor for custom legal text
  • Default copy provided for new widgets
Consent Settings
  • Accept/dismiss button labels
  • Local storage key to remember consent
  • Require consent before activation
Create shareable demo links for stakeholders, clients, or team members to test your widget without embedding it on a website.Creating Share Links
  • Click Create Link to generate a demo page URL
  • Optionally add a name to identify the link
  • Set expiration: 24 hours, 7 days, 30 days, never, or custom date
  • Limit maximum demos if needed
Managing Links
  • View all existing share links with creation date and expiry
  • Track demo count and view statistics
  • Edit link settings (name, expiry, max demos)
  • Delete links that are no longer needed
Security Notes
  • Share links are publicly accessible—treat them like passwords
  • Set expiration dates for temporary access
  • Use demo limits for controlled testing
  • Delete links when no longer needed
Embed Script
  • Unique loader URL for your widget
  • Copy and paste before </body> tag
Installation Guides
  • Step-by-step instructions
  • Platform-specific tips:
    • Google Tag Manager
    • WordPress
    • Webflow
    • Shopify
    • Wix
    • Squarespace

​
Deploy Your Widget

1

Test in the preview

Use the live preview on the right side of the configurator to test your widget. Click the refresh icon if needed.
2

Copy the embed script

Go to the Export tab and copy your unique embed script.
3

Add to your website

Paste the script just before the closing </body> tag on your website.
4

Test it live

Load your site, click the widget, and test a voice or chat conversation. Check Conversations to verify the session was recorded.
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).
Notes:
  • Domain restrictions apply immediately. If configured, the widget only loads on allowed domains.
  • 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

  • Check browser console for JavaScript errors
  • Verify allowed domains include your site
  • Ensure script is placed before </body> tag
  • Check Content Security Policy settings
  • HTTPS required (except localhost)
  • User must grant permission manually
  • Check browser microphone settings
  • Some browsers block on first visit
  • WebRTC requires UDP ports open
  • Corporate VPNs may block WebRTC
  • Test from different network
  • Check browser WebRTC stats at chrome://webrtc-internals
  • Click Save Changes in the configurator
  • 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

Production Best Practices

Learn how to maintain and scale your widget deployment

Optimize Conversion

Improve engagement and user experience