Telegram Mini App — чекор-по-чекор водич

Што е ова?#

Telegram Mini App им овозможува на вашите клиенти да го отворат дигиталното мени на ресторанот директно во Telegram — без инсталирање апликации и без префрлање во прелистувач. Менито изгледа како нативен дел од Telegram: се прилагодува на темата на корисникот, поддржува копче „Назад“ и гестикулации.

Предности#

• 📱 Внатре во Telegram — клиентот не треба да се префрла во прелистувач
• 🎨 Нативен изглед — боите, фонтовите и темата се прилагодуваат на Telegram
• 🔗 Deep Links — директна врска до менито на конкретен ресторан
• 🌍 Автоматски јазик — јазикот се зема од поставките на Telegram на корисникот
• 🍪 Без колачиња — банерот за колачиња не се прикажува внатре во Telegram

Најбрзиот пат — мастерот во панелот#

Во административниот панел: Продавница за апликации → картичка „Продавница во Telegram“ → „Постави“ (прозорецот се отвора директно на излогот, не треба никаде да одите). Мастерот ќе ве води низ четири чекори и сам ќе ја заврши поголемиот дел од работата:

1. Име на продавницата.
2. Создавање бот во @BotFather и проверка на токенот — токенот едноставно го вметнувате во мастерот.
3. Автоматско поставување на ботот: име, краток опис, копче „Мени“ со врска до вашето мени, вебхук и команди — Cenaly сето тоа го поставува преку Telegram Bot API, не треба рачно да притискате ништо.
4. Создавање Mini App (/newapp во BotFather) и врска до вашата продавница.

Напредокот се зачувува: мастерот може да го затворите и да продолжите подоцна.

Подолу е рачниот пат: истото целосно преку BotFather. Ќе ви послужи ако ботот веќе е поставен по ваши потреби или ако сакате да разберете што точно се случува.

Брз старт (рачно)#

Чекор 1 — Создајте бот#

Отворете @BotFather во Telegram и испратете:

/newbot

1. Внесете име на ботот (на пример, Cenaly Menu Bot)
2. Внесете username (на пример, MeniMenuBot) — мора да завршува на Bot
3. Зачувајте го добиениот Bot Token (формат: 123456789:ABCdefGHI...)

Зошто е потребен Bot Token?#

Bot Token е таен клуч за програмско управување со ботот преку Telegram Bot API. Ако сето тоа го правите рачно преку BotFather (чекори 2–4), тој не е потребен.

Токенот е потребен за да му го предадете ботот на Cenaly — тогаш панелот сам го поставува и ботот почнува да работи за вас:

• Поздрав и копче „Мени“ — ботот поздравува на јазикот на гостинот, земајќи ја предвид вертикалата (ресторан, салон, хотел, продавница), и го отвора излогот како Mini App
• Потсетници за термин — гостинот се претплатува на потсетник за посетата и го потврдува или откажува со копче „✅ Ќе дојдам“ / „❌ Откажи“ директно во разговорот
• Известувања до сопственикот — новите термини и откажувањата пристигнуваат во вашиот личен разговор со ботот. Претплатата се вклучува со приватна врска од типот t.me/{бот}?start=admin_…: таа се прикажува во мастерот на чекорот „Готово“ и во картичката за интеграција. Не ја објавувајте врската — известувања ќе почне да добива секој што ќе ја отвори. (Гостинот, пак, може да ги види своите претстојни термини со командата /bookings во разговорот со ботот.)
• Преписка со гостите — преку посебен канал во делот „Работен разговор“ → секција „Гости“: пораките од Telegram паѓаат во заедничкиот инбокс заедно со разговорот од сајтот, WhatsApp, Instagram и е-поштата (за ова е потребен сопствен бот — еден бот може да има само еден вебхук)

А токенот ќе ви послужи и ако сакате да автоматизирате нешто свое: да испраќате пораки до клиентите, да додавате inline-копчиња во пораките на ботот (видете го делот подолу) или да го поврзете со својот систем.

Чекор 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

Вградени копчиња од ботот#

Ако вашиот бот испраќа пораки до клиентите, можете да додадете вградено копче што ќе го отвори менито:

Варијанта 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