Букмекер в Telegram Mini App: как сделать приложение со ставками внутри мессенджера
Как запустить приложение со ставками прямо в Telegram — без отдельного сайта и магазинов приложений: спортбук-виджет, вход через Telegram, приём и расчёт ставок через SportAPI.

Telegram Mini App — это веб-приложение, которое открывается прямо внутри Telegram из бота. Для букмекерского проекта это способ запуститься без отдельного сайта и без проверки в магазинах приложений: пользователь нажимает кнопку в боте и сразу видит линию, live и купон. Всё нужное для такого приложения есть в SportAPI: готовый спортбук-виджет с линией, live и купоном, данные спортивной линии от $30 в месяц за вид спорта и услуга приёма и расчёта ставок от $300 в месяц. Ваша команда отвечает за пользователей, баланс и лицензию — или поручает весь проект разработке под ключ.
Почему букмекеру удобен Telegram Mini App
- Без магазинов приложений. Mini App — это веб-страница, поэтому обновления выходят сразу, без проверки и комиссий магазинов.
- Пользователи уже в Telegram. Не нужно уговаривать установить ещё одно приложение — достаточно открыть бота.
- Вход без пароля. Telegram передаёт приложению подписанные данные пользователя, и регистрация сводится к одному нажатию.
- Уведомления из коробки. Бот сам сообщает о начале матча, выигрыше или изменении коэффициента.
Из чего состоит букмекер в Mini App
| Компонент | Что делает | Решение |
|---|---|---|
| Интерфейс | Линия, live, рынки, купон | Спортбук-виджет SportAPI или свой интерфейс на API линии |
| Спортивные данные | Матчи, коэффициенты, счёт, статистика | API спортивной линии SportAPI |
| Ставки и расчёт | Приём купона, проверка коэффициентов, расчёт выигрыша | Услуга приёма и расчёта ставок SportAPI |
| Вход | Авторизация через аккаунт Telegram | Проверка initData на вашем сервере |
| Пользователи и баланс | Учёт игроков, пополнения и выплаты | Ваш сервер и платёжные сервисы |
| Уведомления | Выигрыши, старт матчей, акции | Ваш бот |
Шаг 1. Бот и Mini App
- Создайте бота через BotFather.
- Опубликуйте страницу приложения по адресу с HTTPS — например,
https://app.your-project.com. - Привяжите её к боту как Mini App: через BotFather создайте приложение или задайте кнопку меню с этим адресом.
После этого у бота появится кнопка, которая открывает ваше приложение внутри Telegram.
Шаг 2. Страница приложения
Страница Mini App — обычный HTML. Официальный скрипт Telegram даёт доступ к данным пользователя и управлению окном, а интерфейс ставок даёт спортбук-виджет SportAPI:
<!doctype html>
<html lang="ru">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<script src="https://telegram.org/js/telegram-web-app.js"></script>
</head>
<body>
<div id="sportsbook"><!-- сюда — код вставки спортбук-виджета от менеджера SportAPI --></div>
<script>
const app = window.Telegram.WebApp;
app.ready();
app.expand(); // открыть Mini App на весь экран
// initData с подписью Telegram — на свой сервер, чтобы войти без пароля
fetch('/api/telegram-login', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ initData: app.initData }),
});
</script>
</body>
</html>
Код вставки виджета — контейнер и загрузчик с параметрами вашего проекта — выдаёт менеджер SportAPI. Виджет адаптирован под мобильные экраны; посмотрите демо внутри Telegram до запуска, чтобы проверить отображение на своих устройствах.
Шаг 3. Вход через Telegram: проверка initData на сервере
Данные пользователя из initData нельзя принимать на веру — их нужно проверить на сервере по подписи, которую Telegram считает с токеном вашего бота. Проверка на Python по официальному алгоритму:
import hashlib
import hmac
import time
from urllib.parse import parse_qsl
def check_init_data(init_data, bot_token, max_age=3600):
"""Проверяет подпись initData из Telegram Mini App и возвращает данные пользователя."""
data = dict(parse_qsl(init_data, keep_blank_values=True))
received_hash = data.pop("hash", "")
check_string = "\n".join(f"{key}={value}" for key, value in sorted(data.items()))
secret = hmac.new(b"WebAppData", bot_token.encode(), hashlib.sha256).digest()
expected = hmac.new(secret, check_string.encode(), hashlib.sha256).hexdigest()
if not hmac.compare_digest(expected, received_hash):
return None # подпись не совпала — запрос подделан
if time.time() - int(data.get("auth_date", 0)) > max_age:
return None # данные устарели
return data
Если подпись верна, создайте или найдите игрока по его Telegram ID и передайте виджету токен сессии — виджет поддерживает работу с авторизованным пользователем и сообщает сайту о событиях: нужна авторизация, изменился купон, обновился баланс.
Шаг 4. Приём и расчёт ставок
Когда игрок подтверждает купон в виджете, ваш сервер проверяет баланс и создаёт ставку через услугу приёма и расчёта ставок SportAPI:
- Купон создаётся по указателям исходов из линии (
oc_pointer), а система проверяет, что исходы открыты и коэффициенты не изменились. - После матча система сама рассчитывает каждую ставку: выигрыш, проигрыш, возврат, половинные исходы.
- Итог приходит на ваш сервер через callback расчёта — вы начисляете выигрыш на баланс игрока.
- Бот отправляет игроку сообщение: «Ваша ставка выиграла, +190 на баланс».
Так вы не пишете ни интерфейс линии, ни правила расчёта рынков — только учёт игроков и денег.
Уведомления, которые возвращают игроков
- Матч начинается — по ставкам игрока и избранным командам.
- Ставка рассчитана — сразу после callback, с суммой выигрыша.
- Коэффициент изменился — если игрок следит за матчем.
Не злоупотребляйте рассылками: лучше 2–3 полезных сообщения в день, чем десятки рекламных.
Лицензия, платежи и правила платформы
Приём ставок требует лицензии в юрисдикции, где вы работаете, проверки возраста и личности игроков и платёжной инфраструктуры. Кроме того, у Telegram есть собственные правила для Mini App и платежей внутри мессенджера — изучите их до запуска. SportAPI даёт интерфейс, данные и расчёт ставок, но не выдаёт лицензий и не ведёт кошельки игроков.
Сколько стоит
| Что нужно | Стоимость |
|---|---|
| Спортивная линия, prematch и live по одному виду спорта | от $30 в месяц |
| Приём и расчёт ставок | от $300 в месяц |
| Спортбук-виджет | Условия подключения — у менеджера |
| Букмекерская платформа целиком | Разработка под ключ, по запросу |
| Проверка до оплаты | Тестовый ключ на 2 дня, все виды спорта |
Ошибки при запуске
- Доверие к данным пользователя без проверки подписи. Подделать
initDataна клиенте просто — проверяйте её только на сервере. - Ключи API на странице. Ключ SportAPI и данные для расчёта ставок хранятся только на сервере.
- Интерфейс для компьютера. Mini App открывается на телефоне — проверяйте каждый экран на мобильном.
- Запуск без лицензии и правил платформы. Решайте юридические вопросы до первого пользователя.
- Спам-рассылки. Игроки быстро блокируют бота, который присылает слишком много сообщений.
Частые вопросы
Можно ли сделать букмекера в Telegram без сайта?
Да. Mini App — это веб-страница, которую Telegram открывает внутри мессенджера. Отдельный сайт для игроков не нужен, но сервер для учёта пользователей и ставок нужен всё равно.
Нужно ли писать интерфейс линии с нуля?
Нет. Спортбук-виджет SportAPI уже содержит линию, live, рынки и купон и встраивается на страницу Mini App.
Как пользователь входит в приложение?
Через свой аккаунт Telegram: приложение получает подписанные данные пользователя, ваш сервер проверяет подпись и создаёт сессию.
Кто рассчитывает ставки?
Услуга приёма и расчёта ставок SportAPI: она проверяет коэффициенты при приёме, рассчитывает ставки после матча и присылает итог на ваш сервер.
Можно ли заказать всё под ключ?
Да. SportAPI разрабатывает букмекерские платформы под ключ — от интерфейса до бэк-офиса и интеграций. Обсудите проект с менеджером.
Что сделать сегодня
- Создайте бота и опубликуйте пустую страницу Mini App.
- Запросите у менеджера тестовый доступ и код спортбук-виджета.
- Подключите вход через Telegram с проверкой
initData. - Подключите приём и расчёт ставок и уведомления о выигрышах.
- Проверьте приложение на нескольких телефонах внутри Telegram.
Напишите менеджеру SportAPI в Telegram, что вы хотите запустить в Mini App, — вы получите тестовый доступ к линии, код виджета или предложение по разработке под ключ.