Клієнт пише «хочу магазин у Telegram» і уявляє бота з кнопками. Через два уточнення виявляється, що потрібен каталог із фільтрами, кошик і оплата — а це вже Mini App, інший продукт з іншим бюджетом і стеком. Розберемо, чим Mini App відрізняється від бота, у яких задачах він обходить сайт, скільки коштує розробка і на чому такі проєкти найчастіше ламаються.

Mini App і бот — це різні продукти

Технічно Mini App — це веб-застосунок, який Telegram відкриває у власному вебв’ю й передає йому підписані дані про користувача. Фронтенд пишете будь-яким стеком, кладете на свій сервер, реєструєте URL у BotFather. Користувач тисне кнопку в боті — і бачить ваш інтерфейс на весь екран, без переходу в браузер і без логіна.

Комерційна різниця — у щільності інформації. Бот показує екран тексту й ряд кнопок: цього достатньо для лінійного сценарію «прийняти заявку — надіслати статус». Mini App показує сітку, фільтри й кошик водночас, і це потрібно там, де клієнт порівнює варіанти. Проблеми починаються, коли лінійним ботом намагаються обслужити нелінійний сценарій.

Задачі, де Mini App справді сильніший

• Каталог із фільтрами. Бот на кнопках витримує 15–20 позицій, далі користувач тоне в стрічці повідомлень. Mini App показує сітку так само, як інтернет-магазин, тільки без виходу з месенджера.
• Запис на послугу. Календар зі слотами в чаті — це десяток повідомлень туди-сюди й половина людей, які здаються на виборі часу. У Mini App це один екран: майстер, дата, час.
• Повторні покупки. Telegram уже знає, хто це: немає форми входу й немає «забув пароль» — найбільшої дірки у воронці повторних замовлень.
• Оплата без переходів. Картка зберігається на боці месенджера, тож друга покупка справді займає один тап; механіку ми розібрали в матеріалі про платежі в Telegram.
• Кабінети й внутрішні інструменти. Статуси замовлень для B2B-клієнта, чекліст для монтажника, зведення для власника — прямо в чаті, без окремого застосунку й роздачі доступів.

Як це влаштовано зсередини

1. 1

   Бот залишається точкою входу

   Mini App відкривається кнопкою бота, пунктом меню чату або inline-кнопкою. Бот усе одно потрібен — для розсилок, статусів і повернення користувача назад.

2. 2

   Telegram віддає підписані дані

   При відкритті у фронтенд прилітає initData: id користувача, ім’я, мова, час і hash. Це і є ваша авторизація — без паролів і SMS-кодів.

3. 3

   Сервер перевіряє підпис

   initDataUnsafe з клієнта підробляється за хвилину, тому hash перевіряють на бекенді токеном бота. Це найчастіша дірка в Mini App, зроблених нашвидкуруч.

4. 4

   Інтерфейс і повернення в чат

   MainButton, BackButton і кольори з теми Telegram замість власних кнопок. Після оформлення застосунок закривається й віддає боту дані замовлення — далі працює звична логіка.

Перевірка підпису — десяток рядків, які відділяють робочий продукт від дірки, через яку чужу знижку застосовують до свого акаунта:

import { createHmac } from 'node:crypto';

// initData — рядок, який Telegram передає у Mini App.
// initDataUnsafe з клієнта НІКОЛИ не є джерелом правди.
export function verifyInitData(initData: string, botToken: string): boolean {
  const params = new URLSearchParams(initData);
  const hash = params.get('hash');
  params.delete('hash');

  const dataCheckString = [...params.entries()]
    .sort(([a], [b]) => a.localeCompare(b))
    .map(([key, value]) => key + '=' + value)
    .join('\n');

  const secret = createHmac('sha256', 'WebAppData').update(botToken).digest();
  const signature = createHmac('sha256', secret).update(dataCheckString).digest('hex');

  return signature === hash;
}

Бюджет і терміни

Mini App коштує приблизно як вебзастосунок тієї ж складності плюс 10–20% на інтеграцію з ботом і тестування в мобільних клієнтах Telegram. Діапазони, з якими ми працюємо:

1. 1Інтеграція з обліковою системою або CRM — плюс $300–800 і найбільший ризик за строками, бо ви залежите від чужого API.
2. 2Реальна оплата всередині — плюс $250–600: інвойси, вебхуки, обробка невдалих платежів і повернень.
3. 3Адмінка для менеджера — плюс $400–900. Часто дешевше віддати керування в готову CRM, ніж будувати власну панель.

Помилки, які найдорожче виправляти

Часті питання про Telegram Mini Apps

Коротко

• Mini App — це веб-інтерфейс усередині Telegram із готовою авторизацією; бот залишається точкою входу й каналом повідомлень.
• Він виграє там, де користувач порівнює варіанти або платить повторно: каталоги, запис, B2B-кабінети, внутрішні інструменти.
• Органічного трафіку він не дає — верхню частину воронки далі закриває сайт.
• Бюджет: $700–1200 за вітрину, $1500–3500 за магазин з оплатою, від $3000 за кабінет з інтеграціями.