От идеи до работающего бота.

Быстрый старт

Для первого запуска нужен свой Telegram-бот, созданный через @BotFather. Не публикуйте токен бота в чатах или документах.

Что где находится в кабинете

Сначала выберите бота в верхней панели, затем откройте «Магазин». Переходы между каталогом, комплектами, поставщиками и подписками сохраняют выбранного бота. Направление «Цифровые товары» или «Товары и услуги» меняет разделы кабинета, но само по себе не включает продажи.

Готовые шаблоны магазинов

При подключении бота или создании сценария выберите тип шаблона «Готовые магазины». В мобильном кабинете они собраны в одноимённую группу. Для товаров выберите один формат: кнопки в чате или Mini App.

Сценарии и блоки

Сценарий — это цепочка действий бота. На схеме соединяйте выходы блоков с нужными следующими шагами; незавершённые ветки могут остановить диалог.

Блоки «Запросить контакт» и «Запросить геолокацию» показывают нативную кнопку Telegram в личном чате; результат сохраняется в переменную. «Условие по подписчику» разветвляет сценарий по тегу, пользовательскому полю или числу и сумме подтверждённых покупок. Для покупок выберите валюту и период; демо-заказы и неоплаченные счета не учитываются. В симуляторе сведения реального подписчика не загружаются — обе ветки можно проверить вручную.

Перед публикацией проверьте каждую ветку, в том числе пустой ввод, ошибку внешнего действия и повторный /start.

Цифровой магазин

Для магазина с кнопками используйте шаблон и опубликованные блоки: каталог → категория → товар → заказ → выдача. Для режима Mini App настройте и опубликуйте витрину. Категории и товары находятся в группе «Каталог» выбранного магазина, в отдельных разделах «Категории» и «Товары»; режим покупки выбирается в «Обзоре».

Кнопки бота или витрина Mini App

В «Обзоре» магазина выберите один формат покупки. Не нужно собирать для покупателя два конкурирующих пути оформления.

Сначала сохраните черновик, проверьте покупательский путь и отдельно опубликуйте оформление. Черновик не виден покупателям, а публикация дизайна не переключает формат покупки. Перед запуском проверьте выбранный режим, каталог, условия и контакт поддержки.

Физические товары и услуги

В «Магазине» выберите направление «Товары и услуги». Создайте категории, товары или услуги, их варианты и цены. Для физического товара настройте остатки и получение заказа; для услуги — длительность и расписание.

Корзина в чате бота

В карточке физического товара нажмите «Добавить в корзину», выберите вариант и количество. Откройте «Корзину» в каталоге или командой /shopcart. Можно собрать до 20 единиц, изменить количество, удалить товары и ввести рублёвый промокод. На доставку скидка не распространяется. Для оплаты Stars уберите рублёвый промокод. Запись на услугу оформляется отдельно.

Перед подтверждением покупатель видит все позиции, скидку, получение и итог. Резерв создаётся вместе с заказом. Корзина сохраняется до 30 дней; отмена ввода контактов её не очищает. После создания заказа продолжайте оплату по его кнопке статуса, чтобы не оформлять покупку повторно. В режиме Mini App чатовая корзина не открывается.

Цифровые товары и доступы внутри Telegram должны оплачиваться Stars согласно правилам платежей Telegram. Возвраты через внешние кассы продавец выполняет в кабинете провайдера.

Подключение HOT Pay

Откройте «Магазины → нужный магазин → Способы оплаты → HOT Pay». Добавьте рабочий API-ключ своей кассы, её UUID и секрет подписи Production webhook. Выберите один из методов, активных в вашей кассе; метод не включается автоматически.

В кабинете HOT Pay укажите адрес уведомлений, показанный мастером. «Проверить без списания денег» проверяет доступ к API, но не подтверждает кассу и доставку уведомлений. После подготовки реквизитов и чеков нажмите «Настройки готовы», затем явно включите показ покупателям. Реальную контрольную оплату выполняет владелец магазина.

Прерванную оплату возобновляйте из заказа: Botnest восстановит ссылку на тот же платёж. Возврат на сайт сам по себе не подтверждает оплату. Внешние денежные возвраты выполняются продавцом в кабинете провайдера; автоматических списаний за продление нет. Для цифровых продаж внутри Telegram действуют правила Telegram, которые необходимо учитывать при выборе метода.

Если способ временно отключён платформой, мастер покажет это отдельно. Реквизиты сохранятся, новые заказы через него будут недоступны, подтверждения уже начатых оплат продолжат обрабатываться. Оплата тарифа самого Botnest и кассы магазинов — разные настройки.

Платные подписки и доступы

Отдельный бот не нужен: в разделе «Магазин → Подписки и доступы» подключите закрытый Telegram-канал к существующему боту. Бот должен быть администратором с правами приглашать и удалять участников. У канала не должно быть публичного username. Для подключения укажите его числовой ID, начинающийся с −100.

Создайте тариф: название, описание, условия покупки и возврата, контакт поддержки, цену в Stars и/или рублях, срок от 1 до 365 дней и напоминание перед окончанием. Для оплаты в рублях сначала подключите и включите проверенную кассу продавца. Новый тариф скрыт, пока вы явно не включите его. Один тариф открывает один канал; в одном боте можно продавать несколько тарифов.

Покупатель выбирает доступный способ оплаты. Для Stars Telegram открывает счёт, для рублей — защищённую форму выбранной кассы. Доступ не выдаётся по нажатию кнопки или возврату со страницы оплаты: сервер ждёт подписанное уведомление либо сам проверяет платёж у провайдера.

После подтверждённой оплаты покупатель получает ссылку с заявкой на вступление. Бот одобряет только Telegram ID владельца действующей подписки: пересланная ссылка не даёт доступ другому человеку. Ссылка действует не более суток; новую можно запросить через /subscriptions или раздел подписок в профиле Mini App.

Продление покупается вручную: активный срок увеличивается, законченный начинается заново. Автоматических списаний нет. После окончания бот удаляет участника; после новой покупки вход снова доступен. В Mini App выбор и оплата происходят в витрине, а ссылка на вход приходит в личный чат бота.

В кабинете продавца отдельно показаны тарифы, подписчики и последние платежи за доступ. Можно вручную добавить дни или отозвать доступ с указанием причины. Отзыв не возвращает деньги. Возврат Stars — отдельное действие с подтверждением; он отменяет только срок, купленный возвращённым платежом. Рублёвый возврат продавец выполняет самостоятельно в кабинете кассы.

Тариф Botnest и платежи покупателей

Это разные вещи: тариф оплачивает доступ продавца к сервису, а покупатели оплачивают товары и доступы в его боте.

Актуальные цены и ограничения смотрите в сравнении тарифов или в «Настройках → Тариф и оплата». На главной, странице сервиса и в кабинете показаны данные действующих настроек тарифов. Ограничения относятся к рабочему пространству: боты, активные подписчики, сообщения, рассылки, файлы и участники команды.

Сравнивайте не только число ботов. В таблице отдельно указаны уровень статистики, реклама Botnest, A/B-тесты рассылок, отчёты по расписанию, интеграции и приоритетная поддержка. Если возможность отсутствует в выбранном тарифе, её наличие в описании сервиса не означает включение для этого тарифа.

«Без тарифного лимита» не отменяет ограничений Telegram, согласий покупателей и правил безопасной отправки сообщений. Доступные способы оплаты тарифа и окончательная сумма показываются в кабинете перед подтверждением счёта.

Перенос цифрового каталога

«Экспорт CSV без кодов» сохраняет карточки, цены, платформу, регион и инструкции активации. Это не копия запаса: уникальные коды и содержимое уже оплаченных заказов в CSV не попадают.

Для пополнения нескольких существующих уникальных товаров откройте «Товары → Пополнить коды сразу у нескольких товаров». Загрузите CSV/TSV или вставьте два столбца «SKU» и «Код», один код в строке. Перед подтверждением вы увидите количество новых кодов, повторов и будущий остаток — без значений ключей. Ошибка в одном SKU блокирует всю пачку. История загрузок позволяет отменить ошибочную пачку только после остановки продаж и только пока ни один её код не использован; удаление необратимо.

Владелец или администратор может отдельно скачать свободные коды уникального товара из формы «Изменить товар → Резервная копия свободных кодов». Для этого нужно приостановить продажи, дождаться завершения заказов, ожидающих оплату, и повторно подтвердить пароль и 2FA. JSON содержит точные значения только ещё не закреплённых за заказами кодов; действие записывается в журнал.

Промокоды и продажи цифрового магазина

Во вкладке «Промокоды» создайте код со скидкой в процентах или Stars. Можно задать срок действия, общий лимит, лимит на покупателя и отдельный товар. Новый код выключен: проверьте условия и включите его вручную. Для остановки акции выключите код; уже оплаченные заказы сохраняют исходную цену.

Покупатель вводит код в витрине Mini App или отправляет боту /promo КОД. Перед оплатой он видит итоговую цену в Stars. Если код устарел, лимит закончился или условия изменились, покупатель должен открыть товар заново — старое предложение не выставит счёт с другой ценой. Команда /promo off отключает скидки на 24 часа, /promo auto возвращает автоматическую персональную скидку.

Во вкладке «Аналитика» доступны оплаченные заказы, покупатели, суммы в Stars, возвраты, продажи по товарам, скидки, результат собственных промокодов и первые оплаченные покупки приглашённых за выбранный период. Показатели считаются по дате оплаты в UTC; неоплаченные заявки в выручку не входят. Возвращённые заказы исключаются из чистой выручки, скидок и результата акций. Сумма Stars по приглашениям относится к первым покупкам приглашённых, а не ко всем их будущим заказам.

«Путь покупателя» показывает уникальных людей, открывших товар и отметивших согласие в боте или Mini App, затем создавших заказ, оплативших его, получивших товар и оставивших оценку. Каждый шаг считается по собственной дате события в UTC; это не одна когорта покупателей и не процент конверсии. Просмотры до включения этого измерения восстановить нельзя; наблюдения хранятся до 365 дней с учётом законной блокировки удаления.

Приглашения покупателей

Во вкладке «Приглашения» владелец задаёт скидку приглашённому и пригласившему, а также срок проверки перед выдачей награды. Механизм по умолчанию выключен. После включения покупатель получает персональную ссылку через кнопку меню или команду /referral. Ссылка работает только для другого Telegram-пользователя, который ещё не покупал в этом цифровом магазине; первое подтверждённое приглашение закрепляется за ним.

Приглашённый получает персональную скидку на первую подходящую покупку. После подтверждённой оплаты и выдачи пригласивший получает одноразовую скидку для себя; по умолчанию она становится доступна через 7 дней. Если исходную покупку возвращают, будущая награда отключается. Уже выставленный счёт и ранее использованную скидку нельзя задним числом изменить. Реферальные скидки не суммируются с другими промокодами и не являются денежным балансом.

Выключение приглашений останавливает новые ссылки и атрибуцию, но не отменяет скидки, уже обещанные существующим участникам. Для проверки результата используйте сводку приглашений и заказы магазина.

Подписчики и сегменты

На странице «Подписчики» выберите одного бота или «Все боты». В общей сводке один Telegram ID показывается один раз; сведения отдельного бота остаются в его карточке. Поиск, источники, статусы и сохранённые сегменты помогают выделить нужную аудиторию.

Сегменты пересчитываются по правилам. Доступны теги, поля и метрики покупок, в том числе период. Перед массовой отправкой проверьте состав сегмента. CSV-импорт сначала показывает предпросмотр; после подтверждения проверьте число добавленных и обновлённых записей.

Рассылки

Создайте кампанию, выберите бота и аудиторию, подготовьте текст, медиа и кнопки. До запуска рассчитайте получателей и отправьте тест себе. Затем запустите сразу или задайте дату, время и часовой пояс. В отчёте доступны доставленные, исключённые и неуспешные сообщения.

Аналитика и доставка

В аналитике выберите «Все боты» или конкретного бота и сценарий, затем период 7, 30 или 90 дней. Карточки главной показывают общие показатели: активные подписчики — люди, общавшиеся с подключёнными ботами за 30 дней; прохождения и конверсия — запуски сценариев и доля завершений в указанный на карточке период. Один Telegram ID в общем числе людей учитывается один раз. Детальная воронка доступна после выбора сценария.

«Журнал доставки» показывает технические результаты отправки, не раскрывая содержимое чужих сообщений.

Если данные не появились сразу, дайте событию обработаться и проверьте правильность выбранного бота и периода.

В «Магазин → Продажи» цифрового магазина есть «Себестоимость и расчётная маржа». Укажите стоимость единицы товара в рублях; для комплекта складываются затраты компонентов. Сумма фиксируется при создании нового заказа, а старые заказы без себестоимости остаются неизвестными. Нулевую стоимость указывайте только для действительно бесплатного содержимого.

Выручка остаётся в Stars. Рублёвая маржа — оценка по заданной продавцом стоимости одной Star, не курс или сумма вывода Telegram. Если хотя бы у одного оплаченного заказа нет себестоимости, общая маржа не показывается. Возвраты уменьшают выручку, но не отменяют автоматически расходы на уже закупленный товар. Комиссии, налоги и другие расходы в эту оценку не включены.

Источники продаж

Создайте ссылку-источник в разделе «Подписчики → Источники» и поделитесь ею там, где приглашаете покупателей. В аналитике цифрового магазина видно, сколько уникальных людей перешло по таким ссылкам за выбранный период, сколько из них затем оплатило заказ и сколько Stars осталось после подтверждённых возвратов.

Если человек открыл несколько ссылок-источников за период, отчёт относит его только к первой. Покупка засчитывается лишь после этого перехода и до конца периода. Покупки без перехода по ссылке-источнику в таблицу не входят. Это измерение первого перехода за период, а не полная рекламная атрибуция всех касаний; не складывайте его с общим числом продаж как независимую выручку.

Конверсия по товарам

В аналитике цифрового магазина блок «Конверсия по товарам» собирает когорту покупателей, впервые открывших конкретный товар в выбранный период. Покупатель и товар считаются один раз. Условия, заказ, подтверждённая оплата, выдача и оценка засчитываются только в этом порядке и до конца выбранного периода. Процент оплаты рассчитывается от числа открывших товар, а не от всех подписчиков.

Старые просмотры сохраняются в общем «Пути покупателя», но не входят в когорту: до обновления записывалась дата без точного времени, поэтому последовательность просмотра и оплаты в один день нельзя доказать. Для периода, который ещё не закончился, показатели могут вырасти по мере оплаты и выдачи; сравнивайте завершённые периоды. Возврат не стирает факт ранее состоявшейся оплаты и отдельно отражается в финансовой статистике.

Обновить существующие товары по SKU

Откройте «Магазины → цифровой магазин → Товары → Обновить по SKU». Загрузите CSV/TSV со столбцом SKU и нужными изменениями: название, описание, цена Stars, новые уникальные коды. Пустые ячейки оставляют прежние значения. До 100 товаров и 1000 кодов за пакет.

Сначала проверьте «было → станет», затем подтвердите сохранение. Запас пополняется, а не заменяется; повторные и уже выданные коды не добавляются заново. Коды в предпросмотре и истории не показываются. Категории, видимость, файлы и состав комплектов не меняются. Название варианта редактируется в редакторе вариантов.

Команда и безопасность

В «Настройки → Команда» назначайте коллегам только необходимые права. В профиле включите двухфакторную защиту и сохраните резервные коды вне браузера. Если токен бота раскрыт, перевыпустите его у @BotFather и замените в «Настройки → Telegram».

API-ключи и секреты Webhook показываются только при создании или замене. Выдавайте каждой внешней системе отдельный ключ с минимальными областями доступа; не вставляйте секреты в публичные страницы.

Корзина цифровых товаров

В настройках цифрового магазина включите корзину Mini App и выберите способ оплаты нескольких товаров. Быстрая покупка одного товара остаётся доступной. Формат магазина с кнопками в чате не меняется.

До 10 разных товаров и 20 единиц; количество увеличивается для уникальных товаров. Общий счёт Stars — до 10 000 Stars и 20 выдаваемых материалов, включая комплекты. Промокод Stars вводится прямо в корзине. Нажмите «Проверить скидку и итог», чтобы увидеть скидку на каждый товар до создания счетов. Проценты считаются от суммы подходящих товаров, фиксированная скидка применяется один раз и распределяется между ними целыми Stars. Минимум каждой единицы — 1 Star. Ручной код не складывается с персональной скидкой. Оба режима оплаты используют одинаковые правила: одна корзина занимает одно применение кода. Частичная отмена или возврат не освобождает применение, пока остаются активные или оплаченные заказы со скидкой. При оформлении сервер повторно проверяет цену и лимиты; ранее созданные счета не пересчитываются.

Кнопка заказа после покупки

Создайте дополнительный сценарий события заказа — например «Заказ оплачен» или «Заказ исполнен». Добавьте блок «Открыть витрину Mini App», выберите «Конкретный заказ» и «Заказ, запустивший сценарий». ID вручную не нужен: кнопка ведёт к заказу, вызвавшему событие, а не к последней покупке.

В цифровом магазине с кнопками заказ открывается в чате; в режиме Mini App — в карточке цифровой покупки. Для физических товаров и услуг открывается карточка их заказа в опубликованной Mini App. Магазины разных форматов не смешиваются. Покупатель видит только собственный заказ после проверки Telegram; сама кнопка не создаёт покупку, оплату или повторную выдачу.

Интеграции и API

Для CRM и аналитики доступен Public API только для чтения. В «Настройки → Интеграции» создаются ключи, исходящие Webhook, тестовые запросы и пакеты для n8n/Make. Полное описание запросов, лимитов, ошибок и подписи Webhook — на отдельной странице.

Частые вопросы