Telegram Bot with Django Integration Web Hook 📢💻

For deployment i used both branches, single-run is easier to deploy, main is more reliable because bot and back-end could be run individually.(Deployed on Render.com)

A Python-based Telegram bot integrated with a Django backend, featuring webhook support with Uvicorn and serve as a digital store.
This code is base on telegram-store-bot but webhook version, the main functionalities didn't change.

Attention: Due to free deployment, server will spin down with inactivity, which can delay requests by 50 seconds or more.

---

Features 🛠️

• Webhook Integration: Efficient updates handling with Uvicorn. 🌐
• Multi-language Support: Easily customizable in bot_settings.py. 🌍
• User Management: Automatic account creation, balance display, and transaction history. 💳
• Payments: Generate payment links and update balances after successful payments. ✔️
• Products: Dynamic categories, product listings, and purchases via user balance. 🛒

---

Setup 🚀

1. Clone the Repository:

   git clone https://github.com/RezaTaheri01/telegram-store-bot-web-hook.git
   cd telegram-store-bot-web-hook/telegram_store

2. Install Dependencies:

   pip install -r req.txt

3. Configure the .env File:
   Create a .env file in the project root and populate it with the following sample values:

   TOKEN=your-telegram-api-token
   ADMIN_CHAT_ID=123456789
   SECRET_KEY=your-django-secret-key
   ENCRYPTION_KEYS=your-encryption-key
   DEBUG=True
   DEBUG_WEBHOOK=True
   ALLOWED_HOSTS=localhost,127.0.0.1,your-domain.com
   ALLOWED_HOSTS_WEBHOOK=localhost,127.0.0.1,your-domain.com
   WEBHOOK_URL=https://your-domain.com
   WEBHOOK_PORT=8000
   PAYMENT_DOMAIN=http://127.0.0.1:8001

   Note: Replace placeholder values with your actual credentials. If using localhost, use a tunneling tool (e.g., Ngrok or Cloudflare Tunnel) for WEBHOOK_URL and PAYMENT_DOMAIN.

4. Run Migrations:

   python manage.py makemigrations users payment products
   python manage.py migrate
   python manage.py createsuperuser

5. Start Servers:

   • Django Backend:

     python manage.py runserver 8001

   • Webhook (Uvicorn):

     python ./bot.py

---

Usage 💬

1. Start the bot and send /start.
2. Access features like My Account, Deposit, and Product Categories.
3. Use payment links to recharge and purchase products.

---

Notes 📝

• Ensure HTTPS support for webhooks and backend (use a tunneling tool for localhost).
• Update WEBHOOK_URL and PAYMENT_DOMAIN for production deployment.

---