Your Elbuz CMS store bot tells customers about order status, forwards their questions to managers and sends broadcasts. Connect it with one @BotFather token in the store settings.
When you need this:
- Customers call about their order — the bot messages them on each status change.
- New Telegram orders must be seen at once — the bot posts them to the managers' group.
- You run a promotion — a broadcast with a picture and button reaches all subscribers.
- A customer asks to delete their data — one button removes their bot record and chat.
Where to start: “Store settings” → “Integrations” → “Telegram store” card and bot token.
What the store's Telegram bot can do
- Notify customers — a message for each order status, with your own text for each language.
- Send new orders to managers — to your Telegram group, with the products and the customer's contact.
- Forward customers' questions — a manager answers from the group, and the customer gets the answer from the bot.
- Accept payment in the chat — by card through a payment provider or with Telegram Stars.
- Show who uses the bot — search, filters and deleting a person's data on request.
- Send broadcasts — text, picture and button to all subscribers, with a test and a log.
What the customer sees in the bot itself — the catalog, cart, commands and the store as a Mini App — is covered in “Telegram store”.
How to connect the bot
You need a Telegram bot and a website on a secure https:// address: Telegram doesn't send bot messages to other addresses.
- Create a bot. In Telegram, open @BotFather, send
/newbot, and set the bot's name and username in Latin letters ending inbot, for exampletechnodim_shop_bot. - Copy the token from BotFather's reply. It looks like
123456789:AAE…. - Open the module screen: “Store settings” → “Integrations” section → the “Telegram store” card.
- In the “Bot” block, paste the “Bot token”, and enter the bot's username without
@in “Bot username”. - Turn on the “Enabled” switch at the top of the screen and click “Save”.
1
Telegram store card2
Card status mark- Telegram store — opens the settings of the store's bot.
- The status mark shows whether the bot is set up and whether the latest changes reached the store.
1
Bot token2
Bot username3
Mini App address4
Status card- The token from @BotFather; it is not shown again after saving.
- The bot's address without @.
- The store address to enter in BotFather when setting up the Mini App.
- Shows whether the changes reached the store, and the state of the bot and payment.
Within 5 minutes after saving, the store connects the bot in Telegram by itself: the address for messages, the menu button and the command menu. You don't need to click anything. To check, send /start to the bot.
The token is the key to your bot: whoever knows it can post on behalf of your store. After saving, the token isn't shown on the screen — only that it is set. To use a new token from BotFather, just paste it over the old one and save.
An enabled module won't save without a token. How “Save”, statuses and secret fields work is covered in “Store settings”.
Other fields of the “Bot” block
| Field | What it does | Default |
|---|---|---|
| Menu button text | The label of the button to the left of the message field, set for each language. The button opens the store inside Telegram | “🛍 Shop” |
| Open categories in Mini App | A category without subcategories opens as a website page with photos. When off, products are listed right in the chat | on |
| Hide out-of-stock products | The bot's catalog shows only products in stock. This doesn't affect the website | on |
| Mini App address | Your website address for BotFather, with a “Copy” button. You don't need to change it | store address |
Product links in Telegram
To make links open a product, category or cart in Telegram, turn on the Mini App in BotFather once: /mybots → your bot → Bot Settings → Configure Mini App. Take the address from the “Mini App address” field.
Links then look like https://t.me/technodim_shop_bot?startapp=product_42 — product 42. For a category use category_7, for the cart — cart.
How to notify customers about order status
- In the “Notifications” block, turn on “Enable notifications”.
- “Notification templates” appear under the switch: open the status you need and enter the text for each store language.
- Click “Save”.
1
Enable notifications2
New orders to managers3
Shipped message text4
Status without text- Shoppers receive a message when their order status changes.
- New orders from Telegram are sent to the managers' group.
- The message text; variables are filled in from the order.
- An empty row: no message is sent for this status.
“Notification templates” have a row for each store order status. The “Pending”, “Processing”, “Shipped”, “Complete” and “Canceled” statuses already have texts. The bot doesn't write about a status without text.
Order data goes into the text: {order_id} — number, {customer_name} — customer name, {order_total} — total, {order_status} — status name, {store_name} — store name. Example: Order #{order_id} has been shipped! Total: {order_total}.
Who gets the message
- A customer whose store account is linked to Telegram: they ordered through the bot or the store in Telegram, or linked the bot to their account.
- Only if they haven't turned notifications off with the
/settingscommand in the bot. - In the language chosen in the bot, otherwise in their Telegram language if the store has it, otherwise in the store language. For a language without text, the bot takes the English text, then the store language text.
The message goes out when the order status changes in the store. The bot can't write to customers who bought only on the website without Telegram.
How to get orders and questions in the managers' group
The bot writes to one Telegram group: new orders and customers' questions.
- Create a managers' group in Telegram and add the bot to it.
- Find out the group's Chat ID — a negative number starting with
-100, for example-1001234567890. - In the “Support” block, enter it in “Manager group chat ID” together with the minus sign, and save.
New orders
The “New orders to managers” switch in the “Notifications” block is on from the start. The bot posts to the group once: the order number, products with quantities, total, delivery, payment, and the customer's name, phone, email and Telegram.
Only orders from the bot and the store in Telegram come this way. The text is in the store language, whatever language the customer uses. If the switch is on but the Chat ID isn't set, the screen shows “Manager notifications are on, but the group Chat ID is not set” on the right.
Customers' questions
A customer taps “💬 Support” in the bot or sends /support and writes a question — the bot forwards it to the group. Any text sent to the bot that isn't a command or a button also goes to the group.
To answer, a manager taps “Reply” on the forwarded message. The bot sends the answer to the customer. A plain message in the group doesn't reach the customer.
“Auto-reply text (per language)” is what the bot writes in response to /support, for example “Send us your phone model and we'll suggest what fits”. An empty field means the standard text.
How to accept payment in the chat
The “Payment in Telegram” block adds a “💳 Pay in Telegram” button to the bot's cart: the customer pays in a Telegram window without leaving the chat. Without a provider token, the cart only has “🌐 Pay on website”; the exception is payment in Stars.
| Field | What it does | Default |
|---|---|---|
| Payment provider token | Issued by @BotFather: /mybots → your bot → Payments. Live and test payments use different tokens. Not needed for Telegram Stars | empty |
| Payment currency | UAH, USD, EUR or “Telegram Stars”. The amount is converted from the store's main currency at the exchange rate | UAH |
| Order status after payment | The status a paid order gets | “Processing” |
| Request shipping address | The customer enters an address and picks a delivery method in the payment window; the delivery price is added to the invoice. Only when the cart has a product that needs shipping | off |
| Request Phone Number, Request Email | Telegram asks the customer to fill in these fields in the payment window | off |
If the chosen currency isn't among the store currencies, the bot doesn't send an invoice and offers to pay on the website. Currencies and rates are set in the “Currencies and rates” window. Stars need the XTR currency there; an invoice in Stars is a whole number, and Telegram doesn't ask for the address, phone or email.
The Telegram payment window has only an address, without branches or parcel lockers. To deliver to a branch, the customer chooses “Pay on website”.
How to change the bot's texts
The “Bot texts” block is collapsed: expand it. It has 58 rows — the greeting, menu buttons, catalog, cart and orders. The standard text is shown in gray in the field.
- Enter your own text for the language you need. An empty field means the bot writes the standard text.
- Don't delete placeholders with the % sign: the bot inserts the product name, price or order number there.
- In the “Cart”, “Orders” and “Support” buttons, keep the icon first — 🛒, 📦, 💬. The bot recognizes these buttons by the icon.
Who uses the bot
The “Bot users” block lists everyone who wrote to the bot or opened the store in Telegram, newest first. The list is read from the store each time you open the screen; the “Refresh” button reads it again.
1
Search2
Notifications filter3
Account filter4
Linked store customer5
Notifications off6
Delete- Search by name, @username or Telegram ID.
- Shows who receives notifications and broadcasts.
- Shows who is linked to a customer account in the store.
- The store customer this Telegram user is linked to.
- The person turned notifications off or blocked the bot.
- Deletes the person's record, support chat history and the account created by the bot; orders stay.
| Column | What it shows |
|---|---|
| Name / @username | The name from Telegram; below it, the @username or Telegram ID |
| Account | The store customer linked to this Telegram account. If the customer exists in Elbuz, the name links to their card. “not linked” — there is no account |
| Notifications | “on” — the person gets notifications and broadcasts; “off” — they turned them off in /settings or blocked the bot |
| With us since | The date of the first contact with the bot |
Search by name, @username or the beginning of a Telegram ID. Filters: “Notifications on” or “Off”, “With account” or “Without account”, and the first contact period. The screen shows 100 people at a time, then “Show more”.
You can't turn notifications off for a person: that's their choice in the bot.
Delete a person's data
Trash icon in the row → “Delete”.
This deletes the person's bot record, the support conversation and the account the bot created. Orders stay, but without the name and contacts. If they write to the bot again, they get a new empty account.
If the person linked the bot to their own website account, that account isn't deleted. Its data is deleted in the customer card with the “Delete data on the website” button.
Deletion can't be undone: the support conversation is gone for good.
How to send a Telegram broadcast
A broadcast goes to everyone with notifications on. How many people will get it is shown at the top of the “Broadcasts” block: “Recipients: N”.
- Text. You can use
<b>bold</b>,<i>italic</i>and<a href="https://…">links</a>. Up to 4096 characters, up to 1024 with a picture; tags don't count. - Picture — an
https://…address or the library button next to the field. Optional. - Button under the message — “Button: text” and “Button: address”. Optional, but a button needs both fields.
- Test. In “Test: Telegram ID or group ID”, enter your Telegram ID or the managers' group Chat ID. Click “Send test” and check the message in Telegram.
- Send to everyone (N) → confirm.
1
Recipients counter2
Text field3
Send test4
Send to everyone- Recipients — how many people will get the broadcast: everyone with notifications enabled.
- Text — supports bold, italic and links, with a picture up to 1024 characters.
- Send test — first send the message to yourself or to the managers' group.
- Send to everyone — a started broadcast cannot be stopped.
The test doesn't go to the log. For it to arrive, first send /start to the bot yourself, and for a group, add the bot to it. If your Elbuz profile has your Telegram ID for notifications, the test field is filled with it automatically.
A started broadcast can't be stopped. Always send a test first.
The store won't accept the same broadcast — the same text, picture and button — a second time within 10 minutes. An accidental second click won't message everyone twice.
How a broadcast is sent
The store sends the broadcast by itself, in batches every minute: 1000 people get it within a few minutes. You can close Elbuz, but the bot must stay enabled: a disabled bot doesn't send broadcasts.
Progress is shown in the “Broadcast log”: how many of the total have been processed, delivered, errors, and how many people blocked the bot. While the status is “Sending”, the log refreshes by itself.
People who blocked the bot get the “off” mark and don't receive later broadcasts. “Errors” are messages Telegram didn't accept for other reasons.
Scenarios
Home appliances: delivery status without phone calls
Turn on “Enable notifications”. For the “Shipped” status, enter: Order #{order_id} has been handed over for delivery. The courier will call an hour before arrival.
A customer who ordered through the bot gets a message as soon as a manager changes the status.
Clothing: a manager sees orders and size questions
Create a “Managers” group, add the bot and enter the Chat ID in the “Support” block. Auto-reply: “Tell us your height and usual size — we'll help”.
New Telegram orders and customers' questions arrive in one group. A manager answers with “Reply”.
Sale: a broadcast with a button
Text <b>25% off 2025 washing machines</b>, a model photo from the library, and a “See models” button with the category address. A test to yourself, then “Send to everyone”.
Subscribers see the photo and the button in the chat with the bot. The result is in the broadcast log.
A customer asks to delete their data
In “Bot users”, find the person by @username and delete them. Orders stay for your records.
What to do when the bot doesn't work
| What you see | Why | What to do |
|---|---|---|
The bot doesn't respond to /start |
The module is off, there is no token, 5 minutes haven't passed since saving, or the website isn't on https:// |
Check “Enabled” and the token, save, and wait a few minutes. If that doesn't help, Elbuz support will check the bot's connection to the website |
| “Telegram did not accept the message: …” | You haven't sent /start to the bot, the bot isn't in the group, or the ID is wrong |
Send /start to the bot or add it to the group, check the ID and send the test again |
| “The bot token is not set — set it in the “Bot” block and save.” | The token hasn't been saved | Paste the token from @BotFather into the “Bot” block and click “Save” |
| The “Send to everyone (0)” button can't be clicked | Nobody has written to the bot yet, or everyone turned notifications off | Give customers the link to the bot: broadcasts work as soon as someone sends /start |
| “The same broadcast was just created…” | The same broadcast was started less than 10 minutes ago | Check the broadcast log — it's already being sent |
| A customer didn't get a status notification | The bot or notifications are off, the status has no text, or the customer didn't buy through Telegram | Check “Enabled”, “Enable notifications”, the status text, and the “Notifications” column in “Bot users” |
| “The Telegram module is not installed in the store or is outdated.” | The store has an old version of the module | Write to Elbuz support — they'll update the module |
FAQ
Can I send a broadcast to only some subscribers?
No, it goes to all subscribers with notifications on. Filters in “Bot users” only show people; they don't affect the broadcast.
Can I connect two bots to one store?
No, there is one token. A new token replaces the old one, and within a few minutes the store switches to the new bot.
Is this the same bot that sends me Elbuz notifications?
No. The store bot writes to customers. Employee notifications about Elbuz events come from a different bot — see “Event notifications”.
Does the customer see which manager answered?
No. The answer comes from the store bot; the customer doesn't see managers' personal accounts.
Where do I find my Telegram ID for the test?
Bots like @userinfobot show it. Write to such a bot, and it replies with your ID.
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 bot and its token from @BotFather, a website on
https://, a managers' group in Telegram
Related topics
- If you need to know what the customer sees in the bot — Telegram store.
- If you need to understand how the settings window works — Store settings.
- If an order from Telegram has already arrived — Processing customer orders.
- If Telegram conversations with customers should be handled in Elbuz tickets — Support bots.
