Quickstart

Start selling in minutes

Clear setup for creators and a clear payment flow for buyers — from first offer to first sale.

Who this is for

Creators: sell paid content, files, and private access.
Buyers: pay with Telegram Stars and get content instantly in chat.

1

Connect your Telegram bot

Use your own bot token and webhook. If you need help, follow the setup steps in this page and test with /start.

2

Create your first paid content

Set a title, choose a Stars price, then add text, link, message, or file content.

3

Share your buy link

Post your buy link in your Telegram channel, group, or DMs. Buyers pay in chat and get content instantly.

4

Track performance

Use dashboard stats to see views, sales, and earnings. Improve title/price based on what converts.

Useful commands

These commands are for creators running sales through the bot.

/startInitialize your account in bot chat
/new <price> <title> | <content>Create a quick paid content item
/attach <id>Attach file to a file-type item
/buy <id>Open purchase flow for an item

Secret rotation runbook

1) Rotate BOT_TOKEN
Create a new bot token in BotFather, update `BOT_TOKEN` in deployment secrets, redeploy, and confirm `/start` plus invoice flow still work.

2) Rotate WEBHOOK_SECRET
Generate a new random secret, update webhook configuration in Telegram, update deployment secret, then verify webhook requests are accepted.

3) Rotate Turso credentials
Issue a new DB auth token, update `TURSO_AUTH_TOKEN`, redeploy, and run a read/write smoke test from dashboard and purchase endpoints.

4) Validate + rollback plan
Track error rates for 15 minutes post-rotation. Keep previous secrets available for quick rollback if auth/webhook verification fails.

Ready to launch your first paid drop?

Create it, share it, get paid in Telegram Stars.