Telegram guruh va kanalini API orqali boshqarish

Qisqacha: nimani nima bilan qilish mumkin

Vazifa bo'yicha metodlar: bot va akkaunt

Socialift SDK'dagi metod nomlari: chapda Telegram (Bot API), o'ngda TelegramAccount (MTProto).

Qo'shilish so'rovi bilan yopiq guruh: bot orqali sozlash

1. 1

   Botni admin qiling

   Botga kamida «foydalanuvchilarni taklif qilish» (can_invite_users) huquqini bering — busiz bot so'rovlarni ko'rmaydi va tasdiqlay olmaydi.

2. 2

   So'rovli havola yarating

   create_invite_link(..., creates_join_request=True). Bu rejimda member_limit berib bo'lmaydi — ikkisidan birini tanlang. Muddat uchun expire_date (unix vaqt) qo'shing.

3. 3

   Update'larni qabul qiling

   Bot chat_join_request update'ini oladi. allowed_updates ro'yxatini qo'lda cheklagan bo'lsangiz, unga chat_join_request'ni qo'shing.

4. 4

   Arizani tekshiring

   Update ichidagi user_chat_id orqali bot so'rov ko'rib chiqilguncha 5 daqiqa davomida foydalanuvchiga yoza oladi — masalan, qisqa savol berish uchun. CRM yoki to'lov bazangiz bilan solishtiring.

5. 5

   Qaror qabul qiling

   approve_join_request yoki decline_join_request chaqiring. Keraksiz bo'lib qolgan havolani revoke_invite_link bilan bekor qiling.

Bot: muddatli havola va so'rovlarni tasdiqlash

import time
from socialift import Telegram

async def make_link(bot: Telegram, chat: str) -> str:
    link = await bot.create_invite_link(
        chat, name="Sentabr aksiyasi",
        expire_date=int(time.time()) + 7 * 86400,  # 7 kun
        creates_join_request=True,                  # member_limit bilan birga emas
    )
    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):  # sizning tekshiruvingiz
        await bot.approve_join_request(chat_id, user_id)
    else:
        await bot.decline_join_request(chat_id, user_id)

Bot: cheklash, ban va moderator tayinlash

import time

async def moderate(bot, chat_id: int, spammer_id: int, moderator_id: int) -> None:
    # 1 soatga yozishni taqiqlash (faqat supergroup'da)
    await bot.restrict_member(chat_id, spammer_id, {"can_send_messages": False},
                              until_date=int(time.time()) + 3600)

    # Butunlay ban: until_date berilmasa — abadiy
    await bot.ban_member(chat_id, spammer_id)

    # Moderator: bot faqat o'zida bor huquqlarni bera oladi
    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, "Moderator")

Akkaunt: slow mode, so'rovnoma va rejalashtirilgan post

Bu amallar uchun akkaunt guruh yoki kanalda tegishli huquqli admin bo'lishi kerak.

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("@mening_guruhim", 30)  # 0 — o'chirish
        await tg.send_poll("@mening_guruhim", "Vebinar qaysi kuni bo'lsin?",
                           ["Seshanba", "Payshanba"])

        when = datetime.now(timezone.utc) + timedelta(hours=18)
        await tg.send_message("@mening_kanalim", "Ertalabki dayjest", schedule=when)
        queue = await tg.scheduled("@mening_kanalim")

A'zolar ro'yxati: nima mumkin, nima mumkin emas

Kanal statistikasi

Telegram batafsil statistikani faqat ma'lum hajmdan katta kanal adminlariga beradi. Aniq chegara server sozlamasi — raqamni kodga yozmang, can_view_stats bayrog'ini tekshiring.

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  # kanal hali kichik yoki huquq yetarli emas
    stats = await tg.stats(channel)
    return {
        "followers": stats.followers.current,
        "views_per_post": stats.views_per_post.current,
    }

Etika va Telegram anti-spam qoidalari

Guruh va kanal API'si auditoriya bilan ishlash uchun, spam uchun emas. Qoidabuzarlik akkauntni abadiy yo'qotishga olib kelishi mumkin.

• ▸Notanish odamlarni guruhga ommaviy qo'shmang. Foydalanuvchi maxfiylik sozlamasida taqiqlagan bo'lsa Telegram USER_PRIVACY_RESTRICTED qaytaradi — taklif havolasini faqat so'raganlarga yuboring.
• ▸Sotib olingan yoki boshqa guruhlardan yig'ilgan a'zolar ro'yxatiga xabar yubormang va ularni taklif qilmang.
• ▸Obunachilar yoki ko'rishlarni soxtalashtirmang: Telegram bunday foydalanish uchun abadiy ban beradi.
• ▸Akkaunt egasi bilmagan va rozi bo'lmagan amalni avtomatlashtirmang — bu API Terms of Service'ga zid.
• ▸Limitlarga rioya qiling: bot guruhga daqiqasiga 20 tadan ko'p xabar yubora olmaydi, akkauntda FLOOD_WAIT ko'rsatgan vaqtni kuting.
• ▸Ochiq qo'shilish o'rniga so'rovli havoladan foydalaning — bu spam botlarni ham, tasodifiy odamlarni ham filtrlaydi.