Skip to content
Python client for the Telegram's tdlib
Branch: master
Clone or download
Pull request Compare This branch is 1 commit ahead, 19 commits behind alexander-akhmetov:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
examples
telegram
tests
.editorconfig
.gitignore
.travis.yml
Dockerfile
MANIFEST.in
Makefile
README.md
setup.cfg
setup.py
tox.ini

README.md

python-telegram

Build Status PyPI DockerHub Read the Docs (version)

Python API for the tdlib library. If helps you build your own Telegram clients.

Installation

This library works with Python 3.6+ only.

See documentation to install

Docker

This library has docker image:

docker run -i -t --rm \
            -v /tmp/docker-python-telegram/:/tmp/ \
            akhmetov/python-telegram \
            python3 /app/examples/send_message.py $(API_ID) $(API_HASH) $(PHONE) $(CHAT_ID) $(TEXT)

How to use

Check the tutorial :)

Basic example:

    from telegram.client import Telegram

    tg = Telegram(
        api_id='api_id',
        api_hash='api_hash',
        phone='+31611111111',
        database_encryption_key='changekey123',
    )
    tg.login()

    # if this is the first run, library needs to preload all chats
    # otherwise the message will not be sent
    result = tg.get_chats()
    result.wait()

    result = tg.send_message(
        chat_id=args.chat_id,
        text=args.text,
    )
    # `tdlib` is asynchronous, so `python-telegram` always returns you an `AsyncResult` object.
    # You can receive a result with the `wait` method of this object.
    result.wait()
    print(result.update)

More examples you can find in the /examples/ directory.


More information in the documentation.

You can’t perform that action at this time.