Платформы • Telegram

Что понадобится

Аккаунт Telegram и доступ к @BotFather.

Права на настройку приложения в личном кабинете Sunblaze (раздел «Настройки → Платформы»).

Публичный HTTPS API Sunblaze (webhook бота регистрируется автоматически при сохранении токена).

Шаг 1. Создайте бота в BotFather

1. Создайте бота
   Откройте @BotFather → /newbot → укажите имя и username бота. Скопируйте токен вида 123456:ABC-DEF…
2. Подключите платформу в Sunblaze
   Личный кабинет → приложение → «Настройки → Платформы» → Telegram → вставьте токен бота и сохраните. После сохранения система зарегистрирует webhook и выдаст ссылку Mini App (вида https://t.sbaps.ru/?token=…).

Шаг 2. Привяжите Mini App к боту

1. Укажите URL Web App
   В BotFather: /mybots → ваш бот → Bot Settings → Menu Button / Configure Mini App → вставьте URL из поля «URL мини-приложения» в Sunblaze.
2. Проверьте запуск
   Откройте бота в Telegram и нажмите кнопку меню / Mini App. Витрина должна загрузиться; вход — по email (bind Telegram после авторизации).

Экран загрузки Mini App (брендинг)

Telegram показывает иконку и цвета при старте Mini App. Настройте их в BotFather — отдельного API для автоматизации пока нет.

1. Иконка и цвета
   BotFather → /mybots → ваш бот → Bot Settings → Configure Mini App → задайте иконку приложения и цвета фона для светлой и тёмной темы.
2. Рекомендации
   Используйте тот же логотип/палитру, что в витрине. Проверьте загрузку на iOS и Android: экран загрузки должен узнаваемо относиться к магазину, а не к «пустой» заглушке Telegram.

Inline-каталог (@бот в любом чате)

Покупатели могут набрать @ваш_бот и название товара — Telegram покажет карточки SKU со ссылкой в Mini App.

1. Включите Inline Mode
   BotFather → /mybots → ваш бот → Bot Settings → Inline Mode → Turn on. Без этого Telegram не присылает inline_query на webhook.
2. Пересохраните платформу (при необходимости)
   Если бот подключали раньше, откройте настройки Telegram в Sunblaze и сохраните ещё раз — webhook обновит allowed_updates (включая inline_query).
3. Проверка
   В любом чате наберите @username_бота и часть названия товара из каталога. Должна появиться карточка с кнопкой «Открыть в магазине».

Чеклист готовности к Telegram Apps Center

Ниже — технические требования к Mini App перед подачей листинга. Сама заявка, тексты и GTM — отдельный процесс (продуктовый рост / Apps Center listing); здесь только готовность канала.

1. Стабильный Mini App URL
   Работает HTTPS-ссылка из Sunblaze; домен бота/Web App совпадает с тем, что указано в BotFather.
2. Брендинг загрузки
   Заданы иконка и цвета light/dark (см. раздел выше).
3. Сценарий покупки
   Каталог → корзина → оформление → оплата (fiat Telegram Payments или редирект T-Bank/ЮKassa) проходят без критических ошибок на staging/prod-like.
4. Уведомления бота
   После заказа пользователь получает сообщение бота (статус/ссылка в Mini App), если канал уведомлений включён.
5. Stars eligibility (опционально)
   Telegram Stars в Sunblaze не используются для оплаты физических товаров. Для цифровых товаров/подписок Stars — отдельная опция (пока не включена по умолчанию). Не указывайте Stars как основной способ оплаты физтоваров в заявке.
6. Медиа для листинга
   Подготовьте скриншоты Mini App (каталог, карточка, чекаут) и короткое описание магазина — они понадобятся при подаче в Apps Center вне этой инструкции.

Полезные ссылки