Skip to main content

Django app to write Telegram bots

Project description

CI: Requirements Status



Documentation Status

Django app to write Telegram bots. Just define commands and how to handle them.

NOTE: Just for text messages at this moment.


The full documentation is at

Telegram API documentation at


Install django-telegram-bot:

pip install django-telegram-bot

Add telegrambot and rest_framework to your INSTALLED_APPS, and run:

$ python migrate

After creating a bot in Telegram Platform set token received:

TELEGRAM_BOT_TOKEN = "token from your telegram bot"

Add webhook url to your urlpatterns:

url(r'^telegrambot/', include('telegrambot.urls', namespace="telegrambot")

Define whe file where commands will be defined in bothandlers variable, analogue to django urls and ROOT_URLCONF:


Set bot commands handlers is very easy just as defining urls in django. Module with bothandlers that list different handlers:

bothandlers = [command('start', StartView.as_command_view()),
           command('author', AuthorCommandView.as_command_view()),
           command('author_inverse', AuthorInverseListView.as_command_view()),
           command('author_query', AuthorCommandQueryView.as_command_view()),
           regex(r'author_(?P<name>\w+)', AuthorName.as_command_view()),

Use command set_webhook to specify the url to receive the incoming updates via webhook:

$ python set_webhook

To set the webhook for telegram you need django.contrib.sites installed, SITE_ID configured in settings and with it correct value in the DB.

Command views responses with Telegram messages to the user who send the command with a text message and keyboard. Compound with a context and a template. The way it is handled is analogue to Django views. Visits docs for more details


  • Commands handling definition.

  • Text responses and keyboards.

  • Media messages not supported.

  • Only Markup parse mode.

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install -r requirements/test.txt
(myenv) $ make test
(myenv) $ make test-all


0.1.0 (2016-21-01)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-telegram-bot-0.2.0.tar.gz (11.8 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page