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. Username аркьаҿ (иаҳҳәап, 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 — асифра (иаҳҳәап, Digital restaurant menu)
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-кодқәа URL ала https://lnc2w74z.cenaly.com аус руеит — браузер ала.

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 акнопкақәа