Web Widget
What it is
The Web Widget is a chat widget for your website. Visitors open the bubble on the page, write a message, and your constructor scenario (or a human operator in Chats) replies — without Telegram or WhatsApp.
It is a good fit for landing pages, help centers, and product sites where you want a branded chat experience.
Requirements
- A constructor bot in Botconsole
- Permission to add a small script (embed code) to your website
- A plan that allows the web widget (trial or Pro, depending on your account)
How to connect
- Open Bots → your bot → Settings.
- Add connection → Web Widget (or open an existing widget connection).
- Configure appearance and behavior on the widget tabs (colors, welcome text, languages, position, etc.).
- Open the install / embed section and copy the code snippet to your site (or CMS).
- Publish the page and send a test message from the browser.
- Confirm that the constructor flow answers and that the dialogue appears in Chats.
You can run several widgets or keep Telegram + widget on the same bot — each connection is independent.
Message types and limits
Available message types
| Type | Supported |
|---|---|
| Text | Yes |
| Image | Yes |
| Video | Yes |
| Audio | Yes |
| Document | Yes |
| Media group | Yes |
| Sticker, location, contact | No / limited (use web-friendly media) |
| Poll, invoice | Not as native Telegram polls — use scenario alternatives |
Buttons
- Inline buttons under messages — yes
- Reply-style buttons in the chat UI — yes
- Up to 8 buttons per row, up to 20 rows
- Button text up to 64 characters
Extra message options
| Option | Available |
|---|---|
| AI streaming (live typing of AI replies) | Yes |
| Edit / delete bot messages | Yes |
| “Typing…” / processing status | Yes |
| Message effects | No |
| Reply to a specific message | No |
| Forward to another chat | No |
| Forum topics | No |
| 24-hour window | No — always available while the visitor is on the site |
Limits
| Limit | Value |
|---|---|
| Text | up to 10 000 characters |
| Caption | up to 4 096 |
| Files | about 50 MB (browser and hosting limits may be lower) |
Formatting
The widget supports lightweight Markdown similar to the constructor:
- Bold, italic, underline,
strikethrough - Inline code and code blocks
- Blockquotes
- Links
Spoilers are not used in the widget.
Notes and limitations
The visitor must load your site with the embed code. There is no external “BotFather” token for the widget.
Design mobile-friendly texts and short button labels — chat width is limited on phones.
If the widget is on a trial, finish setup before the trial ends or upgrade the plan that includes the widget.