Deployka
ВойтиНачать
Вся документация
PythonЭкспериментальный

Telegram Mini App

Бэкенд (серверная часть) для Telegram Mini App — мини-приложения, которое открывается прямо внутри Telegram, как маленький сайт внутри чата. Сам Mini App (то, что видит пользователь) нужно задеплоить отдельно — например, шаблоном «React SPA» — и указать его адрес в WEBAPP_URL.

  1. 1

    Зарегистрируйтесь на Deployka

    Если у вас ещё нет аккаунта — создайте его за 30 секунд: email и пароль.

    Создать аккаунт →
  2. 2

    Подготовьте нужные ключи/переменные

    Для этого шаблона нужно заполнить 2 переменные: BOT_TOKEN, WEBAPP_URL. Вот как их получить — шаг за шагом.

    BOT_TOKEN
    1. Откройте Telegram — на телефоне или компьютере, без разницы.
    2. В поиске введите @BotFather и откройте его — это официальный бот Telegram для создания ботов.
    3. Отправьте ему команду /newbot.
    4. Он спросит имя бота — введите любое, например «Мой первый бот». Это просто отображаемое имя.
    5. Затем спросит username — он обязательно должен заканчиваться на «bot», например my_first_helper_bot. Если имя занято, попробуйте другое.
    6. BotFather пришлёт сообщение с длинной строкой вида 123456789:AAHf3x... — это и есть ваш токен. Выделите и скопируйте его целиком.
    7. Вставьте этот токен в поле BOT_TOKEN на Deployka.

    Никому не показывайте этот токен — с ним можно полностью управлять вашим ботом.

    WEBAPP_URL
    1. Это адрес вашего Mini App — отдельного мини-сайта, который открывается прямо внутри Telegram.
    2. Сначала задеплойте сам мини-апп как обычный проект — например, шаблоном «React SPA» или «Landing Page».
    3. Скопируйте адрес получившегося проекта (вида https://имя.deployka.dev) со страницы этого проекта в личном кабинете.
    4. Вставьте этот адрес в поле WEBAPP_URL здесь.
  3. 3

    Запустите деплой

    Нажмите кнопку ниже — откроется страница шаблонов с уже выбранным этим шаблоном. Если он требует переменные — вставьте значения, полученные на шаге выше, и нажмите Deploy.

    Задеплоить «Telegram Mini App»

    Деплой обычно занимает 20–40 секунд. Статус проекта появится в личном кабинете и сменится на «running», когда всё готово.

  4. 4

    Проверьте, что всё работает

    В @BotFather откройте своего бота → Bot Settings → Menu Button и укажите там ваш WEBAPP_URL. Затем откройте бота в Telegram — рядом с полем ввода появится кнопка, открывающая Mini App.

    У этого типа проекта нет собственного веб-адреса — это нормально, не ошибка.

  5. 5

    Что-то не работает?

    Откройте страницу проекта в личном кабинете → вкладка Logs — там видна точная причина (неверный токен, ошибка в коде, отсутствующая переменная). Если не разобрались — напишите в поддержку прямо из личного кабинета или через Telegram-бота командой /support.

Ищете другой шаблон? Смотрите полный список в документации.