- Home
- Skills
- APIs & Backend
- Telegram Mini App from One Sentence
More screenshots
Works with the AI Agents you already use
Telegram Mini App from One Sentence
This skill gives your agent three tested templates and a short workflow, so a one-sentence request becomes a Mini App you can actually launch.
Free
Telegram Mini App from One Sentence
Example session with this skill installed
I need a Telegram ordering bot for my coffee shop. Menu: espresso, latte, croissant. Orders should go to me.
- Read your context and instructions
- Compiled the telegram mini app
Summary
Built an
ordering Mini App for "Coffee Corner" from the ordering template, filled the menu in app/data.json, ran it in dev mode and placed a test order.
What was created
coffee-corner/
app/ index.html, app.js, server.js, data.json
_lib/ initdata.cjs, server-core.cjs, client/ (tma.js, tma.css, mock-telegram.js)
.env.example .gitignore package.json
Test run (real output)
Order placed in the browser: 2 × Latte, 1 × Croissant, note "No sugar please".
API response
{"orderId":1,"total":71000,"totalText":"71 000 UZS"}
Admin message printed in the terminal (what you get in Telegram):
New order #1
From: @test_user (id 1001)
2 × Latte = 56 000 UZS
1 × Croissant = 15 000 UZS
Total: 71 000 UZS
Note: No sugar please
Tamper check: a request with "price": 1, "total": 2 for 2 lattes was billed by the server at
56 000 UZS. A request with no initData got {"error":"missing initData"}.
Next steps (you do these)
- Create the bot in @BotFather and copy the token into your host's environment as
BOT_TOKEN. - Set
ADMIN_CHAT_ID,WEBHOOK_SECRET,WEBAPP_URL, deploy to any Node 18+ HTTPS host. - Set the bot's Menu Button to the app URL and test on your phone.
Note: orders are kept in memory and reset on restart. Add a database before real customers.
Connects securely to your tools. The creator never sees your data.
About this skill
Most Telegram Mini Apps that agents write work in the demo and break in production: the user id is read from the client, prices come from the cart, and the bot token ends up in the page. This skill gives your agent three tested templates and a short workflow, so a one-sentence request becomes a Mini App you can actually launch.
What you get
- ordering: catalog → cart → order sent to the admin chat (shops, cafes, delivery)
- booking: service → day → free slot → contact (barbers, clinics, tutors)
- survey: one question per screen, answers to the admin (leads, applications)
How it works
- The agent asks at most three questions: what is sold, who gets the orders, payments yes or no.
- It copies the closest template with
node scripts/new-app.cjs ordering my-shopand edits onlydata.jsonfor your items. - It runs
npm run dev: a mock Telegram (MainButton, BackButton, theme) with initData signed by the server, so the real security check runs in a normal browser. - It gives you the BotFather and hosting steps. It never asks for or handles your bot token.
Security built in
- initData validated on the server for every API call (HMAC with WebAppData, constant-time compare, 1-hour expiry)
- user id taken only from validated initData
- prices recomputed and slots re-checked on the server
- webhook protected with secret_token, user text escaped, body and quantity limits
Tested
18 unit and API tests (forged ids, another bot's token, expired data, price tampering, double booking, path traversal) and a Playwright walkthrough of all three flows at phone width run in CI.
Honest limits
Storage is in memory (add a database before real customers), no payments yet, and it is tested with a mock rather than inside the Telegram client.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for APIs & Backend.
Storage is in-memory by default. Telegram Payment provider tokens must be added manually. Requires Node 18+.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free to use
No account required to browse
Trust & safety
Security scan
Security scan passed 2 days ago
- Free with an Agensi account
- Software
Node.js 18+Telegram bot from @BotFather (for going live)
Permissions
Terminal: runs node scripts/new-app.cjs to copy a template and npm run dev for a local test. Write: only creates the new app folder you name (refuses non-empty folders), deletes nothing. No network calls from the skill; the generated app talks to api.telegram.org only after you deploy it with your own BOT_TOKEN. No tokens are stored in the skill; dev mode uses a random key made at startup.