Telegram Mini App specsScope of Work Outline

Specification for a Telegram Mini App

Usually ready in 15 minutesRevisions includedQuality check
Packages
Payment protectionDetails
  • Revisions within the package are free.
  • If you do not respond within 3 days of delivery, the work is accepted automatically.

The money is reserved when you pay and released only once you accept the work.

Specification for a Telegram Mini App

Example result

Example for the Standard package

Specification: a Telegram Mini App for car wash booking

Launch points

  • The menu button in the @AquaDriveBot chat
  • A link in the chain's Telegram channel (11,000 subscribers)
  • A QR code at each wash bay, which opens the app with that location already selected

Screens

ScreenWhat the user doesData
LocationPicks one of 5 washes on a map or listAddress, open hours, queue now
ServiceChooses a wash type and car size4 programs, 3 sizes, price
TimePicks a 20-minute slotFree slots for the next 7 days
PaymentPays or chooses "pay at the wash"Payment provider via BotFather
My visitsSees bookings and loyalty stamps5 stamps of 6, next wash free

Key rules

  • The user is identified by Telegram initData, checked on the server with the bot token; no separate sign-up
  • A booking is held for 10 minutes while the user pays; after that the slot is freed
  • Reminders come from the bot 1 hour before the slot
  • The app follows the Telegram theme (light or dark) and works on screens from 360 px

Out of scope for version 1

Subscriptions, a staff app and payments in Telegram Stars (Stars are for digital goods, a car wash is a physical service).

Delivered

A 9-page spec, a screen map and a list of 12 API methods for the developer.

Client: Aqua Drive, a chain of 5 car washes Task: a spec for a Telegram Mini App: book a time slot, pay in advance and collect loyalty points (every 6th wash free)

The client and all details are made up.

About this service

A Telegram Mini App is a web app that opens inside Telegram, and that changes the rules: users are logged in through their Telegram account, screens must fit the chat window on a phone and follow the Telegram theme, and payments for digital goods go through Telegram Stars. We write a specification that covers how the app is launched, every screen, the main button and back button behavior, sign-in, payments, notifications and the admin side. Developers who know the Telegram platform can quote and build from it.

What is included

  • What you getA Mini App specification with goals, launch points, screen list and contents, sign-in and payment flows, notifications, admin features and open questions, as formatted text; any time or cost figures are rough guidance, not a quote.
  • Launch pointsMenu button, links, buttons in chats and channels
  • ScreensEach screen sized for the Telegram window
  • Telegram controlsMain button, back button, theme colors
  • Sign-in and paymentsTelegram account login, Stars or card payments
  • Admin sideOrders, content and user management

How it works

  1. 1
    BriefYou describe the app and audience
  2. 2
    PlanningWe map launch, screens and payments
  3. 3
    SpecYou get a specification for developers

What we need from you

What the Mini App does and for whom, where users will open it from, what they can buy or book, examples of Mini Apps you like and whether you already have a Telegram channel or community.

We will ask you:

  • What should the Mini App do?
  • Where will users open it from?
  • Will users pay inside the app?
  • Do you need an admin panel, and who will use it?

Compare packages

PackagesBasic$19Standard$39Premium$79
What is includedOne-page briefSpec up to 10 pagesFull spec up to 20 pages
Deadline1 day3 days5 days
Revisions123
Length1 pageup to 10 pagesup to 20 pages
Payment flowsNoYesYes
User stories and acceptance criteriaNoNoYes
Order BasicOrder StandardOrder Premium

Payment protection

You pay when you order, but the money is released only for accepted work.

  • Fixed priceThe package price does not change after you pay.
  • The money is reservedWhen you pay, the amount is only reserved. It is released to the service once you accept the work.
  • Checked before deliveryEvery result goes through a quality check before it reaches you, and you see it on the order page before accepting it.
  • Free revisionsAsk for changes within your brief as many times as the package allows.
  • Acceptance after 3 daysIf within 3 days of delivery you neither accept the work nor ask for changes, it is accepted automatically. If you write in the order chat after delivery, the order waits; once we answer, we may start the 3 days again and will say so in the chat.
  • Redo or a full refundIf the result does not match your brief and the revisions did not fix it, or the work takes more than twice its deadline, write in the order chat: we will redo the work or refund the payment in full.
How it works →

Questions and answers

Do payments have to go through Telegram Stars?

For digital goods and services inside Telegram, Stars are the required method under current platform rules; physical goods can use card payment providers. Platform rules change, so the spec flags this for your developer to confirm.

Will the app also work in a normal browser?

It can, if you want it to. The spec states which features rely on Telegram and what happens when the app is opened outside it.

Will you build the Mini App?

No, this service is the specification only.

Did not find your answer?

Packages