Widget configuration
Everything the visitor sees — colors, position, copy, the pre-chat form — is configurable per project. This page lists every setting, its options, and its default. Nothing here requires touching the snippet on your site: changes apply on the visitor's next page load.
Two places, same settings underneath:
- Web dashboard — the Chat widget section, with a real-time live preview that updates as you type.
- Telegram Mini App — project settings cover the theme, palette, launcher position, greeting, pre-chat form, and typing indicator. (The launcher icon is currently web-dashboard only.)
| Name | Type | Description |
|---|
| theme | "light" | "dark" | Overall widget theme. Default: "dark". |
| palette | string | Accent palette: "neutral", "indigo", "emerald", "amber", "rose", or "sky". Default: "indigo". |
| position | "bottom-right" | "bottom-left" | Which corner the launcher bubble sits in. Default: "bottom-right". |
| launcherIcon | "chat" | "question" | "smile" | Icon shown on the launcher bubble. Editable in the web dashboard. Default: "chat". |
| animation | "scale" | "slide" | "fade" | "none" | How the chat panel opens and closes. Default: "scale". |
Leave any of these blank and the widget falls back to its default text.
| Name | Type | Description |
|---|
| headerTitle | string | Label at the top of the chat panel. Default: "Chat with us". |
| greeting | string | First bubble shown when the panel opens. Default: "Hi there! 👋 How can we help?". |
| placeholder | string | Composer placeholder text. Default: "Type your message…". |
| Name | Type | Description |
|---|
| enabled | boolean | Master switch — when off, the snippet renders nothing at all. New projects start with chat OFF, so flip this on before testing. Default: false. |
| collectVisitorInfo | boolean | Show a pre-chat form (name + email) before the first message, turning anonymous questions into leads. Default: true. |
| showTypingIndicator | boolean | Show typing indicators in both directions — the visitor sees when you're typing, and you see when they are. Default: true. |
- Offline message — the config schema reserves an
offlineMessage field, but there's no way to edit it yet. It's on the roadmap. - "Powered by Eloqra" badge — always shown on the free tier.