SportAPI
Букмекерские платформы

Букмекер в Telegram Mini App: как сделать приложение со ставками внутри мессенджера

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

Приложение со ставками на спорт, открытое внутри Telegram

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

  1. Создайте бота через BotFather.
  2. Опубликуйте страницу приложения по адресу с HTTPS — например, https://app.your-project.com.
  3. Привяжите её к боту как 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:

  1. Купон создаётся по указателям исходов из линии (oc_pointer), а система проверяет, что исходы открыты и коэффициенты не изменились.
  2. После матча система сама рассчитывает каждую ставку: выигрыш, проигрыш, возврат, половинные исходы.
  3. Итог приходит на ваш сервер через callback расчёта — вы начисляете выигрыш на баланс игрока.
  4. Бот отправляет игроку сообщение: «Ваша ставка выиграла, +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 разрабатывает букмекерские платформы под ключ — от интерфейса до бэк-офиса и интеграций. Обсудите проект с менеджером.

Что сделать сегодня

  1. Создайте бота и опубликуйте пустую страницу Mini App.
  2. Запросите у менеджера тестовый доступ и код спортбук-виджета.
  3. Подключите вход через Telegram с проверкой initData.
  4. Подключите приём и расчёт ставок и уведомления о выигрышах.
  5. Проверьте приложение на нескольких телефонах внутри Telegram.

Напишите менеджеру SportAPI в Telegram, что вы хотите запустить в Mini App, — вы получите тестовый доступ к линии, код виджета или предложение по разработке под ключ.

← Все статьи