Telegram Mini App — Քայլ առ քայլ ուղեցույց

Ի՞նչ է սա:#

Telegram Mini App-ը թույլ է տալիս ձեր հաճախորդներին բացել ռեստորանի թվային մենյուն անմիջապես Telegram-ի ներսում՝ առանց հավելվածներ տեղադրելու և առանց բրաուզեր անցնելու: Մենյուն նայում է որպես Telegram-ի բնիկ մաս՝ հարմարեցվում է օգտագործողի թեմային, աջակցում է «Հետ» կոճակին և ժեստերին:

Առավելություններ#

• 📱 Telegram-ի ներսում — հաճախորդը չի պետք է անցնի բրաուզեր
• 🎨 Բնիկ տեսք — գույները, տառատեսակները և թեման հարմարեցվում են Telegram-ին
• 🔗 Deep Links — ուղիղ հղում կոնկրետ ռեստորանի մենյուին
• 🌍 Ավտոմատ լեզու — լեզուն վերցվում է Telegram-ի օգտագործողի կարգավորումներից
• 🍪 Առանց cookies — cookie-ի բաները չի ցուցադրվում Telegram-ի ներսում

Արագ մեկնարկ#

Քայլ 1 — Ստեղծեք բոտ#

Բացեք @BotFather Telegram-ում և ուղարկեք:

/newbot

1. Մուտքագրեք բոտի անունը (օրինակ՝ Cenaly Menu Bot)
2. Մուտքագրեք օգտագործողի անունը (օրինակ՝ MeniMenuBot) — պետք է ավարտվի Bot-ով
3. Պահպանեք ստացված Bot Token-ը (ձևաչափ՝ 123456789:ABCdefGHI...)

Ինչու՞ է անհրաժեշտ Bot Token-ը:#

Bot Token-ը գաղտնի բանալի է բոտի ծրագրային կառավարման համար Telegram Bot API-ի միջոցով: Mini App-ի հիմնական կարգավորման համար (քայլեր 2–4) այն անհրաժեշտ չէ — ամեն ինչ կատարվում է BotFather-ի միջոցով: Բայց այն անհրաժեշտ կլինի, եթե ցանկանում եք.

• Ուղարկել հաղորդագրություններ հաճախորդներին — պատվերի կարգավիճակի ծանուցումներ, ակցիաներ, ողջույնի հաղորդագրություններ
• Ավելացնել inline-կոճակներ բոտի հաղորդագրություններում (օրինակ՝ «📋 Բացել մենյուն» կոճակը — տես ստորև)
• Ստեղծել Telegram-բոտ պատվերների ընդունման համար — բոտը կարող է ստանալ և մշակել պատվերներ
• Կարգավորել Webhook — ստանալ իրադարձություններ Telegram-ից (կոճակների սեղմումներ, օգտագործողի հրամաններ)
• Ինտեգրել CRM կամ POS համակարգի հետ — պատվերների ավտոմատ մշակումը բոտի միջոցով

Քայլ 2 — Ստեղծեք Mini App#

Ուղարկեք BotFather-ին հրամանը:

/newapp

1. Ընտրեք բոտը ցուցակից
2. Title — հավելվածի անվանումը (օրինակ՝ Cenaly)
3. Description — նկարագրություն (օրինակ՝ Թվային ռեստորանի մենյու)
4. Photo — վերբեռնեք 640×640 px պատկեր (հավելվածի պատկերանիշ)
5. GIF — անիմացիա (ոչ պարտադիր): Բաց թողնելու համար ուղարկեք /empty
6. Web App URL — նշեք ձեր հաճախորդի հավելվածի հասցեն:

https://cenaly.com

7. Short Name — կարճ անուն հղման համար (օրինակ՝ menu)

Դրանից հետո դուք կունենաք աշխատանքային հղում հետևյալ տեսքով:

https://t.me/YourBot/menu

Քայլ 3 — Ավելացրեք «Մենյու» կոճակը բոտի չաթում#

Ուղարկեք BotFather-ին:

/setmenubutton

1. Ընտրեք բոտը
2. Ուղարկեք URL:

https://cenaly.com

3. Մուտքագրեք կոճակի տեքստը (օրինակ՝ Open Menu կամ 📋 Մենյու)

Այժմ, երբ բացեք բոտի չաթը, էկրանի ներքևում կհայտնվի կոճակ, որը կբացի ձեր հավելվածը:

Քայլ 4 — Թույլատրեք դոմենը#

Ուղարկեք BotFather-ին:

/setdomain

Ընտրեք բոտը և նշեք դոմենը:

cenaly.com

Սա թույլ կտա Telegram Web App-ին աշխատել ձեր դոմենում և նրա բոլոր ենթադոմեններում (օրինակ՝ locationid.cenaly.com):

Deep Links — հղումներ կոնկրետ ռեստորանին#

Telegram-ը աջակցում է startapp պարամետրը, որը փոխանցվում է հավելվածին բացման ժամանակ: Օգտագործեք այն կոնկրետ ռեստորանի հղումների համար:

Օրինակներ#

Եթե ձեր ռեստորանի LOCATION_ID-ը lnc2w74z է:

https://t.me/YourBot/menu?startapp=lnc2w74z
https://t.me/YourBot/menu?startapp=lnc2w74z__ru
https://t.me/YourBot/menu?startapp=lnc2w74z__en

Inline-կոճակներ բոտից#

Եթե ձեր բոտը հաղորդագրություններ է ուղարկում հաճախորդներին, կարող եք ավելացնել inline-կոճակ, որը կբացի մենյուն:

Տարբերակ 1 — Web App կոճակ (բացվում է անմիջապես)#

{
  "inline_keyboard": [[{
    "text": "📋 Բացել մենյուն",
    "web_app": {
      "url": "https://LOCATION_ID.cenaly.com/ru"
    }
  }]]
}

Տարբերակ 2 — Deep Link կոճակ#

{
  "inline_keyboard": [[{
    "text": "📋 Բացել մենյուն",
    "url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__ru"
  }]]
}

Ի՞նչ է աշխատում ավտոմատ կերպով#

Telegram-ի ներսում միանալուց հետո ավտոմատ կերպով միանում են:

QR-կոդեր ռեստորանների համար#

Արդեն գոյություն ունեցող QR-կոդերը https://lnc2w74z.cenaly.com URL-ով կշարունակեն աշխատել ինչպես սովորաբար՝ բրաուզերի միջոցով:

Telegram-ի հետ լրացուցիչ ինտեգրման համար կարող եք սեղաններին տեղադրել երկրորդ QR-կոդը բոտի հղումով:

https://t.me/YourBot/menu?startapp=lnc2w74z

Աշխատունակության ստուգում#

1. Բացեք հղումը https://t.me/YourBot/menu հեռախոսով
2. Սեղմեք Start (եթե առաջին անգամ բացում եք բոտը)
3. Սեղմեք 📋 Մենյու կոճակը չաթի ներքևի վահանակում
4. Համոզվեք, որ հավելվածը բացվել է և բեռնվել է մենյուն
5. Փորձեք բացել deep link: https://t.me/YourBot/menu?startapp=LOCATION_ID

Հաճախ հանդիպող խնդիրներ#

Օգտակար հղումներ#

• Telegram Mini Apps-ի փաստաթղթեր
• BotFather
• Telegram Bot API — Web App կոճակներ