Юзерботы: 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. Установите пакет
pip install https://docs.staticgram.top/assets/staticgram-0.1.1-py3-none-any.whl
pip install -U telethon # или kurigram (импортируется как pyrogram)У самого пакета нет зависимостей, он патчит уже установленные библиотеки.
3. Подключитесь
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())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. Библиотека должна быть собрана под один из них.
| Библиотека | Версия | Слой | Статус |
|---|---|---|---|
| telethon | 1.45 и новее | 229 | поддерживается |
| kurigram | 2.2.26 и новее | 229 | поддерживается |
| pyrogram | 2.0.106 | 158 | не поддерживается: слишком старый слой |
| pyrofork | 2.3.69 | 220 | не поддерживается: слишком старый слой |
Со старой версией 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 |
-----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 |