Setup
Basic configuration that defines how the widget operates.| Setting | Description |
|---|---|
| Widget Name | Internal name for identification in the widget list |
| Agent | The voice agent that handles conversations through this widget. Configure agents in your agent editor. |
| Display Name | The agent’s name shown to visitors in the widget |
| Domain Restrictions | Limit which domains the widget can load on. Leave empty to allow all domains. |
Appearance
Visual customization to match your brand identity.Theme Presets
Choose from a set of pre-designed color themes to quickly style your widget. Click any preset to apply it — you can fine-tune individual colors afterward.Layout
| Setting | Description |
|---|---|
| Placement | Bottom-left or bottom-right of the page |
| Size | Small, medium, or large |
| Horizontal Offset | Distance from the edge of the page (in pixels) |
| Vertical Offset | Distance from the bottom of the page (in pixels) |
| Expanded Behavior | Starts collapsed, starts expanded, or always expanded |
Avatar
Choose how your widget’s avatar appears:| Type | Description |
|---|---|
| Orb | Animated gradient pulse with 4 customizable colors |
| Image | Upload a custom image (PNG, JPEG, WebP) |
| Link | Display an avatar from a URL |
Colors
Colors are grouped into four collapsible sections for detailed control:Backgrounds
Backgrounds
Widget background, consent screen, chat area, feedback section, bottom section (input + branding), collapse button, and text on background.
CTA (Buttons)
CTA (Buttons)
Messages
Messages
Agent message background, text, and border. Visitor message background, text, and border.
Status
Status
Status description text, pulse ring, and indicator colors for speaking, listening, thinking, and connecting states.
Corner Radius
Control rounding for the widget container, input fields, message bubbles, CTA buttons, and collapse button.Content
Customize all text and labels displayed in the widget.Language Presets
Select a language to auto-populate all text fields with translated defaults. You can then customize individual labels.Welcome Messages
| Setting | Description |
|---|---|
| Welcome Message | Greeting text shown when the widget first opens |
| Placeholder Text | Hint text in the message input field |
Status Messages
| Setting | Description |
|---|---|
| Action Text | Main call-to-action button label |
| Connecting | Text shown while connecting |
| Listening | Text shown when the agent is listening |
| Speaking | Text shown when the agent is speaking |
| Thinking | Text shown when the agent is processing |
Feedback Messages
| Setting | Description |
|---|---|
| Feedback Message | Prompt shown to collect visitor feedback |
| Submit Button | Text on the feedback submit button |
| Thank You Message | Confirmation shown after feedback is submitted |
Features
Toggle capabilities on or off. Chat-only mode automatically disables some features.Widget Mode
| Setting | Description |
|---|---|
| Chat-only mode | Disable voice features and use text chat only |
Voice
Chat-only mode disables these settings.| Setting | Description |
|---|---|
| Allow text during call | Let visitors type messages while on a voice call |
| Show transcript | Display a live transcript of voice conversations |
| Mute control | Allow visitors to mute their microphone |
| Call timer | Show call duration during voice conversations |
Interaction
| Setting | Description |
|---|---|
| Skip greeting on initial text | Skip the agent’s greeting when the visitor starts with a text message |
| Enable feedback collection | Prompt visitors for feedback after the conversation |
| Allow image share | Let visitors share images in chat conversations |
Display
| Setting | Description |
|---|---|
| Show branding | Display “Powered by itellicoAI” in the widget footer |
Actions
Configure link buttons that appear in the widget, giving visitors quick access to common next steps. You can add up to 5 actions. Each action has:| Setting | Description |
|---|---|
| Label | Button text |
| URL | Destination link — supports https://, http://, and tel: for phone numbers |
| Auto-click | Open the link automatically when the action triggers |
| Await response | Wait for the visitor to complete the linked step before continuing |
| Timeout | Maximum wait time when Await response is enabled |
| End call on click | End the voice call after the visitor clicks a non-phone link |
| Trigger | Instructions for when the agent should show or use the action |
| Enabled | Toggle the saved action on or off from the action list |
tel: links, the widget treats the action as a phone handoff and disables web-page wait behavior.
Privacy
Control privacy and consent settings for widget visitors.Trust Center
| Setting | Description |
|---|---|
| Enable Trust Center | Toggle on to create a public privacy page for this widget |
| Privacy Policy URL | Link to your privacy policy (required when Trust Center is enabled) |
| Subprocessors URL | Link to your subprocessors list (optional) |
| Public URL | Auto-generated shareable link to the Trust Center page |
Terms & Consent
| Setting | Description |
|---|---|
| Terms Content | Markdown text displayed as your terms/consent notice |
| Accept Button Text | Label on the accept button |
| Dismiss Button Text | Label on the dismiss button |
| Consent Required | When enabled, visitors must accept terms before starting a conversation |
Share
Generate shareable links that open a standalone page with your widget — useful for stakeholder review and testing before going live.The share tab is only available after you save the widget.
Export
Generate the embed code to deploy your widget on your website. Copy the generated script and paste it into your website’s HTML, just before the closing</body> tag.
The embed code remains the same even when you update widget settings. The platform applies configuration changes automatically; you do not need to update your site’s code.
Next Steps
Web Widgets Overview
Manage your widget list, create new widgets, and open the widget editor
Widget Deployment
Follow the step-by-step guide to deploying your widget on your website