TelegramGiftsBot — Automated Gift Purchase Bot for Telegram

[HypeKIK]

TelegramGiftsBot — Automated Gift Purchase Bot for Telegram
No fees. Fully open source.


A powerful Telegram bot designed to automate the purchase of gifts from a marketplace. It supports both bot-mode and userbot-mode (via your own Telegram session). Offers full automation with customizable profiles and built-in purchase logic.


Key Features

• 
  [] Purchase gifts based on filters: minimum/maximum price, stock, and number of purchases.
  [] Works both as a bot and as a userbot — connect your own Telegram session to buy gifts directly.
  [] SOCKS5 proxy support for userbot and aiohttp session.
  [] Parallel checking from two sources (bot + userbot) to find the best available gift.
  [] Up to 3 independent profiles with separate recipients and limits.
  [] Notifications for successful purchases and completed tasks.
  [] Fully interactive control panel inside Telegram.
  [] Purchase counter with automatic stop when limit is reached.
  [] Balance top-up and refund via Telegram Stars.
  [] Balance top-up from any account.
  [] Test the bot with a 15-star gift purchase.
  [] Access the full catalog and buy specific gifts in custom quantities.
• One-command refund of all stars from the bot.

Quick Start

1. Clone the repository:

git clone https://github.com/leozizu/TelegramGiftsBot.git

1. Install the dependencies:

pip install -r requirements.txt

1. Create the .env file in the project root:
   This file stores environment variables.

Example:



TELEGRAM_BOT_TOKEN="123456:abcdefghijklmnopqrstuvwxyz"
TELEGRAM_USER_ID="123456789"

• TELEGRAM_BOT_TOKEN: Your bot token from BotFather
• TELEGRAM_USER_ID: Your Telegram user ID (get it via @userinfobot)

1. Run the bot:

python main.py


Project Structure

• 
  [] main.py — main entry point
  [] requirements.txt — project dependencies
  [] .env — environment variables (not committed)
  [] config.json — user config (not committed)
  [] handlers/ — update handlers (e.g., handlers_main.py, handlers_wizard.py)
  [] middlewares/ — access control and update filtering
  [] services/ — business logic (balance.py, buy.py, config.py, menu.py, etc.)
  [] utils/ — helpers (logging.py, misc.py, mockdata.py, proxy.py)

For Developers

• 
  [] All handlers are in handlers/. Add your own flows by creating new files.
  [] Core logic is in services/ for easy testing and reuse.
  [] Utilities live in utils/ — safe to extend without breaking core logic.
  [] Middlewares are in middlewares/ for custom access control and logging.

 

[lip12001]

ty

 

[perc550]

best

 

[homerfeicek]

q

 

[Bandja8]

+

 

[Phylexdev]

TelegramGiftsBot — Telegram için Otomatik Hediye Satın Alma Botu
Hiçbir ücret yok. Tamamen açık kaynaklı.


Bir pazaryerinden hediye alımını otomatikleştirmek için tasarlanmış güçlü bir Telegram botu. Hem bot modunu hem de kullanıcı bot modunu (kendi Telegram oturumunuz üzerinden) destekler. Özelleştirilebilir profiller ve yerleşik satın alma mantığıyla tam otomasyon sunar.


Temel Özellikler

• 
  [ ] Hediyeleri filtrelere göre satın alın: minimum/maksimum fiyat, stok ve satın alma sayısı.
  [ ] Hem bot hem de kullanıcı botu olarak çalışır — hediyeleri doğrudan satın almak için kendi Telegram oturumunuzu bağlayın.
  [ ] Kullanıcı botu ve aiohttp oturumu için SOCKS5 proxy desteği.
  [ ] En iyi mevcut hediyeyi bulmak için iki kaynaktan (bot + kullanıcı botu) paralel kontrol.
  [ ] Ayrı alıcılar ve limitlerle 3'e kadar bağımsız profil.
  [ ] Başarılı satın alımlar ve tamamlanan görevler için bildirimler.
  [ ] Telegram içinde tamamen etkileşimli kontrol paneli.
  [ ] Limite ulaşıldığında otomatik durdurma özelliği olan satın alma sayacı.
  [ ] Telegram Yıldızları ile bakiye yükleme ve iade.
  [ ] Herhangi bir hesaptan bakiye yükleme.
  [ ] Botu 15 yıldızlı hediye satın alımıyla test edin.
  [ ] Tüm kataloğa erişin ve belirli hediyeleri özel miktarlarda satın alın.
• Bottan gelen tüm yıldızların tek komutla iadesi.

Hızlı Başlangıç

1. Depoyu klonlayın:

git clone https://github.com/leozizu/TelegramGiftsBot.git

1. Bağımlılıkları yükleyin:

pip install -r requirements.txt

1. Proje kökünde .env dosyasını oluşturun:
   Bu dosya ortam değişkenlerini depolar.

Örnek:



TELEGRAM_BOT_TOKEN="123456:abcdefghijklmnopqrstuvwxyz"
TELEGRAM_USER_ID="123456789"

• TELEGRAM_BOT_TOKEN: BotFather'dan aldığınız bot token'ınız
• TELEGRAM_USER_ID: Telegram kullanıcı kimliğiniz (@userinfobot aracılığıyla edinin)

1. Botu çalıştırın:

python ana.py


Proje Yapısı

• 
  [ ] main.py — ana giriş noktası
  [ ] requirements.txt — proje bağımlılıkları
  [ ] .env — ortam değişkenleri (işlenmemiş)
  [ ] config.json — kullanıcı yapılandırması (işlenmemiş)
  [ ] handlers/ — işleyicileri güncelle (örneğin, handlers_main.py, handlers_wizard.py)
  [ ] middlewares/ — erişim denetimi ve güncelleme filtrelemesi
  [ ] services/ — iş mantığı (balance.py, buy.py, config.py, menu.py, vb.)
  [ ] utils/ — yardımcılar (logging.py, misc.py, mockdata.py, proxy.py)

Geliştiriciler İçin

• 
  [ ] Tüm işleyiciler handlers/ dizinindedir. Yeni dosyalar oluşturarak kendi akışlarınızı ekleyin.
  [ ] Kolay test ve yeniden kullanım için temel mantık services/ dizinindedir.
  [ ] Yardımcı programlar utils/ dizinindedir; temel mantığı bozmadan genişletmek güvenlidir.
  [ ] Özel erişim denetimi ve günlük kaydı için ara yazılımlar middlewares/ dizinindedir.

*** Gizli metin: alıntı yapılamaz. ***

Look

 

[Jynxzi]

thx

 

[retrohaxxx %]

123

 

[rarehunter]

respect

 

[ddedde]

qwe

 

[BADBTCH]

thanks

 

[yuuzab]

123

 

[aappeenn123]

+

 

[healthcare]

sup

 

[Armatolos]

++

 

[aayushop]

good

 

[crtona]

ty

 

[Alain7x]

ty

 

[Karos ©]

best

 

[wajrjraw3]

123