Django Telegram App

A Django app to integrate Telegram bots into your project.

---

---

Documentation: https://shifqu.github.io/django-telegram-app/

Source code: https://github.com/shifqu/django-telegram-app/

---

Features

• 🧩 Command-based bot architecture with step-based flow
• 🔄 Swappable TelegramSettings model
• ⚙️ Optional admin integration for Telegram settings
• 📦 Extensible: add bot-commands per app via auto-discovery
• 🛡️ Built-in system checks for misconfiguration
• 🗄️ Django ORM integration (no direct API handling required)
• 🧪 Easy to test (includes custom TelegramTestCase)

Requirements

• Python 3.10+
• Django 5.2+

Getting started

To set up your bot, follow the step-by-step guide in
➡️ Getting started

Support

See our issue tracker at: https://github.com/shifqu/django-telegram-app/issues

License

This project is licensed under the MIT License — see the LICENSE file for details.

About the Mascot

The project’s mascot is a robotic pigeon — inspired by the historical use of carrier pigeons to deliver messages reliably over long distances.
The robotic design reflects the robustness and sturdiness of the Django framework, while symbolizing automation and modern messaging flows.
Together, it represents a blend of tradition and technology: a dependable messenger for the world of Telegram bots.