Рассказываем, как подключить платежную систему к Telegram-боту и разместить его на сервере.
Введение
Telegram-боты обладают широкой функциональностью и решают массу задач клиентов самых разных бизнесов. Рассказываем, как создать и разместить бота для приема платежей в Telegram на Python. Видеоверсия доступна по ссылке.
В Telegram есть встроенная система оплаты, поэтому сценариев, как использовать бота для приема платежей, достаточно много. Это может быть разовая оплата заказа или ежемесячная подписка.
Платежные системы Telegram
Сейчас мессенджер поддерживает оплату в более чем 200 странах через такие шлюзы, как: Stripe, YooMoney, Sberbank, LiqPay, PayMaster и другие.
Все начинается с установки библиотеки aiogram. Сейчас, пожалуй, это самая популярная библиотека для разработки ботов на Python.
python -m pip install aiogram
Переходим в Telegram и пишем тут BotFather’у команду /newbot. Вводим имя нового бота. Важно, чтобы оно заканчивалось словом Bot.
Получаем уникальный токен нового бота. Теперь напишем код простейшего эхо-бота, чтобы проверить его работу.
Связать бота с приложением
Создаем файл config.py и вписываем в него токен, который выдал BotFather. В основном файле main.py прописываем базовый код любого бота.
Обратите внимание на один важный момент: бот должен обрабатывать каждое сообщение с серверов Telegram. Для этого при запуске бота обязательно нужно поставить аргумент skip_updates в значение False. Это спасет от проблем при обработке платежей.
Теперь можно запустить код и проверить, работает ли бот. Убедившись, что все хорошо, приступаем к подключению платежей.
Возвращаемся к BotFather’у, даем команду /mybots и выбираем из списка своего бота.
В открывшемся меню кликаем на кнопку «Payments». Из предоставленного списка выбираем нужный платежный шлюз. В качестве теста используем PayMaster. Чтобы подключить оплату в Telegram-бота, сначала нужно выполнить тест, поэтому выбираем «PayMaster Test».
Следуем простым инструкциям бота платежной системы и получаем тестовый токен PayMaster. Его сразу же можно сохранить в config.py.
TOKEN = «5432877141:AAHEwBEb2mwnZX56oaHM10o33ZBZwVkvv-s» PAYMENTS_TOKEN = «1744374395:TEST:f14d9f0d42528b780370»
Возвращаемся к коду бота. Для того, чтобы запросить оплату товаров/услуг, нужно сгенерировать invoice с деталями платежа. Отправить его клиенту и обработать результат.
Подключаем оплату
Указываем список доступных цен на продукты. В качестве цены нужно передать целочисленное значение в минимально возможных единицах валюты. Если речь идет о рублях, то стоимость нужно указывать в копейках. То есть место 500 рублей мы тут укажем 500 * 100 или же 50 000 копеек. В случае с долларами будет почти также, $1=100 центов. Если предполагается работа с другими валютами, можно использовать currencies.json от Telegram API.
Дальше в коде бота платежной системы мы создаем обработчик команды /buy. Команда будет генерировать и отправлять пользователю invoice платежа. В примере используется оплата месячной подписки.
Сам процесс генерации invoice довольно простой. Не стоит беспокоиться большому количеству аргументов. Это названия продуктов или услуг, описания, цена, валюта и т.п.
Настройки платежей
Обратите внимание на аргумент is_flexible. Его нужно указывать в значение True только в том случае, если финальная стоимость зависит от выбранного способа доставки, если речь идет о продаже какого-то физического продукта.
О других параметрах метода send_invoice вы всегда можете прочитать в официальной документации Telegram API.
Теперь нужно создать еще два обработчика: Pre Checkout Query и Successful Payment.
Pre Checkout Query отвечает за обработку и утверждение платежа перед тем, как пользователь его совершит. Так можно проверить доступность товара на складе или уточнить стоимость.
Важно, что серверам Telegram ответ нужен в течение 10 секунд. Если его не будет, платеж не пройдет.
Successful Payment отвечает за обработку успешно проведенного платежа.
Тут можно выдать пользователю тот самый месяц подписки, за которую он заплатил или любую другую услугу.
Как бот работает на практике
Получив invoice на оплату от бота, нажимаем «Оплатить». Поскольку сначала мы проводим тестирование бота, воспользуемся специальной тестовой картой.
Вводим данные и оплачиваем подписку — все работает. При переходе на боевой проект важно не забыть выбрать правильный счет.
Теперь возвращаемся в BotFather, чтобы получить реальный токен от выбранного платежного шлюза. Если есть запрос на разные тарифы или способы оплаты, лучше запросить сразу 2-3 токена от разных платежных шлюзов. Далее нужно будет генерировать invoice с помощью токена выбранного провайдера.
Перенос бота на боевой сервер
Чтобы бот работал 24/7 вне зависимости от того, включен компьютер или нет, зальем его на реальный сервер.
Для этого воспользуемся облачным сервером линейки Shared Line от Selectel. Калькулятор панели управления позволяет выбрать гибкую конфигурацию сервера и сразу узнать, сколько будет стоить решение. Все продукты и услуги собраны у провайдера в одном месте, поэтому ими легко управлять. Арендовать сервер можно от 10 ₽/день, а в консоли есть возможность быстро масштабировать вычислительные ресурсы при необходимости.
Регистрируемся и входим в панель управления my.selectel.ru. Переходим в раздел «Облачная платформа» и выбираем «Серверы». Создаем сервер — после этого шага он загорится в списке как «ACTIVE».
Настраиваем конфигурацию. Для примера используем 1 ядро, 512 МБ DDR4 и 5 ГБ на диске.
Теперь переходим к выгрузке бота на боевой сервер. Сначала нужно подключиться к серверу через SSH. Для этого мы можем воспользоваться программой WinSCP для Windows. В Linux и MAC для этого есть свои встроенные инструменты.
Запускаем WinSCP. В качестве имени хоста указываем IP адрес нашего нового сервера. Логин и пароль можно взять во вкладке «Консоль» в панели управления.
Теперь перенесем сюда файлы нашего бота: config.py и main.py. Далее открываем отдельное соединение с сервером по SSH в консоли.
Для этого в WinSCP нажать кнопку и открыть PuTTY. Можно также воспользоваться командной строкой, принципиальной разницы нет.
Настройка бота с Payments 2.0
Подключившись к серверу, нужно выполнить ряд простых действий.
- Обновить Python до версии 3.10.
- Установить PIP.
- Поставить библиотеку Aiogram.
Если оставить все в таком виде, то при закрытии SSH-соединения вместе с ним закроется и процесс бота. Что делать?
Есть несколько способов, как решить этот вопрос. Рассмотрим самый простой – использование команды screen.
Пишем команду screen и жмем Enter. Запускаем бота из обычного терминала и закрываем соединение.
Бот продолжит работу. Чтобы в любой момент вернуться к этому экрану, достаточно ввести команду screen -r $screen_running. На этом деплой в облаке Selectel закончен.
Заключение
Описанная схема запуска Telegram-бота не предел того, как можно настроить прием платежей. К боту всегда можно добавить дополнительные возможности: запрашивать адрес доставки или менять цену в зависимости от адреса.
Идеальное решение для pet-проектов
Сервер для решения задач, которые не требуют полной загрузки vCPU.
Зарегистрируйтесь в панели управления
И уже через пару минут сможете арендовать сервер, развернуть базы данных или обеспечить быструю доставку контента.
Инструкция
Как автоматизировать подготовку к собеседованиям с помощью Telegram-бота
29 сентября 2023
Инструкция
Как реализовать очередь в Redis
14 сентября 2023
Инструкция
Как генерировать истории с помощью ChatGPT и Telegram
Источник: selectel.ru
Как добавить друга в Телеграмме и удалить контакты
Тelegram – это приложение для мгновенных сообщений, похожее на WhatsApp, но предлагающее и другие характеристики, такие как более высокое взаимодействие данных. При использовании любого мессенджера в френд-листе пользователя всегда найдутся абоненты, с которыми нет желания или необходимости общаться. Поэтому столь актуальным остается вопрос, как удалить контакт из Телеграмм либо только заблокировать. Но для начала стоит разобраться, как создать сам список абонентов в данной программе.
Как добавить или пригласить друзей?
Установив приложение, каждый пользователь начинает думать, как добавить контакт в Телеграмме. Сделать это можно несколькими простыми способами:
- из телефонной книги;
- из других мессенджеров;
- поиск по номеру телефона;
- найти по имени.
Из телефонной книги
Практически всех интересует, как добавить контакт в Telegram.
Приглашать и добавлять друзей в Телеграм достаточно просто, процедура очень похожа на WhatsApp. После того как вы закончили установку, вы увидите пустое изображение экрана. Преимущество в том, что в качестве имени пользователя вы можете использовать свои данные из мобильного девайса, не раскрывая номер телефона.
Если некоторые из ваших знакомых по телефону уже подписались на Телеграмм, вы увидите их имена и профиль картинки на экране. Если не отображен ни один пользователь, это значит, что ни один из ваших друзей пока не использует Telegram.
Из других мессенджеров
Если в вашей телефонной книге нет номеров всех друзей, им можно отправить приглашение в другие социальные сети или мессенджеры.
Чтобы добавить таким образом друга, необходимо:
- открыть меню «Настройки» – «Пригласить друзей»;
- программа выдаст список приложений, соцсетей (например, Вконтакте, Фейсбук) или просто возможность пригласить друзей, отправив им смс-сообщение.
Чтобы принять приглашение и получить возможность установить Telegram, люди должны перейти по ссылке, указанной в сообщении. После загрузки мессенджера вы увидите их в своей телефонной книге и сможете начать общение.
По номеру телефона
Предыдущие способы поиска друзей доступны для пользователей мобильных гаджетов. А есть ли возможность искать друзей, используя ПК? Человек может быть добавлен в список друзей на компьютере, если вы знаете номер его телефона.
При использовании такого варианта действия предельно просты. Выбрать в меню «Контакты» пункт «Новый». Программа предложит ввести номер телефона, после чего выдаст результаты поиска.
По имени
В данном случае имеется в виду поиск человека непосредственно в списке добавленных друзей либо френд-листе других мессенджеров, социальных сетей, которые пользователь использует для общения.
Функция глобального поиска пока разработчиками не предложена. Можно искать человека либо группу только по никнейму. Недостаток такого способа – без подтверждения с другой стороны пользователя в абонентскую книгу добавить нельзя.
Как удалить контакт?
Если заблокировать человека на Телеграмм, вы больше не будете получать сообщения от него. Но если вы удалите контакт, вы по-прежнему будете их получать, но вы не увидите контакт.
Разберем порядок действий для разных ОС.
Андроид
Для удаления контакта в Телеграмм и из списка контактов выполните следующие действия:
- Откройте приложение на вашем Android устройстве.
- Перейдите в список друзей и нажмите на имя того, кого вы хотели бы удалить.
- Теперь страница диалога открывается, и вам нужно нажать на имя контакта вверху.
- Страница информации о контакте должна быть открыта. И все, что вам нужно сделать, чтобы удалить этот контакт из списка, нажать на значок многоточия в правом верхнем углу. Откроется новый маленький экран, где вы будете иметь доступ к различным конфигурациям для этого контакта. Вы можете редактировать его контактную информацию, заблокировать или обмениваться информацией.
- Нажмите на последний вариант – опцию «Удалить». Приложение потребует подтверждения действий.
- Нажмите на кнопку OK.
iOS
Порядок действий следующий:
- Запустить приложение, зайти в чат с интересующим собеседником.
- В правом верхнем углу нажать на фото пользователя.
- Появится основная информация профиля. Нужно выбрать «редактировать/edit».
- Внизу открывшегося окна нажать на «удалить/delete». Функция будет выделена красным цветом.
- Программа предложит выбор: удалить контакт или отменить действие.
Удаленный пользователь потом может быть возвращен обратно. Если же такого друга возвращать вы не намерены и желаете стереть информацию безвозвратно, удалите его из телефонной книги в своем мобильном устройстве.
Как видите, работать с интерфейсом приложения предельно просто. Всего за несколько минут можно сформировать список контактов по собственному усмотрению.
Источник: www.allmessengers.ru
Избранное в Telegram: все способы его использовать
Избранное в Telegram — это особый чат, который виден только Вам. Отправлять в него сообщения и читать их тоже можете только Вы. Все это делает Избранное отличным местом для хранения важных заметок, ссылок и даже файлов. В этой статье мы расскажем о том, как использовать эту возможность на полную.
Где находится чат Избранное в Telegram?
Откройте мобильное приложение Telegram и проведите по экрану пальцем справа налево. Появится боковое меню, в котором между функцией «Люди рядом» и «Настройками» будет расположено «Избранное». На него Вам и нужно нажать.