Website Widget Connection

Summary

Path: Channels item in the side menu -> channel list -> Add channel -> Widget.

This guide takes you from creating a channel to installing the chat on a site. If the channel already exists, start by checking its domain in the settings, then configure its appearance and copy the generated code.

Creation form

1. Select Widget in the channel-type list.
2. Enter a clear widget name, such as the site or section name.
3. In allowed site domains, enter the domain where the chat will run.
4. Click the add button with a plus to add the entered domain to the list. If you make a mistake, remove an unnecessary domain.
5. Click Create Widget to create the widget channel.

Domains

An allowed domain determines which site may run this channel's code. It prevents the widget from being used on unrelated sites. Enter the address without a protocol or path, for example example.com; you can use a mask such as *.example.com for subdomains.

An empty list allows any domain. If the list is nonempty, external sites must match it. This project's landings on Senler domains are automatically allowed: you do not need to add them manually for a Widget block.

When creating a channel, add the domain directly in the form: enter it and click the plus button. You can change the list later in the created channel's settings.

Channel Name, Icon And Domains

On the channel settings page, in the widget block, click edit name, change the name or icon, then click Save. Cancel closes editing without saving.

The name and icon affect how the channel appears in the cabinet and lists. To change the icon, first enable name editing: after that the icon area becomes available for file upload.

Remove an unnecessary domain with the delete button. To add a new one, click Add domain, fill the domain field, and confirm the addition or click Cancel. Connection checks follow the domain list rules.

After creation

After creation, the cabinet opens the new channel's settings. Work through them from top to bottom, configure the appearance and chat features, and click Save. The generated site snippet is farther down in Embed Code. Copy it in full and insert it before the closing </body> tag on the site.

Widget settings

• channel name;
• icon;
• allowed domains;
• color scheme: light, dark or auto;
• language: Russian, English or auto;
• display mode: popup window or embedded widget;
• popup window position: top left, top right, bottom left or bottom right;
• window width from 200 to 800;
• window height from 300 to 1000;
• rounding radius from 0 to 50;
• shadow;
• welcome screen image;
• texts in Russian and English;
• welcome screen buttons in Russian and English;
• button settings;
• chat function settings;
• external AI connection through MCP;
• embed code.

Preview And Saving

• the window preview shows how the widget will look on the site;
• the button preview shows the floating chat launch button;
• the preview status icon shows whether the preview is starting, applying changes, synchronized, or in an error state. Select it to see the window and button states;
• on a mobile screen, the Widget, Button, and Settings tabs switch between the window preview, button preview, and settings form;
• after changing settings, click the save button.

The preview helps check theme, dimensions, rounding, texts, and colors before updating the widget on the site. When you change the header, new-dialog title, or empty-state text, it switches to the relevant screen for about 10 seconds and then returns to a regular conversation. Changing the input placeholder or chat features immediately returns the preview to the conversation where those changes are clearer.

After a setting changes, the preview tries to apply it immediately. “Preview is synchronized” means the change was applied by every preview part required for the selected mode: in popup mode, this is the window and button; in embedded mode, only the window. It does not mean the setting has already been saved to the channel. Saved appearance and features apply on the site on the next widget initialization. Fields explicitly supplied in init take priority over channel settings.

If the preview ends with an error, open its status. You can copy diagnostics for support or select Retry. Retry applies only to the preview and does not send a message to the visitor.

Detailed guides

• Widget interface: Messages, attachments, and conversation history from the visitor's perspective.
• Widget appearance: Configure the widget window, texts, and button in channel settings. These values are used on websites where this widget is installed.
• Widget greeting: Choose what visitors see before starting a conversation: a welcome screen or a message from an automation.
• Chat features: Configure the chat features available to visitors and the limits on credit spending.
• Widget MCP: Give visitors access to widget agents from an external AI client through MCP.
• Installing the widget: Get the connection code from channel settings and install the widget on your website.