Мазмұнға өту
Promenu Нұсқаулық
Сайтқа Тіркелу

Алғашқы қадамдар

Цифрлық мәзірге Telegram Mini App-ты қалай қосуға болады

Қадамдық нұсқау: цифрлық мәзірді Telegram Mini App ішінде ашу — BotFather-де бот құру, токенді Promenu-ға қою, URL-ды Main App пен Menu Button-ға жазу. 10–15 минут.

2026 ж. 11 қыркүйек жаңартылды 5 мин оқу

Telegram Mini App — сол цифрлық мәзірдің өзі, тек Telegram ішінде: қонақ ботыңызды ашып, ештеңе орнатпай және чаттан шықпай каталогты парақтайды. Қазақстанда қонақтардың көбі мессенджерде жүргендіктен, бұл QR-мен ашылатын сол каталогқа тағы бір есік.

Төменде — бос боттан Promenu ішіндегі жұмыс істейтін мини-қосымшаға дейінгі жол. Орын әлдеқашан құрылған болса, көбі 10–15 минутта бітіреді. Орын жоқ па? Алдымен цифрлық мәзірді жинаңыз.

Не қажет

  • 10–15 минут.
  • Promenu панеліне кіру және әлдеқашан құрылған орын.
  • Телефондағы немесе компьютердегі Telegram.
  • Көрсетуге дайын каталог: бірнеше тағам және Menu view (мәзірді қарау) — ол әуел бастан қосулы.

Панельде қайда кіру керек

  1. Places (орындар).
  2. Орынды ашыңыз → Edit (өңдеу).
  3. Орын бөлімдерінде Mini App (мини-қосымша) ашыңыз.

Экранда екі өріс және дайын сілтеме бар: Bot token (бот токені), Bot username (боттың username-і, @ белгісінсіз) және https://tg.promenu.space/?rmode=… түріндегі URL, қасында Copy URL (URL-ды көшіру) батырмасы. Сол экранда "How to set up Mini App" және "How to create a bot in @BotFather" аңыспалары тұр — төменде сол жол қарапайым тілмен.

Telegram Mini App-ты қалай қосамыз: 4 қадам

  1. Telegram-да бот құрыңыз

    @BotFather ашыңыз — бот құруға арналған ресми Telegram боты. Start басыңыз, содан кейін Create a new bot таңдаңыз немесе /newbot жіберіңіз. Боттың атын қонақтар көреді (мысалы, «Жағалаудағы дәмхана»). Username — латын әріптерімен және bot деп аяқталуы керек, @ белгісінсіз: оны кейін Promenu-ға қоясыз. Сипаттама мен аватар кейін де қойылады. BotFather токен жібереді — 123456:ABC-… сияқты ұзын жол. Көшіріп алыңыз, ешкімге жібермеңіз.

  2. Бот деректерін Promenu-ға қойыңыз

    Places → сіздің орын → Mini App бөліміне оралыңыз. BotFather токенін Bot token өрісіне қойыңыз — Show token (токенді көрсету) артық бос орын жоғын тексеруге көмектеседі. Bot username өрісіне username-ді @ белгісінсіз жазыңыз: бот @biba_cafe_bot болса, biba_cafe_bot деп жазыңыз. Орын карточкасын сақтаңыз. Promenu осы экранда мини-қосымшаның URL-ын әлдеқашан көрсетеді — Copy URL басыңыз.

  3. URL-ды BotFather-ге жазыңыз

    @BotFather қайта ашыңыз. Ботты тізімнен таңдаңыз немесе /mybots жіберіңіз. Әрі қарай: Bot Settings → Mini Apps. Promenu-дағы сол URL-ды екі жерге қойыңыз: Main App (боттың негізгі мини-қосымшасы) және Menu Button (хабар жолағының қасындағы батырма, қонақ мәзірді бір рет басып ашады).

  4. Telegram ішінен тексеріңіз

    Ботты username бойынша тауып, Start басыңыз да, мәзір батырмасынан Mini App ашыңыз. Атау, мұқаба, санаттар мен тағамдар көрінуі керек — Modes (режимдер) ішінде қосулы нәрсе. https://tg.promenu.space/?rmode=… сілтемесін браузерде де ашып, каталогқа көз жүгіртуге болады, бірақ нағыз Mini App тек Telegram ішінде сезіледі.

Жақын жерде тағы не тексеру керек

Бұл экрандар Mini App-тың орнын баспайды, бірақ оларсыз қонақ бос қабық ашуы мүмкін.

  • Link (сілтеме) — орынның қысқа ашық slug-ы (латын әріптері, цифрлар, - және _, 3–64 таңба). Бос қалдыруға болады.
  • Modes: Menu view әуел бастан қосулы. Telegram-нан тапсырыс алғыңыз келсе, Delivery (жеткізу) мен Pickup (өзі алып кету) қосыңыз — оларға Pro немесе Ultimate тарифі керек.
  • Active (белсенді) — өшірулі болса, орын жоба күйінде қалады да, қонақ оны көрмейді.

Іске қосар алдындағы тексеру тізімі

  • Орынды аштым → Mini App.
  • @BotFather-де бот құрдым.
  • Токенді Promenu-ға қойдым.
  • Username-ді @ белгісінсіз қойдым.
  • Promenu-дан URL-ды көшірдім.
  • Сол URL-ды BotFather-де Main App пен Menu Button-ға жаздым.
  • Ботты Telegram-да ашып, мәзір дұрыс екенін көрдім.
  • Орын Active, мәзірде тағамдар бар.

Бірдеңені ұмытсаңыз, қайда басу керек

Жылдам навигация: Promenu және BotFather
ТапсырмаҚайда
Mini App баптауыPlaces → орын → Mini App
Бот құруTelegram → @BotFather → /newbot
URL жазуBotFather → бот → Bot Settings → Mini Apps
Орынның ашық сілтемесіОрын → Link
Жеткізу және өзі алып кетуОрын → Modes
Карточка үлгісіОрын профилі → App preview

BotFather username немесе URL үшін ұрысса, көбіне username бос емес — не сілтемеге бос орын кіріп кеткен. URL-ды Copy URL арқылы қайта көшіріп, өзгертпей қойыңыз.

Жиі қойылатын сұрақтар

Жаңа бот құру міндетті ме?

Орынға BotFather-дегі бот керек. Өзіңіздегі дайын ботты алуға болады: токені мен username-ін Promenu-ға қойып, Mini App URL-ын сол боттың баптауына жазыңыз.

Бір бот бірнеше орынға жарай ма?

Қонаққа әр орынға немесе брендке бөлек бот түсініктірек. Күмәніңіз болса, бір орынға бір боттан бастаңыз.

Токен мен username-дің қайсысы маңызды?

Promenu-ға екеуі де керек. Токен панельді ботқа байлайды; username адамдарға да, жүйеге де қай ботты қосқаныңызды айтады.

Неге Telegram бос немесе басқа мәзір ашылады?

Осы ретпен тексеріңіз: Promenu-да дұрыс токен мен username сақталған; BotFather-дегі Main App пен Menu Button-да осы орынның URL-ы тұр; орын Active күйінде; мәзірде позициялар бар; керек режим қосулы. Тағы да қиын болса, Telegram-да @EmilDevelop жазыңыз.

Токенді панельде сақтау қауіпсіз бе?

Токенді тек орынды өңдей алатын адам көреді. Оны чатқа қоймаңыз. Сыртқа шықса, BotFather-де қайта шығарып, Promenu-да жаңартыңыз.

Домендердің жеке ақ тізімі керек пе?

Promenu-дың қазіргі Mini App экраны домендердің ақ тізімін сұрамайды: панельдегі URL-ды BotFather-дің Mini Apps бөліміне жазу жеткілікті.

Орынның мәзірін Telegram-да ашуға дайынсыз ба?

Панельді ашу

Осы қадам бойынша сұрақ қалды ма? Telegram-ға жазыңыз