Звезды Telegram: что это такое и как это работает с no-code

Идеальная платежная система уже здесь — Звезды Telegram! Рай для тех, кто работает с no-code, особенно если вы изначально создаете проекты на Directual. Децентрализованная, доступная и уже используется по всему миру. Настройте ее и зарабатывайте деньги — что может не понравиться?

Эта статья предназначена для тех, кто не знаком с темой или еще сомневается. Узнайте, что такое Звезды Telegram, как они интегрируются с мини-приложениями Telegram и как все это связано с no-code.

Что такое Звезды Telegram?

Ладно, перейдем к сути: сотни миллионов пользователей каждый месяц активно используют ботов и мини-приложения в Telegram. Они покупают вещи, получают услуги, играют в игры и так далее. С последним обновлением Telegram боты и мини-приложения могут продавать цифровые товары и услуги.

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

Звезды Telegram — это цифровые деньги, которые вы покупаете в приложении, а теперь они позволяют вам оплачивать цифровые товары. Вы можете получить эти звезды через сервисы Apple, Google или PremiumBot, а затем потратить их на любые цифровые товары.

Звезды не нарушают правил Apple и Google, поэтому разработчики и пользователи получают более легкий доступ к покупкам в приложениях прямо со своих телефонов. Кроме того, разработчики скоро смогут обналичивать свои звезды за тонкоины через Fragment.

Попробуйте сами: @directual_stars_bot — это бот, с помощью которого вы можете поддержать команду Directual! Ниже мы раскроем детали его работы на нашей платформе.

Вот несколько фактов о том, почему стоит использовать Звезды Telegram:

• Если вы покупаете физические товары, то все остается как было с привычными методами оплаты Telegram.
• Простые и быстрые платежи — теперь больше типов бизнеса могут присоединиться к Telegram и охватить целых 900 миллионов потенциальных клиентов.
• Telegram планирует добавить новые функции, такие как подарки для создателей контента.

А вот информация о ценах:

Все это можно объединить с no-code с помощью Directual. Даже если вы не умеете программировать, вы сможете интегрировать платежную систему Telegram, а также создать ботов и мини-приложения на Directual и запустить их в Telegram. Больше охват, больше продаж и меньше хлопот — что может быть лучше?

Как работает API?

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

Краткое описание:

Платежи в Telegram заложены прямо в приложения, поэтому вы можете обменивать цифровые товары и услуги на звезды Telegram, которые впоследствии можно превратить в вознаграждения.

Как это работает:

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

Счета сопровождаются фотографией, описанием и большой кнопкой «Оплатить». Нажатие на эту кнопку открывает специальный экран для оплаты прямо в приложении.

Поскольку все происходит в цифровом формате, все транзакции осуществляются через звезды Telegram. Пользователи покупают звезды через обычные внутриигровые покупки или с помощью @PremiumBot, а затем используют их для приобретения цифровых товаров.

Процесс оплаты проходит очень гладко — не требуется вводить личные данные, такие как полные имена, адреса или номера кредитных карт.

Шаг за шагом, как это описано в официальной документации Telegram.

Чтобы начать принимать платежи, вам нужен Telegram-бот. Создайте его с помощью @BotFather, если вы ещё этого не сделали.

В общем, вот что вам предстоит делать:

• Отправьте счет с помощью sendInvoice (валюта: «XTR»)
• Дождитесь апдейта с предзапросом pre_checkout_query
• Одобрите или отклоните покупку с помощью answerPreCheckoutQuery
• Дождитесь следующего апдейста с успешным платежом successful_payment
• Сохраните telegram_payment_charge_id из объекта SuccessfulPayment — он может понадобиться для возвратов
• Передайте пользователю цифровые товары или услуги, которые он купил

Примечание: для цифровых товаров вам не нужен provider_token. Это требуется только для физических товаров.

Можно также экспериментировать с платежами в звездах Telegram, используя тестовую среду Telegram. Убедитесь, что вы выбираете правильные параметры в зависимости от того, что вы продаете.

1. Создание счета: пользователь обращается к @yourbotname (для примера, не настоящее имя), желая что-то купить. Ваш бот готовит счет с указанием товара и его стоимости в звездах Telegram. Вы можете создать счет двумя способами:
   1. Счет от бота: используйте sendInvoice, чтобы создать и отправить счет в чат. Не требуется provider_token, если это касается цифровых товаров. 
   2. Инлайн-счет: если @yourbotname поддерживает инлайн-режим, используйте inputInvoiceMessageContent, чтобы пользователи могли распространять ваши счета в своих чатах.
2. Выберите поведение при пересылке: то, как вы обрабатываете счета, которые пересылаются, зависит от параметра start_parameter в методе sendInvoice:
   1. Cчет для множества чатов: пересланные копии все равно могут быть оплачены.
   2. Счет для одного чата: оплата возможна только из оригинального чата, пересланные копии получают кнопку с URL-ссылкой, ведущей обратно к боту.

Включите или отключите функцию "Оплата из пересланных сообщений" при создании счетов с помощью @ShopBot, чтобы увидеть разницу.

3. Предварительная проверка: пользователь покупает звезды, если это необходимо, а затем нажимает кнопку «Оплатить». API бота отправляет вашему боту обновление pre_checkout_query. Ваш бот должен ответить с помощью answerPreCheckoutQuery в течение 10 секунд, иначе сделка будет отменена. Вы можете отправить сообщение об ошибке, если возникнут проблемы с оплатой.

4. Оформление заказа: если заказ и оплата прошли успешно, API отправляет сообщение successful_payment. Ваш бот должен затем предоставить пользователю то, что он купил.

Убедитесь, что вы получили апдейт successful_payment, прежде чем передавать товары — просто ответ на pre_checkout_query недостаточен для завершения сделки.

Если счет был в чате с @yourbotname, он отображается как квитанция для пользователя — он может в любое время проверить детали своей транзакции. Если счет был отправлен в другой чат, кнопка «Оплатить» остается активной, и решение о том, принимать ли дополнительные платежи, остается за ботом.

Контрольный лист

Прежде чем запустить своего торгового бота, убедитесь, что вы проверили следующее:

• Серьезно подумайте о включении двухфакторной аутентификации для аккаунта Telegram, на котором работает ваш бот.
• Помните, если что-то пойдет не так с транзакциями, ответственность лежит на вас. Будьте готовы решать любые споры или возвраты.
• Не допускайте путаницы. Настройте вашего бота так, чтобы он выдавал Условия и правила, когда кто-то вводит команду /terms или что-то подобное. Сделайте эти условия ясными и убедитесь, что пользователи их понимают — они должны согласиться с ними перед покупкой.
• Ваш бот должен иметь способ решения проблем клиентов. Настройте его так, чтобы пользователи могли использовать команду /support или другой очевидный способ получения помощи. Быстро реагируйте на их запросы и прямо сообщайте, что Telegram не будет разбираться с проблемами покупок через бота.
• Дважды проверьте оборудование и программное обеспечение вашего сервера. Используйте резервные копии, чтобы не потерять данные о платежах.
• Наконец, убедитесь, что вы прочитали и согласились с Условиями предоставления услуг Telegram и Условиями для разработчиков платформы ботов. Вам нужно соблюдать правила.

Вот и все, что касается Telegram. Теперь давайте поговорим о Directual!

Создание Telegram-ботов на Directual

Все просто!

Предположим, что у вас уже есть работающий Telegram-бот, вот как подключить его к Directual.

• Для начала перейдите в раздел «Плагины» в приложении Directual, выберите Telegram, введите тот самый секретный токен, который вы сохранили ранее, и установите плагин.
• Затем перейдите в раздел «База данных» и найдите папку Integrations/Telegram (она появится автоматически).
• Там вы увидите 5 структур данных: Входящие сообщения Telegram, Исходящие сообщения Telegram, Пользователи Telegram, Чаты Telegram и Клавиатуры Telegram (устаревшие).
• Вы также заметите, что вебхук для получения сообщений Telegram уже настроен, и создан новый системный сценарий под названием «Разбор входящих сообщений Telegram» (лучше его не трогать!).
• Теперь давайте протестируем эту интеграцию и заглянем в структуру TMessageIn. Отправьте текст, изображение, файл или свое местоположение боту и посмотрите, что попадет в TMessageIn.
• В структуре TMessageIn вы найдете новые записи, такие как поле «text» для текстовых сообщений (которое содержит содержание сообщения), а также элементы для изображений, файлов и местоположений, сохраненных в виде ID (идентификаторов) файлов Telegram.
• В заключение давайте создадим простой сценарий, который будет отслеживать появление новых объектов в TMessageIn. Создайте новый сценарий, добавьте в него шаг для Telegram, настройте параметры (и не забудьте опубликовать и запустить сценарий).

И на этом все! По крайней мере, что касается части с ботом.

Настройка процесса для работы со звездами Telegram

Шаг 1. Отправка счета

Используйте шаг Telegram в «Профессиональном режиме», вызовите метод sendInvoice, указав детали в теле: описание, заголовок, цены и валюту = XTR (код Telegram Stars).

Шаг 2. Обработка pre_checkout_query

Когда пользователь совершает оплату, Telegram отправляет специфический запрос с параметром pre_checkout_query. Нам нужно перехватить этот запрос и ответить, вызвав метод answerPreCheckoutQuery, чтобы одобрить транзакцию.

И это все! Любой желающий может создать нечто подобное на Directual. Более того, грядущее обновление плагина Telegram сделает этот процесс еще более простым.

Интеграция мини-приложений Telegram с Directual

Тут тоже все просто.

Шаг 1. Установите бесплатный плагин TMA из маркетплейса в вашем приложении на Directual 

Вот два способа, как вы можете настроить параметры плагина TMA:

Автоматический вход. Установите значение True: пользователи будут автоматически входить в систему при открытии TMA. Установите значение False: пользователи должны нажать «Войти с помощью Telegram», чтобы войти. Используйте False, если вы позволяете пользователям входить с помощью других методов, таких как «электронная почта» или «Google».

Отключение регистрации. Значение True означает, что пользователи не смогут войти в систему, если у них нет соответствующего WebUser ID. Значение False автоматически создаёт WebUser ID, когда кто-то входит в систему.

Если кто-то зарегистрирован в TMA и затем пытается войти через веб-браузер, ему понадобятся имя пользователя и пароль. Вы можете сгенерировать одноразовый пароль и отправить его через вашего Telegram-бота.

Шаг 2. Разверните ваше приложение на Directual в Telegram

Если у вас еще нет Telegram-бота, начните с BotFather, используя команду /newbot. Как только у вас будет бот, подключите к нему ваше приложение на базе Directual как веб-приложение с помощью команды /newapp. Просто следуйте указаниям BotFather.

Готово! При тестировании помните, что вход осуществляется автоматически, когда пользователь попадает на страницу входа.

Заключение

Хотите узнать больше о звездах Telegram, мини-приложениях, ботах и других новинках, которые уже интегрированы с Directual? Присоединяйтесь к нам — ссылки на наши сообщества ниже.

Успехов в разработке!