Обновления - это события, которые происходят в вашем аккаунте Telegram (входящие сообщения, присоединение новых участников, нажатие кнопки и т.д.), которые предназначены для уведомления о новом конкретном состоянии, которое изменилось. Эти обновления обрабатываются путем регистрации одной или нескольких функций обратного вызова в вашем приложении с помощью обработчиков.

Каждый обработчик имеет дело с определенным событием, и как только из Telegram поступит соответствующее обновление, фреймворк вызовет вашу зарегистрированную функцию обратного вызова и выполнит её код.

Регистрация обработчика

Чтобы объяснить, как работают обработчики, давайте рассмотрим тот, который будет отвечать за обработку обновлений сообщений, поступающих со всех ваших чатов. Любой другой тип обработчика использует ту же логику настройки, и у вас не должно возникнуть проблем с их настройкой, как только вы ознакомитесь с этим разделом.

Используя декораторы

Самый элегантный способ зарегистрировать обработчик сообщений - это использовать декоратор on_message():

from pyrogram import Client

app = Client("my_account")


@app.on_message()
async def my_handler(client, message):
    await message.forward("me")


app.run()

Определенная функция my_handler, которая принимает два аргумента (клиент и сообщение), будет функцией, которая выполняется каждый раз, когда поступает новое сообщение.

В последней строке мы снова видим метод run(), на этот раз используемый без каких-либо аргументов. Его цель здесь - просто автоматически запустить start(), поддерживать клиент в режиме онлайн, чтобы он мог прослушивать обновления, и остановить stop() его, как только вы нажмете CTRL + C.

Используя add_handler()

Метод add_handler() принимает любой экземпляр обработчика, который оборачивается вокруг вашей определенной функции обратного вызова, и регистрирует его в вашем клиенте. Это полезно в том случае, если вы хотите программно добавить обработчики.

from pyrogram import Client
from pyrogram.handlers import MessageHandler


async def my_function(client, message):
    await message.forward("me")


app = Client("my_account")

my_handler = MessageHandler(my_function)
app.add_handler(my_handler)

app.run()

Другими словами этот код создает клиент Pyrogram, добавляет обработчик сообщений, который пересылает все полученные сообщения на аккаунт, связанный с этим клиентом. Эхо-бот.

0. telegram bot on pyrogram #beginning

1. telegram bot on pyrogram #1

2. telegram bot on pyrogram #2

from pyrogram import Client

app = Client("my_account")


async def main():
    async with app:
        await app.send_message("me", "Hi!")


app.run(main())

Давайте начнем с импорта клиентского класса.

from pyrogram import Client

Теперь создайте экземпляр нового клиентского объекта, “my_account” - это имя сеанса по вашему выбору.

app = Client("my_account")

Асинхронные методы должны вызываться в асинхронном контексте. Здесь мы определяем асинхронную функцию и помещаем наш код внутрь. Также обратите внимание на ключевое слово await перед вызовом метода; это требуется для всех асинхронных методов.

app.run(main())

Контекстный менеджер

Оператор async with запускает контекстный менеджер, который используется в качестве ярлыка для запуска, выполнения и остановки клиента асинхронно. Он делает это путем автоматического вызова start() и stop() более удобным способом, который также изящно останавливает клиент, даже в случае необработанных исключений в вашем коде.

Ниже приведен тот же пример, что и выше, но без использования контекстного менеджера:

from pyrogram import Client

app = Client("my_account")


async def main():
    await app.start()
    await app.send_message("me", "Hi!")
    await app.stop()


app.run(main())

Используя asyncio.run()

В качестве альтернативы методу run() вы можете использовать asyncio.run() Python для выполнения функции main, с одним небольшим предостережением: экземпляр клиента (и, возможно, другие ресурсы asyncio, которые вы собираетесь использовать) должен быть создан внутри функции main.

import asyncio
from pyrogram import Client


async def main():
    app = Client("my_account")

    async with app:
        await app.send_message("me", "Hi!")


asyncio.run(main())

Не много не мало но у каждого кто интересуется созданием бота для Телеграмм наступает момент поиска нужной информации, урока, мануала и ещё чего бы то не было, чтобы самостоятельно написать годный, рабочий, возможно интересный и в то же время простой бот. Но я сейчас не о функциональности, а больше о возможностях.

Задумал я значит изучить сие творение, то есть создание бота на библиотеке, а как её создатели называют Telegram MTProto API Framework for Python (API-фреймворк Telegram MTProto для Python) Pyrogram

Pyrogram — это современный, элегантный и асинхронный фреймворк MTProto API. Это позволяет вам легко взаимодействовать с основным Telegram API через учетную запись пользователя (пользовательский клиент) или идентификатор бота (альтернатива bot API) с использованием Python.

В целом и документацию можно почитать, но коли ты не обладаешь нужными знаниями чтобы бегло читать английский и так же бегло понимать его, то этот ликбез для тебя.

Приступаем к гимнастике:

Прежде всего, как и во всём Python нам нужно создать виртуальное окружение:

python -m venv venv

или

python3 -m venv venv

смотря какая у тебя операционная система, нужным способом активируем виртуальное окружение.

source venv/bin/activate

или

source venv/Script/activate

Дальше, установим библиотеку pyrogram:

pip install -U pyrogram

Далее получаем на сайте Телеграмма https://core.telegram.org/api/obtaining_api_id ключ API, он состоит из двух частей: api_id и api_hash. Держи их в секрете.

Далее, настраиваем проект:

from pyrogram import Client

api_id = 12345
api_hash = "0123456789abcdef0123456789abcdef"

app = Client("my_account", api_id=api_id, api_hash=api_hash)

app.run()

Запускаем нашего, маленького, бота. В терминале запустится интерактивная среда регистрации, которой требуется передать номер телефона, без + и -. Ответ придёт на авторизированный клиент, либо по смс.

Enter phone number: +1-123-456-7890
Is "+1-123-456-7890" correct? (y/n): y
Enter phone code: 12345
Logged in successfully

После успешной авторизации будет создан новый файл с именем my_account.session, позволяющий Pyrogram выполнять вызовы API с вашим идентификатором. Этот файл является личным и будет загружен снова, когда вы перезапустите свое приложение. Теперь вы можете удалить значения api_id и api_hash из кода, поскольку они больше не нужны.

Бот - это особый вид пользователей, которые авторизуются с помощью своих токенов (вместо телефонных номеров), созданных Bot Father. Токены ботов заменяют только телефонные номера пользователей — вам все равно нужно настроить ключ API Telegram с помощью Pyrogram, даже для использовании ботов.

Процесс авторизации управляется автоматически. Все, что вам нужно сделать, это выбрать имя (оно может быть любым, обычно это имя пользователя вашего бота) и передать свой токен бота, используя параметр bot_token. Файл сеанса будет назван в честь имени сеанса, которое в приведенном ниже примере будет my_bot.session.

from pyrogram import Client

api_id = 12345
api_hash = "0123456789abcdef0123456789abcdef"
bot_token = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"

app = Client(
    "my_bot",
    api_id=api_id, api_hash=api_hash,
    bot_token=bot_token
)

app.run()

from pyrogram import Client

app = Client("my_account")
app.run()