StaticGramBot API

Юзерботы: Telethon и Pyrogram

Telethon и Pyrogram подключаются к StaticGram напрямую по MTProto, как к Telegram. Нужны только свои api_id и api_hash и пакет staticgram: он одной строкой направляет библиотеку на наш сервер.

Зачем пакет

При первом подключении клиент шифрует рукопожатие открытым RSA-ключом сервера, который зашит в библиотеку. В стоковых Telethon и Pyrogram зашиты только ключи Telegram, поэтому без пакета подключение падает с ошибкой auth_key generation failed, could not find a valid key for fingerprints или Public key not found. Пакет добавляет ключ StaticGram, адрес сервера и нужные исправления совместимости.

1. Получите api_id и api_hash

Зайдите на my.staticgram.top через аккаунт StaticGram и создайте приложение в разделе API apps.

2. Установите пакет

Shell
pip install https://docs.staticgram.top/assets/staticgram-0.1.1-py3-none-any.whl
pip install -U telethon      # или kurigram (импортируется как pyrogram)

У самого пакета нет зависимостей, он патчит уже установленные библиотеки.

3. Подключитесь

Telethon
import asyncio
import staticgram                      # одна строка: ключ и адрес StaticGram
from telethon import TelegramClient

API_ID, API_HASH = 12345, "0123456789abcdef0123456789abcdef"

client = TelegramClient("my", API_ID, API_HASH)   # или staticgram.telethon("my", API_ID, API_HASH)

async def main():
    await client.start()               # номер телефона и код из приложения StaticGram
    me = await client.get_me()
    print("Я:", me.first_name, me.id)
    await client.send_message("me", "Привет из Telethon!")

asyncio.run(main())
kurigram (Pyrogram)
import staticgram                      # до импорта pyrogram или после, без разницы
from pyrogram import Client

API_ID, API_HASH = 12345, "0123456789abcdef0123456789abcdef"

app = Client("my", api_id=API_ID, api_hash=API_HASH)   # или staticgram.pyrogram(...)

with app:
    me = app.get_me()
    print("Я:", me.first_name, me.id)
    app.send_message("me", "Привет из Pyrogram!")

Код входа приходит в приложение StaticGram, как в Telegram. Если включён облачный пароль, библиотека спросит и его.

Поддерживаемые версии

Сервер принимает API-слои 225–229. Библиотека должна быть собрана под один из них.

БиблиотекаВерсияСлойСтатус
telethon1.45 и новее229поддерживается
kurigram2.2.26 и новее229поддерживается
pyrogram2.0.106158не поддерживается: слишком старый слой
pyrofork2.3.69220не поддерживается: слишком старый слой

Со старой версией import staticgram выводит предупреждение, а сервер отклоняет подключение. Pyrogram больше не обновляется, вместо него используйте kurigram: это его продолжение с тем же API, импортируется как pyrogram.

Данные для ручной настройки

Если пакет не подходит, например для другого языка, настройте клиент сами.

Адрес185.246.223.47:2398, все DC (1–5) ведут на этот адрес
DC по умолчанию2
Отпечаток ключа-8831248865061910020
Шифрование p_q_inner_dataтолько RSA_PAD (как в современных клиентах Telegram), старая схема с SHA1 не принимается
Слои225–229
RSA public key
-----BEGIN RSA PUBLIC KEY-----
MIIBCgKCAQEApY+I2ck5p+YkPxKyuCRBMzIXGKQ7Kp9CB/kI+AYX4ahF3+qgR2K8
93THYmXIp46X17FdRceyNuIcNiGjezFPfO7yUZRpg2U/GWVSMptRB9O+h54AYUXq
AsUfTMqBRCWA0A5YJvq+HB3eTxGim2Pg4ct57Z9WBVNwRxqtRDgm61I5yiJMA60S
mOB/nFv0OWNuLtBFfq5KHL6oeEFpYZIfUjN1hdT4N0HWrApNxNQ8tazqGrhXokx9
v9DSD64y4T3u9KJZoHS6Moq6iCEZ6uze3U/rEN652MlK54D92Uontn9ckxXhhuBP
JUCDs9wCnraDFe1LTH4kNa+ckq4lpdlFqwIDAQAB
-----END RSA PUBLIC KEY-----

Частые ошибки

ОшибкаПричина
auth_key generation failed, could not find a valid key, Public key not foundне импортирован staticgram
INPUT_REQUEST_INVALID на первом запросе, таймаут подключениябиблиотека шлёт неподдерживаемый слой: обновите telethon или перейдите на kurigram

Описания методов и типов взяты из официальной документации Telegram Bot API (Bot API 10.3). Адрес API: https://api.staticgram.top