Telegram: токен бота и api_id/api_hash для аккаунта

Бот или аккаунт: что выбрать?

Чем бот отличается от аккаунта

Как создать бота Telegram и получить токен

1. 1

   Отправьте /newbot в @BotFather

   Откройте @BotFather в Telegram и отправьте команду /newbot.

2. 2

   Выберите имя и username

   Имя отображается в контактных данных. Username — 5–32 символа: латинские буквы, цифры и подчёркивание, обязательно с окончанием bot (например, shop_support_bot).

3. 3

   Сохраните токен

   BotFather выдаст токен вида 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Любой, кто его знает, управляет ботом — храните токен в переменной окружения. Если он утёк, получите новый командой /token в BotFather.

4. 4

   Настройте privacy mode для групп

   По умолчанию бот в privacy mode: в группе он получает только адресованные ему команды, ответы на свои сообщения и служебные сообщения. Если нужно видеть всё — /setprivacy → Disable, затем удалите бота из группы и добавьте снова. Боты-администраторы получают все сообщения в любом случае.

5. 5

   Установите вебхук

   setWebhook требует HTTPS-адрес и порт 443, 80, 88 или 8443. Передайте secret_token (1–256 символов: A-Z, a-z, 0-9, _, -) — Telegram будет присылать его в заголовке X-Telegram-Bot-Api-Secret-Token. Пока вебхук установлен, getUpdates не работает; неполученные обновления хранятся не дольше 24 часов.

Как получить api_id и api_hash и войти в аккаунт

1. 1

   Зарегистрируйте аккаунт в официальном приложении

   Для получения api_id нужен аккаунт, зарегистрированный через официальное приложение Telegram.

2. 2

   Зарегистрируйте приложение на my.telegram.org

   Войдите на my.telegram.org по номеру телефона → API development tools → заполните форму. Пока к одному номеру можно привязать только один api_id.

3. 3

   Скопируйте api_id и api_hash

   api_id — число, api_hash — 32 шестнадцатеричных символа. Никому не показывайте api_hash: с ним можно входить от имени вашего приложения.

4. 4

   Войдите по телефону, коду и 2FA

   auth.sendCode отправляет код: чаще всего он приходит служебным сообщением в само приложение Telegram, но может прийти и по SMS, звонком или иначе. Код передаётся в auth.signIn вместе с phone_code_hash. Если включён двухэтапный пароль, вернётся SESSION_PASSWORD_NEEDED — дальше вход по паролю. Другие сеансы получат уведомление о новом входе.

5. 5

   Храните сессию в секрете

   Строка сессии после входа равноценна паролю: храните её в зашифрованном виде. С ней следующий запуск обходится без кода.

Как подключить Telegram в кабинете Socialift

1. 1

   Подключите бота

   В «Ulanishlar» (подключения) → «Telegram bot» вставьте токен и нажмите «Botni ulash» (подключить бота). Socialift сразу проверяет токен через getMe — невалидный не сохраняется. Если включён privacy mode, появится предупреждение. Один бот подключается только к одному пользователю Socialift. Для бота на странице «Kalitlar» ничего не нужно.

2. 2

   При необходимости направьте вебхук бота в Socialift

   Раздел Playground «Webhook va universal chaqiruv» (вебхук и универсальный вызов) устанавливает вебхук бота на сервер Socialift с отдельным secret_token для каждого бота. У бота один адрес вебхука: этот вызов заменит адрес, установленный вашим сервером (и наоборот).

3. 3

   Добавьте ключ для аккаунта

   В «Kalitlar» (ключи) → «Telegram API (my.telegram.org)» введите api_id и api_hash и нажмите «Saqlash va tekshirish» (сохранить и проверить). Socialift проверяет формат и пробует пару в Telegram через MTProto auth.exportLoginToken — телефон не запрашивается; при API_ID_INVALID ключ отклоняется. Без своего ключа используется ключ Socialift, если он настроен.

4. 4

   Подключите аккаунт

   «Ulanishlar» → «Telegram akkaunt»: номер телефона (+998901234567) → «Kod yuborish» (отправить код) → код (обычно приходит в приложение Telegram, а не по SMS) → «Tasdiqlash» (подтвердить) → при включённой 2FA пароль → «Kirish» (войти). Промежуточное состояние входа живёт около 10 минут.

5. 5

   Отключение

   Для аккаунта «Uzish» (отключить) завершает сеанс и на стороне Telegram — даже утёкшая копия сессии перестанет работать.

Бот: токен и вебхук в Python SDK

Telegram.from_env() читает TELEGRAM_BOT_TOKEN.

import asyncio
import os

from socialift import Telegram


async def main() -> None:
    # TELEGRAM_BOT_TOKEN, SOCIALIFT_LICENSE_KEY
    async with Telegram.from_env() as bot:
        me = await bot.get_me()  # самый дешёвый способ проверить токен
        print(me["username"], me.get("can_read_all_group_messages"))
        await bot.set_webhook(
            "https://example.com/tg",
            secret_token=os.environ["TG_WEBHOOK_SECRET"],
            allowed_updates=["message"],
        )


asyncio.run(main())

Аккаунт: api_id, api_hash и вход в Python SDK

Нужен pip install "socialift[telegram]". TelegramAccount.from_env() читает TELEGRAM_API_ID, TELEGRAM_API_HASH и TELEGRAM_SESSION.

import asyncio
import os
from getpass import getpass

from socialift import TelegramAccount


async def main() -> None:
    phone = "+998901234567"
    async with TelegramAccount(api_id=os.environ["TELEGRAM_API_ID"],
                               api_hash=os.environ["TELEGRAM_API_HASH"]) as tg:
        sent = await tg.send_code(phone)
        result = await tg.sign_in(phone, code=input("Код: "), phone_code_hash=sent["phone_code_hash"])
        if result.get("two_factor_required"):
            await tg.sign_in_password(getpass("Пароль 2FA: "))
        print(tg.export_session())  # равноценно паролю — храните зашифрованным


asyncio.run(main())

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

• ▸Токен бота остался в коде, репозитории или логах.
• ▸Бот не видит сообщения в группе — включён privacy mode или после /setprivacy бота не добавили в группу заново.
• ▸getUpdates вызывают при установленном вебхуке.
• ▸Вебхук без secret_token — любой, кто знает адрес, может прислать поддельное обновление.
• ▸Вебхук на неподдерживаемом порту или по HTTP.
• ▸Для одного бота вебхук ставят и на своём сервере, и в Socialift — побеждает последний setWebhook.
• ▸api_hash лежит в открытом доступе или строка сессии хранится незашифрованной.
• ▸Массовые рассылки или флуд с аккаунта — риск вечного бана.
• ▸Код ждут по SMS, а он пришёл в приложение Telegram.