Главная · Блог · Оплата в Telegram Stars в чат-боте: как продавать курсы и консультации
Оплата в Telegram Stars в чат-боте: как продавать курсы и консультации
Бот ЧБТ умеет принимать оплату в Telegram Stars — внутренней валюте Telegram. Она нужна, если вы продаёте в Telegram цифровое: онлайн-курс, консультацию по видео, доступ в закрытый канал, файл. Ниже — зачем Telegram требует звёзды, как настроить оплату в сценарии, что получает продавец и чего в этой схеме нет.
Почему цифровое в Telegram продают за звёзды
Telegram требует, чтобы цифровые товары и услуги в ботах и мини-приложениях оплачивались в Telegram Stars — правила описаны в документации Telegram для ботов. К цифровому относятся курсы и уроки, онлайн-консультации, подписки на закрытый контент, файлы и доступы.
Физические товары и офлайн-услуги — доставку, стрижку, ремонт — по-прежнему оплачивают через вашу кассу: в блоке «Оплата» для этого есть Продамус, ЮKassa и CloudPayments.
Как покупатель платит звёздами
- Бот присылает в чат счёт: название, описание и сумму в звёздах.
- Покупатель нажимает кнопку оплаты и подтверждает её в окне Telegram. Если звёзд не хватает, Telegram предложит их пополнить.
- После оплаты бот продолжает сценарий: выдаёт ссылку на урок, ставит тег, передаёт заявку менеджеру.
Всё происходит внутри Telegram — без перехода на страницу кассы и без ввода карты в боте.
Как настроить оплату звёздами в сценарии
- Подключите Telegram-бота в «Каналах»: звёзды будут приходить на баланс именно этого бота.
- В сценарии добавьте блок «Оплата» — он есть и в «Шагах», и в «Холсте», на любом тарифе.
- В поле «Касса» выберите «Telegram Stars», укажите сумму — целое число звёзд от 1 до 10 000 — и описание: его покупатель увидит в счёте.
- На выход «Оплачено» поставьте то, что получает покупатель: сообщение со ссылкой на материал, тег (например,
курс-оплачен), действие «Сделка в CRM» на этапе «Оплачено». - Подключите и выход «Ошибка»: туда сценарий уходит, если счёт не удалось отправить.
Звёзды работают только в Telegram. Если тот же сценарий запущен в MAX, ВКонтакте или в чате на сайте, шаг со звёздами уйдёт в «Ошибку» — поставьте перед ним «Условие» по полю «Канал» и для остальных каналов дайте блок «Оплата» с вашей кассой.
Цифровые товары в магазине бота
Если у вас магазин в боте, отметьте у товара «Цифровой товар» и задайте «Цену в звёздах». В мини-приложении Telegram у него появится кнопка «Купить за N ★»: заказ на одну позицию, без корзины и доставки, оплата окном Telegram прямо в витрине. Неоплаченный заказ ждёт 15 минут, оплаченный приходит в «Заказы» как обычный, сделка — в CRM.
Вернуть звёзды по заказу можно только целиком — кнопкой «Вернуть всё» в карточке заказа; если покупатель оплатил заказ дважды, вторая оплата вернётся автоматически. Вне Telegram такой товар продаётся за рубли через кассу, если у него задана цена магазина. Подробнее — в справке «Магазин в боте».
Что получает продавец
Звёзды приходят на баланс вашего бота в Telegram — у каждого продавца свой бот, ЧБТ денег не касается и процента с оплат не берёт. Вывести звёзды можно через платформу Fragment в криптовалюте TON. Telegram сообщает, что заработанные звёзды становятся доступны к выводу примерно через 21 день; курс, комиссии и минимальную сумму вывода устанавливают Telegram и Fragment — сверяйтесь с их условиями.
Учитывайте это в цене: звёзды не приходят рублями на расчётный счёт, и между оплатой и выводом проходит время.
Звёзды или ссылка на кассу: что выбрать
| Telegram Stars | Ссылка на вашу кассу | |
|---|---|---|
| Где работает | Только Telegram | Telegram, MAX, ВКонтакте и чат на сайте |
| Что продавать | Цифровое: курсы, консультации онлайн, доступы, файлы | Физические товары и офлайн-услуги; цифровое — вне Telegram |
| Где платит покупатель | В окне Telegram, не выходя из чата | На странице Продамуса, ЮKassa или CloudPayments |
| Куда приходят деньги | Звёзды — на баланс вашего бота | Рубли — на ваш счёт в кассе |
| Чек 54-ФЗ | Нет | Пробивает ваша касса |
| Возврат | Только целиком | По правилам кассы |
| Что нужно подключить | Только Telegram-бота | Кассу в разделе «Приём оплаты» |
Частая схема — обе кассы в одном сценарии: в Telegram курс продаётся за звёзды, а тем, кто пришёл из MAX, ВКонтакте или с сайта, бот присылает ссылку на кассу.
Как назначить цену в звёздах
Сумма в блоке — целое число звёзд, без копеек и валюты. Курса звезды к рублю ЧБТ не показывает и не пересчитывает: покупатель платит ровно столько звёзд, сколько вы указали.
- Посмотрите, сколько стоит пакет звёзд для покупателя в вашем Telegram, и прикиньте, во сколько ему обойдётся покупка.
- Заложите, что выводить звёзды вы будете через Fragment и не сразу: итоговая сумма у вас будет зависеть от условий Telegram и Fragment на момент вывода.
- Круглые цены — 100, 250, 500 звёзд — проще воспринимаются в счёте.
- Одна и та же услуга может стоить в звёздах и в рублях по-разному: в сценарии это два отдельных блока «Оплата».
Возвраты, чеки и чего нет
- Чека 54-ФЗ нет. Звёзды — не платёж через кассу, чек за них ЧБТ не пробивает. Если нужен чек, принимайте оплату вне Telegram — например, на сайте через вашу кассу.
- Возврат — только целиком. Telegram возвращает звёзды за платёж полностью, частичного возврата нет.
- Только Telegram. В MAX, ВКонтакте и на сайте звёзд нет.
- Оплаты картой внутри Telegram (Telegram Payments) нет. Внутри Telegram — только звёзды, рубли — по ссылке на вашу кассу.
- Криптовалюту ЧБТ не принимает и не планирует.
Сценарий для онлайн-школы: урок после оплаты
Пример цепочки для курса в Telegram:
- «Сообщение» с описанием курса и кнопкой «Купить за 500 ★».
- Блок «Оплата» с кассой «Telegram Stars» и суммой 500.
- Выход «Оплачено»: «Действие» → «Добавить тег»
курс-оплачени «Сделка в CRM» на этапе «Оплачено», затем «Сообщение» со ссылкой на первый урок. - Выход «Ошибка»: «Сообщение» «Не получилось выставить счёт — напишите нам» и блок «Оператор».
Следующие уроки выдавайте по тегу: «Условие» проверяет курс-оплачен и даёт ссылку только оплатившим. Подробнее о воронке для школы — на странице бота для онлайн-школы.
Ещё два сценария: консультация и закрытый доступ
Онлайн-консультация. «Сбор данных» спрашивает тему и удобное время текстом, затем блок «Оплата» выставляет счёт в звёздах. На выходе «Оплачено» — «Сделка в CRM» с названием вроде «Консультация: {{name}}» и «Уведомить оператора»: специалист видит оплаченную заявку и подтверждает время в «Диалогах». Сам бот время не бронирует — это заявка, как и в остальных сценариях записи.
Доступ в закрытый канал или к файлу. После оплаты бот присылает сообщение со ссылкой: приглашение в канал, ссылку на облако с материалами или на страницу курса. Ссылку вы заранее вписываете в текст сообщения. Если ссылка общая для всех, её можно переслать — для ценного контента используйте платформу, которая выдаёт личный доступ, а бот пусть ведёт на неё.
Чек-лист перед запуском
- Telegram-бот подключён в «Каналах», и это тот бот, на баланс которого вы хотите получать звёзды.
- В блоке «Оплата» выбрана касса «Telegram Stars», сумма — целое число от 1 до 10 000, описание понятно без контекста: его покупатель увидит в счёте.
- Подключены оба выхода — «Оплачено» и «Ошибка».
- Для MAX, ВКонтакте и сайта есть отдельная ветка с вашей кассой или хотя бы сообщение, как оплатить.
- В «Проверить сценарий» счёт в звёздах не выставляется — тест-чат покажет, что шаг ушёл в «Ошибку». Проверьте оплату в настоящем Telegram на небольшой сумме.
- Вы знаете, как будете выводить звёзды и учитывать этот доход.
Редактор сценариевБот для онлайн-школыЧат-бот для TelegramTelegram-бот для бизнесаМагазин в боте