SunBlazeВойти
Настройки

Платформы • Telegram

Пошагово: бот в @BotFather, токен в Sunblaze, проверка. Webhook и кнопку «Открыть магазин» в меню бота Sunblaze ставит сам.

Открыть в кабинете →← К обзору

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

Telegram на телефоне или компьютере — в нём вы создадите бота через официального бота Telegram @BotFather.

Доступ к кабинету Sunblaze с правом настраивать магазин.

Около 10 минут. Из Telegram в Sunblaze переносится только токен бота: адрес витрины и кнопку «Открыть магазин» Sunblaze настроит сам.

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

Важно

Токен — ключ от бота: кто его знает, тот управляет ботом. Не публикуйте его и не пересылайте в чаты. Если токен попал к посторонним, в @BotFather откройте /mybots → бот → API Token → Revoke current token и вставьте новый токен в Sunblaze.

  1. Откройте @BotFather
    В Telegram найдите @BotFather (с синей галочкой) или откройте t.me/BotFather и нажмите «Запустить».
  2. Отправьте команду /newbot
    BotFather спросит название бота — его покупатели видят в шапке чата, например «Магазин Ромашка». Затем — адрес (username): латиница, цифры и подчёркивание, в конце обязательно bot, например romashka_shop_bot.
  3. Скопируйте токен
    BotFather пришлёт сообщение со строкой вида 123456789:AAH4kD… — это токен доступа к боту. Скопируйте его целиком, от цифр до последнего символа. Если бот уже есть: /mybots → ваш бот → API Token.

Шаг 2. Вставьте токен в Sunblaze

  1. Откройте «Каналы продаж»
    Кабинет Sunblaze: «Витрина → Каналы продаж» (в прежнем меню — «Настройки → Платформы»). Нажмите строку Telegram.
  2. Вставьте токен в поле «Токен доступа бота Telegram»
    Остальные поля можно не менять. Если вставленное не похоже на токен, окно предупредит.
  3. Нажмите «Подключить»
    Sunblaze проверит токен в Telegram. Если окно пишет «Telegram не узнал этот токен бота», скопируйте токен в @BotFather заново.

Что Sunblaze сделает сам

Сразу после подключения бот начнёт получать сообщения покупателей, а в меню бота появится кнопка «Открыть магазин» — она открывает вашу витрину внутри Telegram. На команду /start бот тоже отвечает кнопкой магазина.

Дальше Sunblaze каждые полчаса проверяет бота и показывает результат в столбце «Состояние» таблицы «Каналы продаж»: «Работает», «Токен не принят» (токен отозвали или заменили в @BotFather) или «Не доставляет». Когда токен перестаёт приниматься, на почту владельца приходит письмо. Проверить сразу можно кнопкой «Проверить сейчас» в окне Telegram.

Ставить кнопку меню вручную в @BotFather не нужно. Если у бота уже есть кнопка на другой сайт, Sunblaze её не трогает без вашего согласия: в окне Telegram в «Каналах продаж» появится «Заменить на кнопку магазина», а на «Главной» — пункт «Кнопка магазина в боте».

Шаг 3. Проверьте

  1. Откройте бота
    Откройте своего бота в Telegram (t.me/адрес_бота) и нажмите «Открыть магазин» слева от поля ввода. Должна открыться витрина.
  2. Сделайте тестовый заказ
    Положите товар в корзину и оформите заказ — он появится в кабинете в «Заказах». Покупатель входит по email и паролю: так требует 149-ФЗ.

Поля в окне подключения

Поле в окне SunblazeЧто вводить и где взятьОбязательно
Токен доступа бота TelegramТокен из @BotFather: /newbot или /mybots → бот → API Token. Вид — 123456789:AAH4kD…, целиком.Да — при подключении. Потом пустое поле значит «оставить прежний»
Вход покупателей в мини-приложение Telegram«По email и паролю» — так требует 149-ФЗ. Другой режим — только для тестового стенда.Нет
Вход на компьютере по QR-коду из TelegramПокупатель, уже вошедший в мини-приложении, входит на сайте магазина по QR-коду. Выключите, если не нужно.Нет
Ссылка для подключенияЗаполняется сама: https://t.sbaps.ru/?token=… Нужна, только если вы настраиваете Main Mini App в @BotFather.Нет — только чтение
Канал работаетВыключите, чтобы временно закрыть канал: покупатели не входят, бот не отвечает, а ссылка, QR-коды и токен остаются. Включите — и всё откроется по прежним ссылкам. «Отключить» в таблице, в отличие от этого, удаляет подключение, и ссылка при повторном подключении другая.Нет — по умолчанию включено
Служебный токен SunblazeСлужебный идентификатор подключения. Никуда вводить не нужно — в кабинет платформы вставляется ссылка.Нет — только чтение

Частые ошибки

  1. «Telegram не узнал этот токен бота»
    Токен скопирован не целиком или перевыпущен в @BotFather. Скопируйте его заново и вставьте без пробелов.
  2. «Этот бот уже подключён к магазину другого владельца»
    Один бот работает с магазинами одного владельца. Создайте для этого магазина отдельного бота в @BotFather (/newbot) и вставьте его токен.
  3. В столбце «Состояние» — «Токен не принят»
    Токен отозвали или заменили в @BotFather (/mybots → бот → API Token). Скопируйте актуальный токен, вставьте в окне Telegram и нажмите «Сохранить», затем «Проверить сейчас». Пока токен не заменён, ответы продавца и уведомления покупателям не доходят.
  4. В столбце «Состояние» — «Не доставляет»
    Telegram не может передать сообщения в магазин. Нажмите «Проверить сейчас»; если ошибка не уходит в течение часа, напишите в поддержку.
  5. Нужно ненадолго закрыть канал
    Откройте строку платформы и выключите «Канал работает» (или «Приостановить» в меню строки). Покупатели не входят, бот не отвечает, но ссылка, QR-коды и токен остаются — включите обратно, и всё работает по прежним ссылкам. «Отключить» удаляет подключение: ссылка при повторном подключении другая, и её придётся заменить везде, где она вставлена.
  6. Как проверить, что бот и ссылка работают
    В окне платформы нажмите «Отправить тестовое сообщение себе»: бот напишет вам с кнопкой «Открыть магазин». Нужен привязанный к кабинету аккаунт мессенджера и нажатый у бота «Старт». Пришло сообщение и кнопка открывает магазин — токен, чат и ссылка запуска в порядке.
  7. Покупатель прислал фото или файл
    Бот читает только текст. Подпись к фото попадает в чат как сообщение с пометкой о вложении, а покупателю бот один раз отвечает, что вложения не принимает и надо написать словами. Сами файлы пока не сохраняются.
  8. «Не удалось проверить токен в Telegram»
    Telegram не ответил, токен не сохранён. Повторите через минуту.
  9. QR-код или кнопка «Открыть» в уведомлении открывают только чат с ботом
    Эти ссылки вида t.me/бот?startapp=… рассчитаны на главное мини-приложение бота. Включите его: @BotFather → /mybots → бот → Bot Settings → Configure Mini App → Main Mini App, укажите «Ссылку для подключения». Проверьте на телефоне: откройте QR-код из окна Telegram в «Каналах продаж».
  10. Магазин просит открыть его заново
    Данные запуска из Telegram действуют ограниченное время (по умолчанию сутки). Если мини-приложение долго лежало открытым и вход не прошёл, покупателю показывается подсказка: закрыть магазин и открыть его заново.
  11. В боте нет кнопки «Открыть магазин»
    Откройте строку Telegram в «Каналах продаж»: там видно состояние кнопки. «В меню бота кнопка на другой сайт» — нажмите «Заменить на кнопку магазина». Если вы управляете кнопкой сами, поставьте её в @BotFather (Bot Settings → Menu Button) с «Ссылкой для подключения».

Необязательные настройки в @BotFather

  1. Экран загрузки
    /mybots → бот → Bot Settings → Configure Mini App: иконка и цвета светлой и тёмной темы, которые Telegram показывает, пока открывается витрина. Используйте логотип и цвета магазина.
  2. Главное мини-приложение (Main Mini App)
    Там же можно включить главное мини-приложение с «Ссылкой для подключения»: в профиле бота появится кнопка открытия, а бот — во вкладке «Приложения» поиска Telegram. Telegram просит загрузить превью — скриншоты или видео.
  3. Поиск товаров через @бота
    Bot Settings → Inline Mode → Turn on: покупатели смогут набрать @адрес_бота и название товара в любом чате. После включения откройте строку Telegram в «Каналах продаж» и нажмите «Сохранить».

Перед заявкой в каталог Telegram

  1. Ссылка работает
    Витрина открывается из бота и по «Ссылке для подключения» в браузере.
  2. Экран загрузки
    Заданы иконка и цвета (см. выше).
  3. Покупка проходит
    Каталог → корзина → оформление → оплата проходят без ошибок.
  4. Уведомления
    После заказа покупатель получает сообщение бота о статусе.
  5. Звёзды Telegram
    За физические товары Telegram Stars не принимаются — не указывайте их способом оплаты в заявке.

Инструкция сверена с документацией платформы и кабинетом Sunblaze 11 октября 2026 года. Если экраны платформы выглядят иначе, ищите те же названия разделов и полей — они меняются редко.