Skip to main content

This library is built for the Heroku userbot and is based on Telethon.

Project description

Herokutl

⭐️ Thanks everyone who has starred the project, it means a lot!

logo Telethon is an asyncio Python 3 MTProto library to interact with Telegram's API as a user or through a bot account (bot API alternative).

Important: If you have code using Telethon before its 1.0 version, you must read Compatibility and Convenience to learn how to migrate. As with any third-party library for Telegram, be careful not to break Telegram's ToS or Telegram can ban the account.

What is this?

Telegram is a popular messaging application. This library is meant to make it easy for you to write Python programs that can interact with Telegram. Think of it as a wrapper that has already done the heavy job for you, so you can focus on developing an application.

Installing

pip3 install heroku-tl-new

Creating a client

from herokutl import TelegramClient, events, sync

# These example values won't work. You must get your own api_id and
# api_hash from https://my.telegram.org, under API Development.
api_id = 12345
api_hash = '0123456789abcdef0123456789abcdef'

client = TelegramClient('session_name', api_id, api_hash)
client.start()

Doing stuff

print(client.get_me().stringify())

client.send_message('username', 'Hello! Talking to you from Telethon')
client.send_file('username', '/home/myself/Pictures/holidays.jpg')

client.download_profile_photo('me')
messages = client.get_messages('username')
messages[0].download_media()

@client.on(events.NewMessage(pattern='(?i)hi|hello'))
async def handler(event):
    await event.respond('Hey!')

Next steps

Do you like how Telethon looks? Check out Read The Docs for a more in-depth explanation, with examples, troubleshooting issues, and more useful information.

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

heroku_tl_new-1.0.3.1.tar.gz (652.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

heroku_tl_new-1.0.3.1-py3-none-any.whl (727.0 kB view details)

Uploaded Python 3

File details

Details for the file heroku_tl_new-1.0.3.1.tar.gz.

File metadata

  • Download URL: heroku_tl_new-1.0.3.1.tar.gz
  • Upload date:
  • Size: 652.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for heroku_tl_new-1.0.3.1.tar.gz
Algorithm Hash digest
SHA256 ff4b2f3223ca7a4f4709352833eb414f18de6530f4ab0748b1bbe6ab7d35d614
MD5 5ba4277cffb93bfcd13ec53334ec43b8
BLAKE2b-256 21bfc039542b6a4472271295e6b6aa7844071420035a9af80dbdfa67fa25da4f

See more details on using hashes here.

File details

Details for the file heroku_tl_new-1.0.3.1-py3-none-any.whl.

File metadata

  • Download URL: heroku_tl_new-1.0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 727.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for heroku_tl_new-1.0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 438537d16fde44df93e1f4cb7aa2d605708f5797b433a2b2b1c89317db5d80e5
MD5 0cbcee77b7f0e22ccda592daae7c92c0
BLAKE2b-256 3333a43d50621fbc5e9029abd3e49c0ad1420b2d94c0b7ca06d38f01c7eda2c9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page