A Telegram store works only with a store on Elbuz CMS: your website opened inside Telegram as a Mini App. Customers tap a bot button and, without signing up, see the same catalog, cart and checkout, with the same design, products, prices and stock.
When you need this:
- Customers use Telegram more than your site — the “Shop” button opens the site in chat.
- Customers ask about their order — the bot reports status changes.
- Customers have questions — /support forwards them to your managers' group.
Where to start: create a bot in @BotFather and connect it in your store settings.
What a Telegram store can do
- Your website as a Mini App — the catalog, cart and checkout open in Telegram, in the customer's theme.
- Sign-in without a password — the customer is recognized by their Telegram account, and a store account is created automatically.
- Bot commands — /shop, /catalog, /cart, /orders, /support right in the chat.
- Status notifications — the bot messages the customer when their order status changes.
- New orders to managers — every order from Telegram arrives in your managers' group.
- Broadcast — a message with a picture and a button to all bot subscribers.
- The same catalog as on your website — update the catalog on the website, and Telegram is updated too.
Don't confuse it with the Elbuz support bot. The Telegram store is a storefront for your website; a support bot handles conversations with customers in Elbuz tickets. They are different bots with different tokens, and they don't interfere with each other.
What the customer sees: Mini App and bot commands
Mini App. The “Shop” button next to the message field or “Open Store” in the chat opens your website inside Telegram. It isn't a copy of the catalog but the website itself: the same pages, cart and checkout. The design matches the website, and the colors follow the Telegram theme, light or dark.
1
Your website inside Telegram2
Bottom menu of the website- The same design, catalog and prices as on the website.
- Home, catalog, wishlist, compare and cart.
In the cart, Telegram shows a “Checkout” button at the bottom of the screen, and after checkout the Mini App closes by itself within a few seconds.
1
Product with the selected options2
Checkout- The quantity is changed right here.
- Checkout runs on your website, in the same Mini App.
Sign-in. No sign-up needed: the store checks the Telegram signature and lets the person in under their Telegram account. On first opening, the store creates a customer for them. If they already have an account on your website, they can link Telegram to it: the Mini App's account section shows an email and password form.
Bot commands
Besides the Mini App, the bot responds to commands in the chat:
| Command | What it does |
|---|---|
/start | a greeting and a keyboard: “Open Store”, “Cart”, “Orders”, “Support” |
/shop | a button that opens the store as a Mini App |
/catalog | catalog categories as buttons in the chat |
/cart | the cart with products and the total |
/orders | the customer's order history |
/support | send a question to managers |
/settings | turn order status notifications on or off |
What you need before connecting
Telegram doesn't store your catalog — it shows your website. So first, the online store on the Elbuz platform must be ready: the catalog exported, products enabled, the website opening.
The website must use a secure protocol. Telegram opens a Mini App and sends customer messages to the bot only at https addresses.
The module exists only in a store on the Elbuz platform — one deployed from the app. For another website on a third-party CMS that you update through a tunnel, there is no Telegram store.
How to connect and set up the bot
You create the bot in Telegram through @BotFather and connect it in Elbuz: “Store settings” → “Integrations” → “Telegram store”. After you save, the store sets up the bot in Telegram within 5 minutes: the address for messages, the commands and the menu button.
The same screen has payment in the chat, customer notifications, the managers' group, bot texts, bot users and broadcasts. Step by step: How to set up your store's Telegram bot.
Open the bot and send /start: you should get a greeting with an “Open Store” button.
1
Greeting on /start2
Menu button- The greeting text is changed on the “Bot texts” tab.
- Appears after “Set menu button” and opens the store as a Mini App.
How to change the bot's name and picture
The name, description, start screen text and profile picture are properties of the bot itself, and you change them in Telegram, in BotFather:
- open a chat with @BotFather and send
/mybots; - choose your bot and tap Edit Bot;
- Edit Name — the name, Edit About — a short profile description, Edit Description — the text shown before the first start, Edit Botpic — the profile picture.
Changes apply immediately; you don't need to paste the token again.
Scenarios
Test the Telegram store before giving the link to customers
What to do: connect the bot, open it from your own Telegram, tap “Open Store”, add a product to the cart and place a test order.
What you get: you see exactly what a customer will see, and the test order arrives in the store like a regular order from the website.
What won't happen: there is no separate hidden test mode. The bot is available to anyone who knows its username, so don't publish the link until you've tested it.
Customers should get order status updates in Telegram
What to turn on: “Enable notifications” and a text for the statuses you need, for example “Shipped”. More: customer notifications.
What you get: when an order moves to a status with a template, the bot sends the customer a message in their language.
What won't happen: only customers who came to the store through Telegram and haven't turned notifications off with /settings get messages. A status with an empty template sends nothing.
1
Status notification- The text is the “Shipped” status template from the “Notifications” tab.
Managers should see new Telegram orders right away
What to turn on: the managers' group Chat ID in the bot settings; the “New orders to managers” switch is on from the start. More: managers' group.
What you get: for each new order from the bot or the Mini App, the bot posts the order number, total, products and the customer's contact to the group once. The text is in the store's default language, whatever language the customer uses.
What won't happen: orders placed on the website in a regular browser don't go to the group — only those that came from Telegram. Without the group Chat ID, there are no notifications.
Send a promotion to bot subscribers
What to do: in the “Broadcasts” block of the bot settings, write the text and add a picture and a button if needed. Send a test to yourself, then “Send to everyone”. Step by step: How to send a Telegram broadcast.
What you get: everyone who started the bot and didn't turn notifications off receives the message.
What won't happen: you can't stop a broadcast once it has started.
1
Test message- This is how subscribers will see the message (shown in the Ukrainian interface).
Managers should see customers' questions
What to turn on: create a group in Telegram, add the bot to it and enter the group's Chat ID in the bot settings — how to do it.
What you get: a customer taps “Support” or sends /support, writes a question, and the bot forwards it to the group. A manager answers in the group with the “Reply” button.
What won't happen: these conversations don't go to Elbuz tickets. To handle customer conversations in Elbuz, connect a separate support bot.
What to do when the bot doesn't work
| What you see | Why | What to do |
|---|---|---|
| The bot doesn't respond to /start | the bot is off, there is no token, or less than 5 minutes have passed since saving | check the bot settings — what to do when the bot doesn't work |
| The Mini App opens, but there are no products | the catalog hasn't been exported to the website yet, or all products are disabled | run the export to the website and check that the catalog opens in a browser |
| The bot stopped responding after the website moved to another domain | Telegram sends messages to the old address | open the bot settings and click “Save”: the store passes the new address to Telegram itself |
FAQ
Do I need a separate domain for a Telegram store?
No. The Mini App opens the website you already have. You need a separate domain only if you don't have a website yet.
Can I connect two bots to one store?
No, the bot settings have one token. A new token replaces the previous one, and the old bot stops receiving messages.
How do products get into Telegram?
Through your website: the Mini App is the website itself, and the bot commands read the same catalog. There is no separate export “to Telegram” — update the catalog on the website, and Telegram is updated too.
Can I show only some products in Telegram?
No, there is one storefront: Telegram has the same catalog as the website. You can only remove out-of-stock products from the bot command catalog with the “Hide out-of-stock products” switch; in the Mini App they stay as they are on the website.
Can I accept payments right in Telegram?
Yes, if the “Payment in Telegram” block has a payment provider token from @BotFather: a “Pay in Telegram” button appears in the bot's cart. Without it, the customer pays on the website with the payment methods connected to the store.
I changed the token in BotFather. What do I do?
Paste the new token into “Bot token” and save. The store reconnects the bot by itself within 5 minutes.
How do I check that the connection really works?
Open your bot and send /start. If you get a greeting with an “Open Store” button and the store opens, everything is in place. If the bot is silent, see what to do when the bot doesn't work.
Where to find it and who has access
- Menu
- Directories → Operations → Store settings → “Integrations” → “Telegram store”
- Access rights
- the “Store settings” window in group permissions
- Prepare
- a deployed store on the Elbuz platform with a website on
https, a bot and its token from @BotFather
Related topics
- If you need to connect the bot, notifications or broadcasts — How to set up your store's Telegram bot.
- If the Mini App opens but the catalog is empty or outdated — how the catalog gets to the website.
- If an order from Telegram has arrived and needs processing — Processing customer orders.
- If you need to handle Telegram conversations with customers in Elbuz tickets — Support bots.
- If you need a chat on the website itself — Smart chat for your website.
