Widget Configuration

Access: Navigate to Web Widgets in the main menu and click Edit on any widget. The widget configuration editor lets you customize your web widget. A live preview on the right side of the editor updates as you make changes.

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.

Domain restrictions are an important security measure. Without them, anyone who obtains your embed code could deploy the widget on their own site. Add your domains to prevent unauthorized usage.

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

Widget background, consent screen, chat area, feedback section, bottom section (input + branding), collapse button, and text on background.

CTA (Buttons)

Button background, text, hover background, and border. Toggle to animate the start call button.

Messages

Agent message background, text, and border. Visitor message background, text, and border.

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

Customizing content labels is useful for localization or matching your brand voice.

Features

Toggle capabilities on or off. Chat-only mode automatically disables some features.

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

The widget fetches a favicon from the linked domain and displays it next to each action. For 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

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

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.

See Widget Share Links for full details on creating and managing share links.

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.

<script src="https://widgets.itellico.ai/widgets/your-widget-id/widget.js" async></script>

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.

Get Started

Build

Test

Deploy

Manage

Examples

Troubleshooting

Reference

Account Admin

Developers & Integrations

Billing & Usage

Partner Network

Legal

Widget Configuration

Setup

Appearance

Theme Presets

Layout

Avatar

Colors

Corner Radius

Content

Language Presets

Welcome Messages

Status Messages

Feedback Messages

Features

Widget Mode

Voice

Interaction

Display

Actions

Privacy

Trust Center

Export

Next Steps

Web Widgets Overview

Widget Deployment

​Setup

​Appearance

​Theme Presets

​Layout

​Avatar

​Colors

​Corner Radius

​Content

​Language Presets

​Welcome Messages

​Status Messages

​Feedback Messages

​Features

​Widget Mode

​Voice

​Interaction

​Display

​Actions

​Privacy

​Trust Center

​Terms & Consent

​Share

​Export

​Next Steps

Web Widgets Overview

Widget Deployment

Setup

Appearance

Theme Presets

Layout

Avatar

Colors

Corner Radius

Content

Language Presets

Welcome Messages

Status Messages

Feedback Messages

Features

Widget Mode

Voice

Interaction

Display

Actions

Privacy

Trust Center

Terms & Consent

Share

Export

Next Steps