{"id":13827560,"url":"https://github.com/YazdanRa/django-itelegram","last_synced_at":"2025-07-09T04:32:35.985Z","repository":{"id":57420511,"uuid":"305349944","full_name":"YazdanRa/django-itelegram","owner":"YazdanRa","description":"It's a library for building Telegram bot on Django with extra built-in features","archived":false,"fork":false,"pushed_at":"2020-12-16T22:19:53.000Z","size":248,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-30T11:57:15.424Z","etag":null,"topics":["bot","django","pypi","telegram"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/Django-iTelegram/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YazdanRa.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-19T10:41:45.000Z","updated_at":"2023-11-19T20:02:43.000Z","dependencies_parsed_at":"2022-09-16T09:02:35.194Z","dependency_job_id":null,"html_url":"https://github.com/YazdanRa/django-itelegram","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/YazdanRa/django-itelegram","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YazdanRa%2Fdjango-itelegram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YazdanRa%2Fdjango-itelegram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YazdanRa%2Fdjango-itelegram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YazdanRa%2Fdjango-itelegram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YazdanRa","download_url":"https://codeload.github.com/YazdanRa/django-itelegram/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YazdanRa%2Fdjango-itelegram/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262981587,"owners_count":23394558,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","django","pypi","telegram"],"created_at":"2024-08-04T09:02:01.722Z","updated_at":"2025-07-09T04:32:35.700Z","avatar_url":"https://github.com/YazdanRa.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":".. image:: https://github.com/YazdanRa/django-itelegram/blob/master/itelegram/static/img/iTelegram.png?raw=true\n\n.. image:: https://img.shields.io/pypi/pyversions/django-itelegram.svg\n   :target: https://pypi.python.org/pypi/django-itelegram/\n\n.. image:: https://img.shields.io/pypi/v/django-itelegram.svg\n   :target: https://pypi.python.org/pypi/django-itelegram/\n\n.. image:: https://img.shields.io/github/license/YazdanRa/django-itelegram.svg\n   :target: https://github.com/YazdanRa/django-itelegram/blob/master/LICENSE\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://github.com/psf/black\n\n-------\n\n\nDjango iTelegram\n=================\nIt's a library for building Telegram bot on Django with extra built-in options.\ncreated from `django-telegrambot`_ with a lot of extra features\n\n\nCompatibility\n=============\n- Python: **3.5**, **3.6**, **3.7**, **3.8**\n- Django: **3.0**, **3.1**, **3.2**\n\n\nInstallation\n============\nYou can install this package by the PyPI with the following command line:\n\n.. code-block:: sh\n\n    pip install django-itelegram\n\n\nConfiguration\n==============\nAdd ``itelegram`` and your bot app to ``INSTALLED_APPS``:\n\n.. code-block:: python\n\n    INSTALLED_APPS = [\n        # Other apps\n        \"itelegram\",\n        \"YOUR_BOT_APP\",\n    ]\n\nThen Add The ``DJANGO_TELEGRAMBOT`` to the settings just like the following structure:\n\n.. code-block:: python\n\n    DJANGO_TELEGRAMBOT = {\n        \"DISABLE_SETUP\": False,\n        #\n        # TODO: Explain more about this key\n\n        \"MODE\": \"POLLING\",  # (Optional [str])\n        #\n        # The default value is WEBHOOK, otherwise you may use \"POLLING\"\n        # NB: if use polling mode you must provide to run a management command that starts a worker\n\n        \"WEBHOOK_SITE\": \"https://mywebsite.com\",  # Required on WEBHOOK mode\n        #\n        # TODO: Explain more\n\n        \"WEBHOOK_PREFIX\": \"/prefix\",  # (Optional[str])\n        #\n        # If this value is specified, a prefix is added to webhook url\n        # \"WEBHOOK_CERTIFICATE\" : \"cert.pem\",\n        # If your site use self-signed certificate, must be set with location of your public key\n        # certificate.(More info at https://core.telegram.org/bots/self-signed )\n\n        \"STRICT_INIT\": True,  # Optional[bool]\n        #\n        # TODO: Explain more about this key\n\n        \"BOTS\": [\n            {\n                \"ID\": \"MyBot\",  # (Optional[str])\n                #\n                # You can use this ID to get your bot in all the installed apps\n\n                \"TOKEN\": \"1062412615:AAHLZ974OBY3goSSoX6HePTapjgdJMYFnEY\",  # (Required[str])\n                #\n                # Your bot token.\n                # you can get it from ( https://t.me/BotFather )\n\n                \"CONTEXT\": True,\n                #\n                # TODO: Explain more about this key\n\n                # \"ALLOWED_UPDATES\": [],  # (Optional[list[str]])\n                #\n                # List the types of updates you want your bot to receive.\n                # For example, specify ``[\"message\", \"edited_channel_post\", \"callback_query\"]``\n                # to only receive updates of these types.\n                # See ``telegram.Update`` for a complete list of available update types.\n                # Specify an empty list to receive all updates regardless of type (default).\n                # If not specified, the previous setting will be used.\n                # Please note that this parameter doesn't affect updates created before the call to the setWebhook,\n                # so unwanted updates may be received for a short period of time.\n\n                # \"TIMEOUT\": 60,  # (Optional[int|float])\n                #\n                # If this value is specified, use it as the read timeout from the server\n\n                # \"WEBHOOK_MAX_CONNECTIONS\": 40,  # (Optional[int])\n                #\n                # Maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100.\n                # Defaults to 40. Use lower values to limit the load on your bot's server,\n                # and higher values to increase your bot's throughput.\n\n                # \"POLL_INTERVAL\": 0.0,  # (Optional[float])\n                #\n                # Time to wait between polling updates from Telegram in seconds.\n                # Default is 0.0\n\n                # \"POLL_CLEAN\": False,  # (Optional[bool])\n                #\n                # Whether to clean any pending updates on Telegram servers before actually starting to poll.\n                # Default is False.\n\n                # \"POLL_BOOTSTRAP_RETRIES\": 0,  # (Optional[int])\n                #\n                # Whether the bootstrapping phase of the `Updater`\n                # will retry on failures on the Telegram server.\n                # |   \u003c 0 - retry indefinitely\n                # |     0 - no retries (default)\n                # |   \u003e 0 - retry up to X times\n\n                # \"POLL_READ_LATENCY\": 2,  # (Optional[float|int])\n                #\n                # Grace time in seconds for receiving the reply from server.\n                # Will be added to the `timeout` value and used as the read timeout from server.\n                # Default is 2\n\n                # \"PROXY\": {}, # (Optional[dict]),\n                #\n                # Use proxy to communicate with Telegram API server. Example:\n                #    {\n                #        \"proxy_url\": \"socks5://ip:port\",\n                #        \"urllib3_proxy_kwargs\": {\n                #             \"username\": \"username\",\n                #             \"password\": \"password\"\n                #        }\n                #    }\n                # Default is not to use any proxy.\n            },\n            # Other bots here with same structure.\n        ],\n    }\n\n\nAdd the following line to the url to configure the urls.\n\n.. code-block:: python\n\n    urlpatterns = [\n        # Other urls patterns\n        path(\"itelegram/\", include(\"itelegram.urls\")),\n    ]\n\n\nUsage\n=====\nTODO :D\n\n\nLicense\n=======\n`MIT`_\n\nNote\n====\n(1) This is a fork from `django-telegrambot`_!\n(2) Thanks to **Negar Nadian** for designing the Django iTelegram Logo.\n\n.. _`django-telegrambot`: https://pypi.org/project/django-telegrambot/\n.. _`MIT`: https://github.com/YazdanRa/django-itelegram/blob/master/LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FYazdanRa%2Fdjango-itelegram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FYazdanRa%2Fdjango-itelegram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FYazdanRa%2Fdjango-itelegram/lists"}