Управление группами и каналами Telegram через API

Коротко: что и чем делается

Методы под задачи: бот и аккаунт

Названия методов в SDK Socialift: слева Telegram (Bot API), справа TelegramAccount (MTProto).

Закрытая группа с заявками: настройка через бота

1. 1

   Сделайте бота администратором

   Дайте боту как минимум право приглашать пользователей (can_invite_users) — без него бот не видит заявки и не может их одобрять.

2. 2

   Создайте ссылку с заявками

   create_invite_link(..., creates_join_request=True). В этом режиме нельзя задать member_limit — выберите что-то одно. Для срока действия добавьте expire_date (unix-время).

3. 3

   Принимайте обновления

   Бот получает update chat_join_request. Если вы вручную ограничивали allowed_updates, добавьте туда chat_join_request.

4. 4

   Проверьте заявку

   Через user_chat_id из update бот может писать пользователю 5 минут, пока заявка не обработана, — например, чтобы задать короткий вопрос. Сверьтесь с CRM или базой оплат.

5. 5

   Примите решение

   Вызовите approve_join_request или decline_join_request. Ненужную ссылку отзовите через revoke_invite_link.

Бот: срочная ссылка и одобрение заявок

import time
from socialift import Telegram

async def make_link(bot: Telegram, chat: str) -> str:
    link = await bot.create_invite_link(
        chat, name="Акция сентября",
        expire_date=int(time.time()) + 7 * 86400,  # 7 дней
        creates_join_request=True,                  # не вместе с member_limit
    )
    return link["invite_link"]

async def on_update(bot: Telegram, update: dict) -> None:
    req = update.get("chat_join_request")
    if not req:
        return
    chat_id, user_id = req["chat"]["id"], req["from"]["id"]
    if await is_paid_customer(user_id):  # ваша проверка
        await bot.approve_join_request(chat_id, user_id)
    else:
        await bot.decline_join_request(chat_id, user_id)

Бот: ограничение, бан и назначение модератора

import time

async def moderate(bot, chat_id: int, spammer_id: int, moderator_id: int) -> None:
    # Запрет писать на 1 час (только в супергруппах)
    await bot.restrict_member(chat_id, spammer_id, {"can_send_messages": False},
                              until_date=int(time.time()) + 3600)

    # Полный бан: без until_date — навсегда
    await bot.ban_member(chat_id, spammer_id)

    # Модератор: бот может выдать только те права, что есть у него самого
    await bot.promote_member(chat_id, moderator_id, can_delete_messages=True,
                             can_restrict_members=True, can_pin_messages=True)
    await bot.set_admin_title(chat_id, moderator_id, "Модератор")

Аккаунт: медленный режим, опрос и отложенный пост

Для этих действий аккаунт должен быть администратором группы или канала с нужными правами.

from datetime import datetime, timedelta, timezone
from socialift import TelegramAccount

async def weekly_setup() -> None:
    async with TelegramAccount.from_env() as tg:
        await tg.set_slowmode("@my_group", 30)  # 0 — выключить
        await tg.send_poll("@my_group", "В какой день провести вебинар?",
                           ["Вторник", "Четверг"])

        when = datetime.now(timezone.utc) + timedelta(hours=18)
        await tg.send_message("@my_channel", "Утренний дайджест", schedule=when)
        queue = await tg.scheduled("@my_channel")

Список участников: что можно, а что нет

Статистика канала

Подробную статистику Telegram показывает только админам каналов от определённого размера. Точный порог — серверная настройка, поэтому не зашивайте число в код, а проверяйте флаг can_view_stats.

async def channel_report(tg, channel: str) -> dict | None:
    full = await tg.chat_full(channel)
    if not full.full_chat.can_view_stats:
        return None  # канал пока мал или не хватает прав
    stats = await tg.stats(channel)
    return {
        "followers": stats.followers.current,
        "views_per_post": stats.views_per_post.current,
    }

Этика и антиспам-правила Telegram

API групп и каналов — для работы с аудиторией, а не для спама. Нарушения могут стоить аккаунта навсегда.

• ▸Не добавляйте незнакомых людей в группу массово. Если пользователь запретил это в настройках приватности, Telegram вернёт USER_PRIVACY_RESTRICTED — отправляйте инвайт-ссылку только тем, кто сам попросил.
• ▸Не пишите и не приглашайте людей из купленных или спарсенных в других группах баз.
• ▸Не накручивайте подписчиков и просмотры: за такое использование API Telegram банит навсегда.
• ▸Не автоматизируйте действия, о которых владелец аккаунта не знает и на которые не соглашался, — это нарушает API Terms of Service.
• ▸Соблюдайте лимиты: бот может отправлять в группу не больше 20 сообщений в минуту, а на аккаунте выжидайте время из FLOOD_WAIT.
• ▸Вместо открытого входа используйте ссылки с заявками — они отсекают и спам-ботов, и случайных людей.