Managing Telegram groups and channels through the API

import time
from socialift import Telegram

async def make_link(bot: Telegram, chat: str) -> str:
    link = await bot.create_invite_link(
        chat, name="September promo",
        expire_date=int(time.time()) + 7 * 86400,  # 7 days
        creates_join_request=True,                  # not combined with 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):  # your own check
        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:
    # Mute for 1 hour (supergroups only)
    await bot.restrict_member(chat_id, spammer_id, {"can_send_messages": False},
                              until_date=int(time.time()) + 3600)

    # Full ban: no until_date means forever
    await bot.ban_member(chat_id, spammer_id)

    # Moderator: a bot can only grant rights it holds itself
    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")

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 turns it off
        await tg.send_poll("@my_group", "Which day works for the webinar?",
                           ["Tuesday", "Thursday"])

        when = datetime.now(timezone.utc) + timedelta(hours=18)
        await tg.send_message("@my_channel", "Morning digest", schedule=when)
        queue = await tg.scheduled("@my_channel")

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  # channel too small or insufficient rights
    stats = await tg.stats(channel)
    return {
        "followers": stats.followers.current,
        "views_per_post": stats.views_per_post.current,
    }