· AvaGuru · tutorials · Updated · 8 min read
How to Set Up a Telegram Shop for Digital Downloads
Create a Telegram shop with AvaGuru, connect your bot, add files or license keys, accept Telegram Stars, and test delivery before launch.
To sell digital downloads on Telegram with AvaGuru, create a bot through BotFather, connect it to your AvaGuru store, add a digital product, upload its files or license keys, and test a purchase using Telegram Stars. Buyers browse your Mini App storefront inside Telegram and access their purchase through their order after payment succeeds.
This guide follows AvaGuru’s merchant interface as of November 16, 2026. It covers one-time downloads and keys. The examples are setup examples, not customer results.
Want to see the buyer experience first? Open the AvaGuru demo shop, or review the Telegram store builder overview.
What you need before creating the store
Prepare a Telegram account, the finished product, a cover image you have permission to use, a clear description, and a support contact. Have the rights to distribute every file or key you sell.
A channel or group helps you reach an audience, but it is not the storefront itself. Your store bot opens the Mini App where buyers browse and purchase. You can share that bot link from a channel, newsletter, website, or conversation.
For digital goods sold inside Telegram bots and Mini Apps, Telegram Stars are required. Telegram’s official digital goods payment guide applies to ebooks, downloadable templates, software, and game keys. Card processors or cryptocurrency are not alternative checkout methods for these in-app digital purchases.
1. Create a dedicated store bot
- Open the official BotFather in Telegram.
- Send
/newbotand follow the prompts to name the bot. - Choose an available username ending in
bot. - Copy the HTTP API token and keep it private. You will paste it into AvaGuru, not into a public channel or product description.
Telegram’s bot creation tutorial explains the token and why it must be protected.
If the bot already serves another storefront, plan the change before connecting it. AvaGuru’s create-store form includes This bot is connected to another platform, which saves the bot without replacing its existing webhook until you confirm the switch. A fresh dedicated bot is simpler for a first shop.
2. Create the AvaGuru store and connect Telegram
Open the AvaGuru dashboard and complete registration. In Create Your Store, enter:
- Store Name and Store Slug. The form previews your Mini App address.
- A description of what the shop sells.
- Bot Token and Bot Username from BotFather.
- Default Currency and your store language.
Submit the form and follow onboarding to choose or activate your plan. Wait for Telegram setup complete before sharing the shop. If the connection fails, use Retry connection and check the supplied bot details.
Your store currency is used for catalog pricing; digital checkout uses Stars. Check the amount shown to buyers instead of assuming that a price entered in dollars is a count of Stars.
3. Add a digital product with the right delivery mode
In Products, add a product and choose Digital under Product Type. Enter its name, short description, full description, and price. Add a cover through Image URL. Start with Draft while you finish delivery setup.
Under Delivery Settings, select the option matching the purchase:
| Delivery Mode | Use it for | What you prepare |
|---|---|---|
| Downloadable Files Only | PDF ebooks, templates, audio packs, ZIP bundles | The downloadable files and a positive Stock Quantity |
| License Key Only | Authorized game activation codes or software keys | A CSV of unused keys |
| License Key + Files | Your software installer plus an activation key | Both files and a key pool |
A downloadable course workbook belongs in the file option. Selling a PDF or video bundle does not provide a full learning management system: do not advertise quizzes, progress tracking, or certificates unless you supply those elsewhere.
For detailed product-specific examples, see selling ebooks on Telegram and selling license keys on Telegram.
4. Save the product, then add files or keys
For downloadable files
Click Create Product, then reopen the product for editing. Upload Files appears for saved digital products with file delivery enabled.
Choose a file, enter its display name, and add a version or description if helpful. Upload it and confirm it appears under Downloadable Files. PDF and ZIP are supported formats; for an ebook bundle with EPUB, package the EPUB inside a ZIP rather than assuming direct EPUB upload is supported.
The upload form offers Max Downloads (Optional) and Download Expiry (Days). Leaving those optional limits unset avoids adding a count or expiry restriction. If you set limits, explain them on the product page before the buyer pays.
For Downloadable Files Only, set Stock Quantity above zero. File products start at zero stock; uploading a file alone does not make them purchasable. Choose and monitor the quantity you intend to offer.
For license keys
From the product’s actions in Products, choose Licenses. On the License Pool page, use Import License Keys to upload a CSV with one real, unused key per line. Check the imported count and Available total before publishing.
Use separate products and pools for different editions, platforms, or regions. AvaGuru distributes the keys you supply; your software or the publisher’s activation service determines whether a key activates the product. For your own software, you can integrate AvaGuru’s public licensing API; that requires a tested application or endpoint update. See recurring software licenses on Telegram for activation, migration and renewal boundaries.
5. Check Stars pricing and your actual costs
Read the Telegram Stars payments guide before setting your final price. Use the Stars calculator to explore pricing and payout assumptions, then verify the live checkout amount.
AvaGuru’s business model is SaaS subscriptions, with no AvaGuru revenue share on each sale. That does not mean selling is cost-free. Your plan, Telegram Stars purchase and reward economics, withdrawal arrangements, taxes, and your own operating costs affect what you keep. Consult current AvaGuru pricing and Telegram’s current terms rather than treating a calculator estimate as a guaranteed payout.
If you are comparing platforms, the Gumroad alternative for Telegram page explains the broader decision. Include tax administration and buyer support in that comparison, not just the platform fee.
6. Test one complete purchase before announcing the shop
When the product files or key pool are ready, change its status to Active. Open your own bot in Telegram as a buyer and check the whole journey:
- Start the bot and open the storefront.
- Find the product and read its description on a phone.
- Confirm the price and pay through the Telegram Stars invoice.
- Wait for successful payment and fulfillment; opening or approving an invoice is not itself a completed purchase.
- Open the order and download the file or reveal the assigned key.
- Open the downloaded file on the intended device. For a key, test activation in the actual software or publisher platform using a key allocated for testing.
- Check the order in the Admin Portal and make sure the support contact is easy to find.
A live Stars purchase can spend real Stars. The demo lets you inspect the storefront, but it is not evidence that your own bot, files, inventory, or activation process is configured correctly.
7. Publish a useful announcement
Share your bot link with a short explanation of the product, the intended buyer, what is included, and how to get help. For example, an ebook announcement can show a sample page and state that the purchase includes a PDF and a ZIP containing an EPUB edition.
Pin the announcement in your channel and keep the product description consistent with it. For a broader plan covering an audience, offers, and repeat purchases, see Telegram creator monetization.
Common setup problems
| Problem | What to check |
|---|---|
| File product cannot be bought | Product status is Active and Stock Quantity is above zero |
| No upload section | Save the product first, reopen it, and select a delivery mode that includes files |
| Key product has no inventory | Open Licenses and confirm there are Available keys in the correct product pool |
| Bot is not ready | Check connection status and retry setup; confirm any planned migration cutover |
| Buyer cannot download | Check payment and fulfillment status, file availability, download count, expiry, and whether a refund has affected access |
| Download works but the file will not open | Test the actual file format and explain required reader, software, or ZIP extraction steps |
Do not delete a product file simply to tidy the dashboard. Deleting it removes access to that file for previous buyers too.
Frequently asked questions
Does AvaGuru stop buyers from sharing downloaded files?
AvaGuru uses private file storage and controlled download access, with optional count and time limits. Those controls do not prevent someone from copying a file after downloading it. Apply any static watermark before uploading, explain the buyer’s usage rights, and avoid promising DRM or automatic personalized watermarking.
Can I take card or crypto payments for these downloads inside Telegram?
No. Digital goods sold inside Telegram bots and Mini Apps use Telegram Stars. Payment options for other kinds of commerce should not be confused with the rules for digital goods.
Who handles refunds and support?
You are responsible for the buyer relationship and legitimate payment disputes. Telegram’s Stars payment guide requires payment support and explains Stars refunds. Publish a clear support contact and refund policy; do not send buyers to Telegram support for your product problems.
Can I bring previous customers from another platform?
AvaGuru has Restore Buyers for eligible past purchases. See the Gumroad migration guide for exports, product mapping, and proof of purchase. Recreating a storefront alone does not transfer old purchases or recurring billing agreements.
Start with one complete product
Explore the demo shop, then create your store. Connect the bot, finish one product, and verify payment and delivery before adding the rest of your catalog.